Warning The Cartographer upstream project is not actively developed anymore. As a consequence, this package has been archived. Check out the https://github.com/kadras-io/supply-chains package from the Kadras Engineering Platform as an alternative.

A Carvel package for Cartographer, a cloud-native framework to build paved paths to production on Kubernetes.

• Kubernetes 1.27+

• Carvel kctrl CLI.

• Carvel kapp-controller deployed in your Kubernetes cluster. You can install it with Carvel kapp (recommended choice) or kubectl.

  kapp deploy -a kapp-controller -y \
    -f https://github.com/carvel-dev/kapp-controller/releases/latest/download/release.yml

Cartographer requires cert-manager. You can install it from the Kadras package repository.

Add the Kadras package repository to your Kubernetes cluster:

kctrl package repository add -r kadras-packages \
  --url ghcr.io/kadras-io/kadras-packages \
  -n kadras-packages --create-namespace

kubectl create namespace kadras-packages
kapp deploy -a cartographer-package -n kadras-packages -y \
  -f https://github.com/kadras-io/package-for-cartographer/releases/latest/download/metadata.yml \
  -f https://github.com/kadras-io/package-for-cartographer/releases/latest/download/package.yml

Install the Cartographer package:

kctrl package install -i cartographer \
  -p cartographer.packages.kadras.io \
  -v ${VERSION} \
  -n kadras-packages

Note You can find the ${VERSION} value by retrieving the list of package versions available in the Kadras package repository installed on your cluster.

kctrl package available list -p cartographer.packages.kadras.io -n kadras-packages

Verify the installed packages and their status:

kctrl package installed list -n kadras-packages

Documentation, tutorials and examples for this package are available in the docs folder. For documentation specific to Cartographer, check out cartographer.sh.

The Cartographer package can be customized via a values.yml file.

cartographer:
  concurrency:
    max_workloads: 10
    max_deliveries: 10

Reference the values.yml file from the kctrl command when installing or upgrading the package.

kctrl package install -i cartographer \
  -p cartographer.packages.kadras.io \
  -v ${VERSION} \
  -n kadras-packages \
  --values-file values.yml

The Cartographer package has the following configurable properties.

The security process for reporting vulnerabilities is described in SECURITY.md.

This project is licensed under the Apache License 2.0. See LICENSE for more information.

This package is based on the original Cartographer package used in the Tanzu Community Edition project before its retirement.