Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
git-commit

GitHub Action

Kustomized Namespace - Create Overlay

v1.1.1

Kustomized Namespace - Create Overlay

git-commit

Kustomized Namespace - Create Overlay

This creates an overlay within a namespace for a feature and ensures your services are still connected

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Kustomized Namespace - Create Overlay

uses: dudo/[email protected]

Learn more about this action in dudo/create_kustomized_namespace

Choose a version

Kustomized Namespaces

Provide management of infinite namespaced feature branch deployments to a Kubernetes cluster via Kustomize. This is designed to read from a GitHub repository containing your manifests, structured as such (example):

.
├── blue/
│   ├── base/
│   │   ├── kustomization.yaml
│   │   ├── deployment.yaml
│   │   ├── service.yaml
│   │   └── etc...yaml
│   └── overlays/ # this folder will be created **and managed** for you
│       ├── development/
│       │   └── kustomization.yaml
│       ├── feature-branch-1/
│       │   └── kustomization.yaml
│       └── feature-branch-2/
│           └── kustomization.yaml
└── red/
    ├── base/
    │   ├── kustomization.yaml
    │   ├── deployment.yaml
    │   ├── service.yaml
    │   └── etc...yaml
    └── overlays/ # this folder will be created **and managed** for you
        ├── development/
        │   └── kustomization.yaml
        ├── feature-branch-1/
        │   └── kustomization.yaml
        └── feature-branch-2/
            └── kustomization.yaml

You only need to tell Kustomize about the files in your base folder, per kustomize, the rest is managed for you. Within each services’ base folder, create an appropriate kustomization.yaml

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

resources:
- deployment.yaml
- service.yaml
- etc...yaml

Create

This repository creates a namespace, and ensures that your services play nicely with each other within it.

As you deploy a feature for a given service, all of your other services are "deployed" within that namespace, but pointed to the service running in the default namespace via ExternalName. This allows integration tests to be run to ensure that your new features play nicely with existing services. If deploy a second service within the same namespace, it will behave as expected, and deploy the image appropriately.

Ingress are created, to allow any visual testing, as a subdomain matching your feature (but transformed to kebab-case, ie feature-branch-1.localhost).

Flags

  • -s, --service - The service to deploy to your cluster
  • -r, --cluster-repo - GitHub repository that controls your cluster'
  • -i, --target-image - Remotely hosted target image
  • -n, --namespace - Desired namespace, or inferred from $GITHUB_REF
  • -t, --tag - Image tag, or inferred from $GITHUB_SHA
  • -T, --token - GitHub access token with repos access, NOT $GITHUB_TOKEN
  • --flux - a manifest is generated to allow Weave Flux to deploy your cluster
  • --dry-run - the yaml files are printed to stdout
  • —-built - when paired with —-dry-run, will build your kustomizations and output the built manifests

Demo

Check out the overlays to be created:

docker build -t kustomized_namespaces/create:latest .
docker run kustomized_namespaces/create:latest -r dudo/k8s_colors -n feature_branch_1 -s blue -i dudo/blue -t latest --dry-run

And to see Kustomize do its thing:

ruby create_overlay.rb -r dudo/k8s_colors -n feature_branch_1 -s blue -i dudo/blue -t latest --dry-run --built

Actually commit to your repo!

docker run kustomized_namespaces/create:latest -r dudo/k8s_colors -n feature_branch_1 -s blue -i dudo/blue -t latest -T YourReposDeployKeyToken