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.

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

Tanzu CLI is required to use the Apps CLI plugin.

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.

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}

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}

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.

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.

See the development guide for instructions to build from source.

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.

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

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

Apache 2.0. Refer to LICENSE for details.