To install Application Service Adapter, you need to first complete the prerequisites listed here.
Application Service Adapter requires using Cloud Foundry command-line interface (cf CLI) v8.1.0 or later. VMware recommends using v8.5.0 or later. For more information, see the cf CLI repository on GitHub.
To install Application Service Adapter, you need:
Admin access to a Kubernetes cluster that meets the same requirements as the version of Tanzu Application Platform you have installed, which must be v1.5. See Kubernetes cluster requirements in Prerequisites.
A container image registry. See VMware Tanzu Network and container image registry requirements in Prerequisites.
The following tools must be installed in the workstation environment in which you intend to perform the installation:
The Kubernetes CLI (kubectl) v1.24-v1.26.
Tanzu CLI and its plug-ins. See Install or update the Tanzu CLI and plug-ins in Accepting Tanzu Application Platform EULAs and installing Tanzu CLI.
After you install the Tanzu CLI, run tanzu plugin list
to verify that the required package
and secret
plug-ins are installed. To install these plug-ins, run:
tanzu plugin install --local cli package
tanzu plugin install --local cli secret
The following dependencies must be installed to the target Kubernetes cluster before installing Application Service Adapter. If you completed an installation of the full
profile or the iterate
profile of Tanzu Application Platform v1.3 or v1.4 in your target Kubernetes cluster, these dependencies are already present.
Cluster Essentials. See Deploying Cluster Essentials v1.5.
NoteIf you are operating a Tanzu Kubernetes Grid cluster, the Cluster Essentials are already installed.
cert-manager v2.3.0 or later for managing internal certificates.
Contour v1.22.5 or later for ingress control.
NoteYou must configure Contour's ingress to provision a LoadBalancer. See the default configuration in Install your Tanzu Application Platform profile in Installing Tanzu Application Platform Package and Profiles.
Service Bindings v0.9.1 or later.
full
, iterate
, or run
profile, this package is installed.Tanzu Build Service v1.10.8 or later for building images.
full
, iterate
, or build
profile, this package is installed.The following dependencies are required to be installed to the target Kubernetes cluster to opt into using the experimental Cartographer integration. If you installed Tanzu Application Platform v1.3 or v1.4 with the full
, iterate
, or build
profile, these dependencies are already present.
Out of the Box Templates v0.12.5 or later.
Supply Chain Choreographer v0.7.1 or later.
Source Controller v0.7.0 or later.
Tekton v0.41.0 or later.
VMware recommends installing the following dependencies to the target Kubernetes cluster.
NoteMany Kubernetes distributions automatically come with the Metrics Server installed. If the API resources in your target cluster include the
PodMetrics
Kind in themetrics.k8s.io
API group, the Metrics Server is already present.
After you installed these prerequisites, proceed to Install Application Service Adapter.
When installed to Amazon Elastic Container Service with ECR, Application Service Adapter requires a similar configuration to the setup required by Tanzu Application Platform, but needs access to additional resources and trusted service accounts.
Follow the Tanzu Application Platform instructions, with these amendments:
In build-service-trust-policy.json
add the following service accounts to the list of trusted service accounts:
In build-service-policy.json, add the following Resource:
"arn:aws:ecr:\({AWS_REGION}:\):repository/$*"
Where REPOSITORY_PREFIX_PATH
is the path portion of the REPOSITORY-PREFIX
you will provide when setting tas-adapter-values.yaml
for installation.