You can integrate Tanzu Application Platform GUI with several Git providers. To use an integration, you must enable it and provide the necessary token or credentials in tap-values.yaml
.
To add a GitHub provider integration, edit tap-values.yaml
as in this example:
app_config:
app:
baseUrl: http://EXTERNAL-IP:7000
# Existing tap-values.yaml above
integrations:
github: # Other integrations available see NOTE below
- host: github.com
token: GITHUB-TOKEN
Where:
EXTERNAL-IP
is the external IP address.GITHUB-TOKEN
is a valid token generated from your Git infrastructure of choice. Ensure GITHUB-TOKEN
has the necessary read permissions for the catalog definition files you extracted from the blank software catalog introduced in the Tanzu Application Platform GUI prerequisites.To enable Tanzu Application Platform GUI to read Git-based non-GitHub repositories containing component information:
Add the following YAML to tap-values.yaml
:
app_config:
# Existing tap-values.yaml above
backend:
reading:
allow:
- host: "GIT-CATALOG-URL-1"
- host: "GIT-CATALOG-URL-2" # Including more than one URL is optional
Where GIT-CATALOG-URL-1
and GIT-CATALOG-URL-2
are URLs in a list of URLs that Tanzu Application Platform GUI can read when registering new components. For example, git.example.com.
For more information about registering new components, see Adding catalog entities.
Adding the YAML from the previous step currently causes the Accelerators page to break and not show any accelerators. Provide a value for Application Accelerator as a workaround, as in this example:
app_config:
# Existing tap-values.yaml above
backend:
reading:
allow:
- host: acc-server.accelerator-system.svc.cluster.local
To add an integration for a provider that isn’t associated with GitHub, see the Backstage documentation.
After making changes to tap-values.yaml
, update the package profile by running:
tanzu package installed update tap --package-name tap.tanzu.vmware.com --version VERSION-NUMBER --values-file tap-values.yaml -n tap-install
Where VERSION-NUMBER
is the Tanzu Application Platform version. For example, 1.1.0
.
For example:
$ tanzu package installed update tap --package-name tap.tanzu.vmware.com --version 1.0.0 --values-file tap-values.yaml -n tap-install
| Updating package 'tap'
| Getting package install for 'tap'
| Getting package metadata for 'tap.tanzu.vmware.com'
| Updating secret 'tap-tap-install-values'
| Updating package install for 'tap'
/ Waiting for 'PackageInstall' reconciliation for 'tap'
Updated package install 'tap' in namespace 'tap-install'