Warning This package has been replaced by workspace-provisioner.

This project provides a Carvel package for setting up namespaces with the necessary RBAC and Secrets to work with the Kadras application platform.

• Kubernetes 1.24+

• 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/vmware-tanzu/carvel-kapp-controller/releases/latest/download/release.yml

Namespace Setup requires the Secretgen Controller package to be already installed in the cluster. You can install it from the Kadras package repository.

First, add the Kadras package repository to your Kubernetes cluster.

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

Then, install the Namespace Setup package.

kctrl package install -i namespace-setup \
  -p namespace-setup.packages.kadras.io \
  -v 0.2.1 \
  -n kadras-packages

You can verify the list of installed Carvel packages and their status.

kctrl package installed list -n kadras-packages

You can get the list of Namespace Setup versions available in the Kadras package repository.

kctrl package available list -p namespace-setup.packages.kadras.io -n kadras-packages

The Namespace Setup package has the following configurable properties.

You can define your configuration in a values.yml file.

namespaces:
  - name: ""
    exists: ""

registry:
  server: ""
  username: ""
  password: ""

gitops:
  server: https://github.com
  username: ""
  password: ""

Then, reference it from the kctrl command when installing or upgrading the package.

kctrl package install -i namespace-setup \
  -p namespace-setup.packages.kadras.io \
  -v 0.2.1 \
  -n kadras-packages \
  --values-file values.yml

You can upgrade an existing package to a newer version using kctrl.

kctrl package installed update -i namespace-setup \
  -v <new-version> \
  -n kadras-packages

You can also update an existing package with a newer values.yml file.

kctrl package installed update -i namespace-setup \
  -n kadras-packages \
  --values-file values.yml

The recommended way of installing the Namespace Setup package is via the Kadras package repository. If you prefer not using the repository, you can install the package by creating the necessary Carvel PackageMetadata and Package resources directly using kapp or kubectl.

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

This package is inspired by the setup included in an example of Tanzu Application Platform OSS stack.

This project is compliant with level 3 of the SLSA Framework.