Cluster API Add-on Provider for Cdk8s

Cdk8sAppProxy CRD

The Cdk8sAppProxy CustomResourceDefinition (CRD) is used to manage the deployment of cdk8s applications to workload clusters. It allows users to specify the source of the cdk8s application, any input values, and the target clusters for deployment.

Example Manifest

An example of a Cdk8sAppProxy manifest can be found in examples/cdk8sappproxy_sample-go.yaml. Below is a snippet:

apiVersion: addons.cluster.x-k8s.io/v1alpha1
kind: Cdk8sAppProxy
metadata:
  name: cdk8s-sample-app-go
  namespace: default
spec:
  gitRepository:
    url: "https://github.com/eitco/cluster-api-addon-provider-cdk8s"
    reference: "main"
    path: "examples/cdk8s-sample-deployment"
  clusterSelector: {} 
    # matchLabels:
      # environment: development

If you want to use a public or private repository for your deployments, you can find some guidance here

Cdk8sAppProxySpec Fields

• gitRepository: (Optional) Specifies the Git repository for the cdk8s application. gitRepository must be specified.
  • url: (Required) The Git repository URL.
  • reference: (Required) The Git reference (branch, tag, or commit) to check out.
  • path: (Required) The path within the repository where the cdk8s application is located. Defaults to the root.
• clusterSelector: (Required) A metav1.LabelSelector that specifies which workload clusters the cdk8s application should be deployed to. The controller will watch for clusters matching this selector.

Examples

Examples of Cdk8sAppProxy usage can be found in the /examples directory in this repository.

• examples/cdk8sappproxy_sample-go.yaml: This example demonstrates how to deploy a sample cdk8s application from a public Git repository to clusters matching a specific label selector. It shows the usage of the gitRepository field.
• examples/cdk8sappproxy_sample-typescript.yaml: This directory contains a sample cdk8s application written in Typescript, which also generates a kustomization file.

Supported Platforms:

amd64 arm64 ppc64le

s390 and arm is currently not supported.

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.