VMware Tanzu Application Catalog is a customizable selection of open source software from the Bitnami collection that is continuously maintained and verifiably tested for use in production environments. Tanzu Application Catalog gives developers the productivity and agility of pre-packaged apps and components, while enabling operators to meet the stringent security and transparency requirements of enterprise IT.
Tanzu Application Catalog for Tanzu Advanced enables organizations to simplify delivery and deployment of custom applications on Kubernetes. Tanzu Application Catalog for Tanzu Advanced provides a catalog based on one hardened base image (Ubuntu 18.04) to all customers. All containers and Helm charts are stored in a common registry, which can be accessed by customers using their account credentials.
This guide demonstrates how to use Tanzu Application Catalog for Tanzu Advanced. It shows you how to sign in to the Tanzu Application Catalog, obtain your registry credentials and begin using containers and Helm charts on your local machine via Docker or Helm.
This tutorial assumes that:
To sign in to the Tanzu Application Catalog with your VMware account, your organization must include this service within its VMware Cloud Services. You can check if your organization has access to this service by signing into the Tanzu Application Catalog. Follow the steps below:
Click the "Sign in with VMware" button. If you have access to the Tanzu Application Catalog, you should be redirected to the "Catalogs" dashboard.
If your organization does not have access to this service, you will see a message like the one shown below, which allows you to change your current organization or navigate to the VMware Cloud Services Portal to get access to the service.
With the Tanzu Application Catalog, you have 24/7 access to your applications, their status, and deployment details.
In your account, you see two different assets available by default:
These are real artifacts that are continuously updated and can be consumed for development and deployment.
The default list shows, at first glance, the following information for container images:
If a container image has more than one version, you also see the different versions available for that image:
The catalog can be filtered by type, status and/or operating system, as shown below:
The "Details" link for a container image displays a page containing the following additional information:
An example of a container image detail page is shown below:
The default list shows, at first glance, the following information for Helm charts:
As with container images, this catalog can be filtered by type, status and/or operating system.
The "Details" link for a Helm chart displays a page containing the following additional information:
An example of a Helm chart detail page is shown below:
A Helm chart's dependencies can be inspected by clicking the container images shown in the "Dependencies" section. This redirects to the container details page (described in the previous section).
Before using the Tanzu Application Catalog for Tanzu Advanced, it is necessary to obtain credentials for the Tanzu Application Catalog registry. These credentials allow you to access the registry and pull container images and Helm charts from it.
Follow these steps:
On the "Registry Credentials" page, click the "Generate new credentials" button.
In the resulting dialog box, enter a description for the new credentials. Click the "Generate the new credentials" button.
The credentials are generated and displayed. Note the username and token, or click the "Download as JSON file" button to download them as a JSON file.
NOTE: These credentials will not be displayed again, so ensure that you download or copy them to a secure location, as you will need them in subsequent steps.
The Tanzu Application Catalog builds trusted and continuously maintained content that can be consumed in many different ways. The easiest way to get started is to use Tanzu Application Catalog container images and Helm charts in your local development environment using the Docker or Helm CLI.
To use a container image from the Tanzu Application Catalog:
Copy and execute the commands found for that release, in the "Consume your Container" section, as shown below:
Here is an example of how to run a Tanzu Application Catalog container image for MySQL. Enter the registry credentials obtained in Step 3 when prompted.
$ docker login registry.pivotal.io/tac-for-tanzu-advanced/containers $ docker run --rm registry.pivotal.io/tac-for-tanzu-advanced/containers/mysql@sha256:0090965aef191c9bd49f3d7ac93657f1e0257b1c4fc5ade87b82bfcf87408bd3
Before deploying a Helm chart from Tanzu Application Catalog for Tanzu Advanced, it is necessary to create a Kubernetes ImagePullSecret for registry.pivotal.io/tac-for-tanzu-advanced with the registry credentials obtained in Step 3.
Here is an example of how to create an ImagePullSecret. Replace the USERNAME andTOKEN placeholders with the registry credentials obtained in Step 3.
$ kubectl create secret docker-registry tac4adv \ --docker-server https://registry.pivotal.io/tac-for-tanzu-advanced \ --docker-username "USERNAME" \ --docker-password "TOKEN"
Charts can then be deployed either by adding the global.imagePullSecrets=SECRET-NAME parameter to each Helm deployment command, or by configuring the ImagePullSecret globally.
To use a Helm chart from the Tanzu Application Catalog:
Copy and execute the commands found for that release, in the "Consume your Helm chart" section, as shown below:
Here is an example of how to deploy a Tanzu Application Catalog Helm chart for Apache Kafka using the ImagePullSecret created earlier:
$ export HELM_EXPERIMENTAL_OCI=1 $ helm registry login registry.pivotal.io/tac-for-tanzu-advanced/charts $ helm chart pull registry.pivotal.io/tac-for-tanzu-advanced/charts/kafka:12.2.1 $ helm chart export registry.pivotal.io/tac-for-tanzu-advanced/charts/kafka:12.2.1 $ helm install kafka/ --generate-name --set "global.imagePullSecrets=tac4adv"
You should now have a good understanding of how to begin using the Tanzu Application Catalog for Tanzu Advanced, including browsing the catalog, obtained detailed information on container images and Helm charts and using these artifacts for development.
To learn more about the topics discussed in this tutorial, reach out to your VMware sales representative or use the links below: