Welcome to my public repository for my "kubernetes blueprint".

Prerequisites
Getting Started
- Installation
- Configuration of harbor
Internal Components
Available URLS:
Using harbor in k8s
Repository layout
- Cluster definitions
- Creating new resources
External references
Troubleshooting
- Flux-system can't check image tags due to x509 error
- Slackhook not working

Prerequisites

For deploying local-minimal or local(default) cluster you require atleast 16GB of mamory.
Read up on Flux V2, and their multi-cluster setup
Add 127.0.0.0/8 and harbor.k8s-local.io to the list of insecure registries and restart docker

Getting Started

Installation

Instal through brew, or your favorite package manager fluxctl and argo.

brew install helm fluxcd/tap/flux argoproj/tap/argo

And after, run bin/setup

bin/setup.sh

Retrieving secrets

in case of needing to know the secrets:

bin/secrets.sh

Configuration of harbor

To setup harbor for the demo project:

bin/setup_harbor.sh

Demo user: demo with password Demodemo0
Project: demo
Administrator account is printed by: bin/secrets.sh

Configuration of MinIO

To setup MinIO for the demo project:

bin/setup_minio.sh

This will create the required MinIO operator tenant.

Internal Components

Prometheus (Metrics)
Grafana (Dashboards)
Argo-workflows (Workflows)
Argo Events (Events controller)
ArgoCD (Continuous Delivery)
MinIO (S3 like object store)
Harbor (Helm & Docker registry)
Sealed-secrets Secure secrets
Demo app (Static HTML on nginx alpine container)
GitOps Toolkit
Kubernetes Dashboard
Nginx Ingress

Available URLS:

Using harbor in k8s

Add the following to the docker config (docker for mac e.g.)

{
  "insecure-registries": [
    "harbor.k8s-local.io"
  ]
}

Repository layout

├── argo                   # Pipelines / argo workflows / argo-events that create workflows
├── bin                    # Helper scripts
├── flux                   # Flux installation directory
├── k8                     # primary kubernetes manifests directory
│   ├── apps               # primary manifests directory
│   │   ├── base           # the base directory for all "apps" in kubernetes. Cluster kustomizations refer to this
│   │   ├── demo           #      for demo cluster deployment
│   │   ├── local          #      for local cluster deployment
│   ├── clusters           # primary cluster manifests directory
│   │   ├── demo           #      for demo cluster deployment
│   │   ├── local          #      for local cluster deployment
│   ├── core               # core k8s infrastructure manifests directory
│   │   ├── base           # the base directory for all "core" components in kubernetes. Cluster kustomizations refer to this
│   │   ├── demo           #      for demo cluster deployment
│   │   ├── local          #      for local cluster deployment
│   └── infrastructure     # Kubernetes infrastructure that will be deployed as is in every cluster.
└── templates              # Azure DevOps Pipelines templates

Cluster definitions

Cluster	argo	argo-events	argocd	demo	harbor	ingress-nginx	kubernetes-dashboard	loki-stack	metrics-server	minio	minio-tenant-1	cert-manager
demo	X	X	-	X	X	X	-	-	-	X	X	x
local	X	X	-	-	-	X	-	-	-	-	-	x

Creating new resources

Applications

Create the appropriate manifests in k8s/apps/base like you would normally.
Add a kustomization.yaml to this directory. See example below.

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: your-namespace
resources:
  - namespace.yaml
  - secret.yaml
  - deployment.yaml
  - service.yaml
  - ingress.yaml

Note: the order of resources does matter, as this will be the deployment order..

For the cluster add in k8s/<cluster>/apps/your-app the following files: kustomization.yaml and if cluster customisations are required a <app-patch>.yaml.

kustomization.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: your-namespace
resources:
  - ../../base/your-app
patchesStrategicMerge:
  - app-patch.yaml

app-patch.yaml

apiVersion: helm.toolkit.fluxcd.io/v2beta1
kind: Deployment
metadata:
  name: your-app
  namespace: your-namespace
spec:
  resources:
    requests:
      memory: 64Mi
      cpu: 500m
    limits:
      memory: 128Mi
      cpu: 1000m

Note: you can kustomize any kubernetes resource (including CRDS)

In k8s/clusters/<cluster>/apps/your-app.yaml add the below example to actually activate your app in the cluster

apiVersion: kustomize.toolkit.fluxcd.io/v1beta1
kind: Kustomization
metadata:
  name: app-your-app
  namespace: flux-system
spec:
  interval: 5m
  dependsOn:
    - name: infrastructure
  sourceRef:
    kind: GitRepository
    name: playground
  path: ./k8s/apps/<cluster>/apps/your-app
  prune: true

Pipelines / Workflows

TBD

Infrastructure components

TBD

Clusters

TBD

External references

Troubleshooting

Flux-system can't check image tags due to x509 error

This is due to having self-signed certificates. The fix is also in bin/setup.sh function setup_harbor

HARBOR_CERTS=$(kubectl --namespace harbor get secret harbor-harbor-ingress -o jsonpath="{.data}" | jq -r)
cat <<YAML | kubectl --namespace flux-system apply -f -
apiVersion: v1
kind: Secret
metadata:
name: harbor-tls-certs
namespace: flux-system
type: Opaque
data:
caFile: $(echo ${HARBOR_CERTS} | jq -r ".\"ca.crt\"")
certFile: $(echo ${HARBOR_CERTS} | jq -r ".\"tls.crt\"")
keyFile: $(echo ${HARBOR_CERTS} | jq -r ".\"tls.key\"")
YAML

Slackhook not working

Well.. I removed a file. I don't like to share my slack tokens with ya'll.

cat <<YAML | kubectl apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: slack-secret
  namespace: argo-events
data:
  token: <base64 slack app token. xobx-.....>
YAML

dazmc / kubernetes-flux-layout