Install Supply Chain Choreographer

This topic describes how you can install Supply Chain Choreographer from the Tanzu Application Platform package repository.

Note

Follow the steps in this topic if you do not want to use a profile to install Supply Chain Choreographer. For more information about profiles, see Components and installation profiles.

The Supply Chain Choreographer is now bundled with the Cartographer Conventions. For information on configuring and using Cartographer Conventions, see Creating conventions.

Supply Chain Choreographer provides the custom resource definitions the supply chain uses. Each pre-approved supply chain creates a clear road to production and orchestrates supply chain resources. You can test, build, scan, and deploy. Developers can focus on delivering value to users. Application operators can rest assured that all code in production has passed through an approved workflow.

For example, Supply Chain Choreographer passes the results of fetching source code to the component that builds a container image of it, and then passes the container image to a component that deploys the image.

Prerequisites

Before installing Supply Chain Choreographer, complete all prerequisites to install Tanzu Application Platform. For more information, see Prerequisites.

Install

To install Supply Chain Choreographer:

1. Get the values schema to see what properties can be configured during installation by running:

   tanzu package available get cartographer.tanzu.vmware.com/0.7.1+tap.1 --values-schema --namespace tap-install
   
   KEY                                      DEFAULT  TYPE     DESCRIPTION
   ca_cert_data                             ""       string   Optional: PEM Encoded certificate data for image registries with private CA.
   cartographer.concurrency.max_deliveries  2        integer  Optional: maximum number of Deliverables to process concurrently.
   cartographer.concurrency.max_runnables   2        integer  Optional: maximum number of Runnables to process concurrently.
   cartographer.concurrency.max_workloads   2        integer  Optional: maximum number of Workloads to process concurrently.
   cartographer.resources.limits.cpu        1000m             Optional: maximum amount of cpu resources to allow the controller to use
   cartographer.resources.limits.memory     128Mi             Optional: maximum amount of memory to allow the controller to use
   cartographer.resources.requests.cpu      250m              Optional: minimum amount of cpu to reserve
   cartographer.resources.requests.memory   128Mi             Optional: minimum amount of memory to reserve
   

2. Install v0.4.0 of the cartographer.tanzu.vmware.com package, naming the installation cartographer, by running:

   tanzu package install cartographer \
    --namespace tap-install \
    --package cartographer.tanzu.vmware.com \
    --version 0.7.1+tap.1
   

   Example output:

   | Installing package 'cartographer.tanzu.vmware.com'
   | Getting namespace 'tap-install'
   | Getting package metadata for 'cartographer.tanzu.vmware.com'
   | Creating service account 'cartographer-tap-install-sa'
   | Creating cluster admin role 'cartographer-tap-install-cluster-role'
   | Creating cluster role binding 'cartographer-tap-install-cluster-rolebinding'
   - Creating package resource
   \ Package install status: Reconciling
   
   Added installed package 'cartographer' in namespace 'tap-install'