Skip to content

vmware-tanzu/apps-cli-plugin

Apps Plugin for the Tanzu CLI


VMware has migrated active development on this project to a private repository.
This repository will no longer be updated.



CI GoDoc Go Report Card codecov

Apps plugin for Tanzu CLI provides the ability to create, view, update, and delete application workloads on any Kubernetes cluster that has Cartographer installed. It also provides commands to list and view ClusterSupplychain resources.

About Workloads and ClusterSupplychain

With a ClusterSupplyChain, app operators describe which “shape of applications” they deal with (via spec.selector), and what series of resources are responsible for creating an artifact that delivers it (via spec.resources).

Workload allows the developer to pass information about the app to be delivered through the supply chain.

For further information about Cartographer resources, read the official docs

Getting Started

Prerequisites

Tanzu CLI is required to use the Apps CLI plugin.

From a pre-built distribution

Download the tanzu-apps-plugin-<OS>-amd64-${VERSION}.tar.gz from the most recent release listed on the Apps Plugin for the Tanzu CLI releases page.

macOS

Download binary executable(tanzu-apps-plugin-darwin-amd64-${VERSION}.tar.gz) for CLI apps plugin. Following are the instructions for installing plugin version v0.7.0.

VERSION=v0.7.0
tar -xvf tanzu-apps-plugin-darwin-amd64-${VERSION}.tar.gz
tanzu plugin install apps --local ./tanzu-apps-plugin-darwin-amd64-${VERSION} --version ${VERSION}

Linux

Download binary executable(tanzu-apps-plugin-linux-amd64-${VERSION}.tar.gz) for CLI apps plugin. Following are the instructions for installing plugin version v0.7.0.

VERSION=v0.7.0
tar -xvf tanzu-apps-plugin-linux-amd64-${VERSION}.tar.gz
tanzu plugin install apps --local ./tanzu-apps-plugin-linux-amd64-${VERSION} --version ${VERSION}

Windows

Download binary executable(tanzu-apps-plugin-windows-amd64-${VERSION}.tar.gz) for CLI apps plugin. Unzip the file tanzu-apps-plugin-windows-amd64-${VERSION}.tar.gz. Following are the instructions for installing plugin version v0.7.0

tanzu plugin install apps --local . --version v0.7.0

NOTE: --local should point to the directory which has discovery and distribution folder in it after unzipping.

Build from CI artifact

If you're looking for the latest dev build, you may be able to find the artifact from a recent CI build. Follow Github documentation to locate and download the artifact for certain build.

Build from source

See the development guide for instructions to build from source.

Documentation

Detailed documentation for commands in Apps Plugin for the Tanzu CLI can be found in the docs folder of this repository. Documentation provides usage guide, information about working with workloads, and the full command reference.

Community and Support

Join us!

If you have questions or want to get the latest project news, you can connect with us in the following ways:

  • Checkout our github issue/ PR section

Contributing

Pull Requests and feedback on issues are very welcome! See the issue tracker if you're unsure where to start, especially the Good first issue label, and also feel free to reach out to discuss.

If you are ready to jump in and test, add code, or help with documentation, please follow the instructions on our Contribution Guidelines to get started and - at all times- follow our Code of Conduct

License

Apache 2.0. Refer to LICENSE for details.