Skip to content



Validations Upgrade Test

Cartographer is a Kubernetes-native Choreographer providing higher modularity and scalability for the software supply chain.

Learn more about Cartographer

Getting Started

Examples of using Cartographer can be found in the examples folder of this repository. The examples begin by demonstrating how to define a Supply Chain that pulls code from a repository, builds an image for the code, and deploys in the same cluster. Enhancements of that example (e.g. adding tests) are then demonstrated.


Pre requisites

  1. Administrative capabilities in a Kubernetes cluster (1.19+)
  2. cert-manager 1.5.3 installed

The quickest method to install Cartographer leverages the cartographer.yaml file provided with each release:

  1. Create the namespace where the controller will be installed:
kubectl create namespace cartographer-system
  1. Submit the objects included in the release:
kubectl apply -f

And you're done!


Detailed documentation for Cartographer can be found in the site folder of this repository:

🤗 Community, discussion, contribution, and support

Cartographer is developed in the open and is constantly improved by our users, contributors and maintainers. It is because of you that we are able to configure Kubernetes resources into reusable Supply Chains.

Join us!

If you have questions or want to get the latest project news, you can connect with us in the following ways:

  • Chat with us in the Kubernetes Slack in the #cartographer channel
  • Subscribe to the Cartographer Google Group for access to discussions and calendars
  • Join our weekly Office Hours meetings where we share the latest project news, answer questions and discuss the ideas to keep improving the project following the RFC process :


Pull Requests and feedback on issues are very welcome! See the issue tracker if you're unsure where to start, especially the Good first issue label, and also feel free to reach out to discuss.

If you are ready to jump in and test, add code, or help with documentation, please follow the instructions on our Contribution Guidelines to get started and - at all times- follow our Code of Conduct.


Apache 2.0. Refer to LICENSE for details.