Kustomize Deployment¶

xp-tracker ships with Kustomize manifests organised as a base plus overlays.

Base¶

The base at deploy/base/ includes:

The base deploys to the crossplane-system namespace and includes placeholder GVRs that must be overridden.

# Review rendered manifests
kubectl kustomize deploy/base

# Apply
kubectl apply -k deploy/base

Example overlay¶

The example overlay at deploy/overlays/example/ demonstrates:

• Patching the ConfigMap with real GVRs and annotation keys
• Adding a ServiceMonitor for Prometheus Operator
• Pinning the container image tag

kubectl apply -k deploy/overlays/example

Creating your own overlay¶

Create a directory for your environment:

deploy/overlays/my-env/
  kustomization.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

resources:
  - ../../base

patches:
  - target:
      kind: ConfigMap
      name: crossplane-metrics-exporter
    patch: |
      apiVersion: v1
      kind: ConfigMap
      metadata:
        name: crossplane-metrics-exporter
      data:
        CLAIM_GVRS: "myorg.io/v1alpha1/databases,myorg.io/v1alpha1/caches"
        XR_GVRS: "myorg.io/v1alpha1/xdatabases,myorg.io/v1alpha1/xcaches"
        CREATOR_ANNOTATION_KEY: "myorg.io/created-by"
        TEAM_ANNOTATION_KEY: "myorg.io/team"

images:
  - name: ghcr.io/kanzifucius/xp-tracker
    newTag: v0.1.0

Namespace¶

The base sets namespace: crossplane-system. To deploy to a different namespace, add a namespace field in your overlay's kustomization.yaml:

namespace: monitoring

Image override¶

Use the Kustomize images transformer to pin a specific tag:

images:
  - name: ghcr.io/kanzifucius/xp-tracker
    newTag: v0.2.0

Single replica requirement¶