# codefresh-contrib/gitops-certification-examples architecture

> Architecture diagram of the GitHub repository codefresh-contrib/gitops-certification-examples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codefresh-contrib/gitops-certification-examples
- Repository: https://github.com/codefresh-contrib/gitops-certification-examples

## Overview

This is a collection of Codefresh GitOps certification examples, not one application: it demonstrates Kubernetes workload definitions, deployment packaging and customization, progressive delivery, and encrypted secrets. A learner explores the examples; in the implied workflow, GitOps tooling applies configurations to a cluster, which runs the workloads. The README establishes the workshop context but does not document individual runtime connections, and the sampled source covers only two small web servers, so the dashed links below are unverified. Each branch represents a distinct example rather than a shared pipeline.

Main entry points: [`secret-app/manifests`](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/secret-app/manifests) (Encrypted secrets), [`rollouts-controller-172/install.yaml`](https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/rollouts-controller-172/install.yaml) (Rollouts controller), [`simple-app`](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/simple-app) (Simple workload), [`sync-strategies`](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/sync-strategies) (Sync strategies)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workloads["Workload examples"]
  node_simple["Simple workload"]
  node_sync["Sync strategies"]
  node_web["Basic web server"]
  node_canaryweb["Canary web app<br/>[app.go]"]
end

subgraph group_config["Deployment configuration"]
  node_declarative["Declarative apps"]
  node_helm["Helm charts"]
  node_kustomize["Kustomize overlays"]
end

subgraph group_delivery["Progressive delivery"]
  node_bluegreen["Blue-green rollout"]
  node_canarymanual["Manual canary"]
  node_canaryauto["Automatic canary"]
  node_rolloutcontroller["Rollouts controller<br/>[install.yaml]"]
end

subgraph group_secrets["Secret management"]
  node_secretmanifests["Encrypted secrets"]
  node_sealedcontroller["Sealed Secrets controller<br/>[controller.yaml]"]
  node_secretworkload["Secret-backed workload<br/>[deployment.yml]"]
end

node_learner(("GitOps learner"))
node_gitops{{"GitOps tooling"}}
node_cluster{{"Kubernetes cluster"}}

node_learner -.->|"explores examples"| node_gitops
node_gitops -.->|"applies manifests"| node_simple
node_gitops -.->|"applies manifests"| node_sync
node_gitops -.->|"applies manifests"| node_declarative
node_gitops -.->|"deploys charts"| node_helm
node_gitops -.->|"applies overlays"| node_kustomize
node_gitops -.->|"applies rollout"| node_bluegreen
node_gitops -.->|"applies rollout"| node_canarymanual
node_gitops -.->|"applies rollout"| node_canaryauto
node_gitops -.->|"applies manifests"| node_secretmanifests
node_simple -.->|"runs on"| node_cluster
node_sync -.->|"runs on"| node_cluster
node_declarative -.->|"configures"| node_cluster
node_helm -.->|"deploys to"| node_cluster
node_kustomize -.->|"configures"| node_cluster
node_bluegreen -.->|"uses controller"| node_rolloutcontroller
node_canarymanual -.->|"uses controller"| node_rolloutcontroller
node_canaryauto -.->|"uses controller"| node_rolloutcontroller
node_canaryweb -.->|"runs on"| node_cluster
node_web -.->|"runs on"| node_cluster
node_secretmanifests -.->|"uses controller"| node_sealedcontroller
node_secretmanifests -.->|"configures"| node_secretworkload
node_secretworkload -.->|"runs on"| node_cluster

click node_simple "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/simple-app"
click node_sync "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/sync-strategies"
click node_web "https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/source-code/trivial-web-server.go"
click node_canaryweb "https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/source-code-canary/app.go"
click node_declarative "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/declarative"
click node_helm "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/helm-apps"
click node_kustomize "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/kustomize-apps"
click node_bluegreen "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/blue-green-app"
click node_canarymanual "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/canary-app-manual"
click node_canaryauto "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/canary-app-automatic"
click node_rolloutcontroller "https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/rollouts-controller-172/install.yaml"
click node_secretmanifests "https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/secret-app/manifests"
click node_sealedcontroller "https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/sealed-controller-28/controller.yaml"
click node_secretworkload "https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/secret-app/manifests/deployment.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_simple,node_sync,node_web,node_canaryweb toneBlue
class node_declarative,node_helm,node_kustomize toneAmber
class node_bluegreen,node_canarymanual,node_canaryauto,node_rolloutcontroller toneMint
class node_secretmanifests,node_sealedcontroller,node_secretworkload toneRose
class node_learner,node_gitops,node_cluster toneIndigo
```

## Components

### Workload examples

- [Simple workload](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/simple-app): `simple-app`
- [Sync strategies](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/sync-strategies): `sync-strategies`
- [Basic web server](https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/source-code/trivial-web-server.go): `source-code/trivial-web-server.go`
- [Canary web app](https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/source-code-canary/app.go): `source-code-canary/app.go`

### Deployment configuration

- [Declarative apps](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/declarative): `declarative`
- [Helm charts](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/helm-apps): `helm-apps`
- [Kustomize overlays](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/kustomize-apps): `kustomize-apps`

### Progressive delivery

- [Blue-green rollout](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/blue-green-app): `blue-green-app`
- [Manual canary](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/canary-app-manual): `canary-app-manual`
- [Automatic canary](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/canary-app-automatic): `canary-app-automatic`
- [Rollouts controller](https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/rollouts-controller-172/install.yaml): `rollouts-controller-172/install.yaml`

### Secret management

- [Encrypted secrets](https://github.com/codefresh-contrib/gitops-certification-examples/tree/main/secret-app/manifests): `secret-app/manifests`
- [Sealed Secrets controller](https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/sealed-controller-28/controller.yaml): `sealed-controller-28/controller.yaml`
- [Secret-backed workload](https://github.com/codefresh-contrib/gitops-certification-examples/blob/main/secret-app/manifests/deployment.yml): `secret-app/manifests/deployment.yml`

### Other components

- **GitOps learner**
- **GitOps tooling**
- **Kubernetes cluster**

## Connections

- GitOps learner → GitOps tooling: explores examples
- GitOps tooling → Simple workload: applies manifests
- GitOps tooling → Sync strategies: applies manifests
- GitOps tooling → Declarative apps: applies manifests
- GitOps tooling → Helm charts: deploys charts
- GitOps tooling → Kustomize overlays: applies overlays
- GitOps tooling → Blue-green rollout: applies rollout
- GitOps tooling → Manual canary: applies rollout
- GitOps tooling → Automatic canary: applies rollout
- GitOps tooling → Encrypted secrets: applies manifests
- Simple workload → Kubernetes cluster: runs on
- Sync strategies → Kubernetes cluster: runs on
- Declarative apps → Kubernetes cluster: configures
- Helm charts → Kubernetes cluster: deploys to
- Kustomize overlays → Kubernetes cluster: configures
- Blue-green rollout → Rollouts controller: uses controller
- Manual canary → Rollouts controller: uses controller
- Automatic canary → Rollouts controller: uses controller
- Canary web app → Kubernetes cluster: runs on
- Basic web server → Kubernetes cluster: runs on
- Encrypted secrets → Sealed Secrets controller: uses controller
- Encrypted secrets → Secret-backed workload: configures
- Secret-backed workload → Kubernetes cluster: runs on
