# anishp55/nkp-mgmt-install-public architecture

> Architecture diagram of the GitHub repository anishp55/nkp-mgmt-install-public, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anishp55/nkp-mgmt-install-public
- Repository: https://github.com/anishp55/nkp-mgmt-install-public

## Overview

nkp-mgmt-install is an operations repository for installing and configuring an NKP management cluster through manually triggered GitHub Actions workflows and supporting configuration. Its principal workflow is to run the NKP installation, which produces a management cluster with a starter license; applying a supplied license is a separate optional step. The tree also shows workflows and configuration for identity, Flux, applications, secrets, and cluster lifecycle. The README documents only the installation and license sequence, so links to other subsystems are not inferred.

Main entry points: [`.github/workflows/install_nkp.yaml`](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/install_nkp.yaml) (Install NKP), [`.github/workflows/apply_license.yaml`](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/apply_license.yaml) (Apply license), [`license/license.yaml`](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/license/license.yaml) (License configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Cluster installation"]
  node_install_nkp["Install NKP<br/>[install_nkp.yaml]"]
  node_install_no_certs["Install without certs"]
  node_install_self_reg["Install self-register"]
  node_install_script["Install script<br/>[nkp-install.sh]"]
  node_install_vars["Environment variables<br/>[nkp-vars.sh]"]
  node_management_cluster["Management cluster"]
  node_cluster_delete["Delete cluster"]
end

subgraph group_platform["Platform configuration"]
  node_license_workflow["Apply license<br/>[apply_license.yaml]"]
  node_license_config["License configuration<br/>[license.yaml]"]
  node_flux["Flux GitOps"]
  node_secrets["Secrets setup"]
end

subgraph group_identity["Identity and access"]
  node_idp["Identity providers"]
  node_ldap["LDAP configuration<br/>[01-ldap.yaml]"]
  node_virtual_groups["Virtual groups<br/>[auth0-vg.yaml]"]
  node_group_bindings["Group role bindings<br/>[auth0-vgcrb.yaml]"]
end

subgraph group_apps["Applications and services"]
  node_app_workflows["App lifecycle<br/>[enable-apps.yaml]"]
  node_app_config["Application settings"]
  node_external_dns["External DNS<br/>[external_dns.yaml]"]
  node_velero["Velero<br/>[velero.yaml]"]
  node_loki_config["Loki settings"]
end

node_operator(("Operator"))
node_runner["Self-hosted runner"]

node_operator -->|"runs manually"| node_install_nkp
node_runner -->|"provides tools"| node_install_nkp
node_install_nkp -->|"deploys"| node_management_cluster
node_operator -->|"runs optionally"| node_license_workflow
node_license_workflow -.->|"applies license"| node_license_config

click node_install_nkp "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/install_nkp.yaml"
click node_install_no_certs "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/install_nkp_no_certs.yaml"
click node_install_self_reg "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/install_nkp_no_cert_self_reg.yaml"
click node_install_script "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/nkp-install.sh"
click node_install_vars "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/nkp-vars.sh"
click node_license_workflow "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/apply_license.yaml"
click node_license_config "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/license/license.yaml"
click node_flux "https://github.com/anishp55/nkp-mgmt-install-public/tree/main/flux-project"
click node_secrets "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/create_secrets.yaml"
click node_idp "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/idps/auth0-oidc-idp.yaml"
click node_ldap "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/ldap/01-ldap.yaml"
click node_virtual_groups "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/virtualgroups/auth0-vg.yaml"
click node_group_bindings "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/virtualgroupclusterrolebindings/auth0-vgcrb.yaml"
click node_app_workflows "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/enable-apps.yaml"
click node_app_config "https://github.com/anishp55/nkp-mgmt-install-public/tree/main/appdeployments"
click node_external_dns "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/external_dns.yaml"
click node_velero "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/velero.yaml"
click node_loki_config "https://github.com/anishp55/nkp-mgmt-install-public/tree/main/appdeployments/loki"
click node_cluster_delete "https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/delete_mgmt_cluster.yaml"

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_install_nkp,node_install_no_certs,node_install_self_reg,node_install_script,node_install_vars,node_management_cluster,node_cluster_delete toneBlue
class node_license_workflow,node_license_config,node_flux,node_secrets toneAmber
class node_idp,node_ldap,node_virtual_groups,node_group_bindings toneMint
class node_app_workflows,node_app_config,node_external_dns,node_velero,node_loki_config toneRose
class node_operator,node_runner toneIndigo
```

## Components

### Cluster installation

- [Install NKP](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/install_nkp.yaml): `.github/workflows/install_nkp.yaml`
- [Install without certs](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/install_nkp_no_certs.yaml): `.github/workflows/install_nkp_no_certs.yaml`
- [Install self-register](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/install_nkp_no_cert_self_reg.yaml): `.github/workflows/install_nkp_no_cert_self_reg.yaml`
- [Install script](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/nkp-install.sh): `nkp-install.sh`
- [Environment variables](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/nkp-vars.sh): `nkp-vars.sh`
- **Management cluster**
- [Delete cluster](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/delete_mgmt_cluster.yaml): `.github/workflows/delete_mgmt_cluster.yaml`

### Platform configuration

- [Apply license](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/apply_license.yaml): `.github/workflows/apply_license.yaml`
- [License configuration](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/license/license.yaml): `license/license.yaml`
- [Flux GitOps](https://github.com/anishp55/nkp-mgmt-install-public/tree/main/flux-project): `flux-project`
- [Secrets setup](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/create_secrets.yaml): `.github/workflows/create_secrets.yaml`

### Identity and access

- [Identity providers](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/idps/auth0-oidc-idp.yaml): `idps/auth0-oidc-idp.yaml`
- [LDAP configuration](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/ldap/01-ldap.yaml): `ldap/01-ldap.yaml`
- [Virtual groups](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/virtualgroups/auth0-vg.yaml): `virtualgroups/auth0-vg.yaml`
- [Group role bindings](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/virtualgroupclusterrolebindings/auth0-vgcrb.yaml): `virtualgroupclusterrolebindings/auth0-vgcrb.yaml`

### Applications and services

- [App lifecycle](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/enable-apps.yaml): `.github/workflows/enable-apps.yaml`
- [Application settings](https://github.com/anishp55/nkp-mgmt-install-public/tree/main/appdeployments): `appdeployments`
- [External DNS](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/external_dns.yaml): `.github/workflows/external_dns.yaml`
- [Velero](https://github.com/anishp55/nkp-mgmt-install-public/blob/main/.github/workflows/velero.yaml): `.github/workflows/velero.yaml`
- [Loki settings](https://github.com/anishp55/nkp-mgmt-install-public/tree/main/appdeployments/loki): `appdeployments/loki`

### Other components

- **Operator**
- **Self-hosted runner**

## Connections

- Operator → Install NKP: runs manually (evidence: `README.md`)
- Self-hosted runner → Install NKP: provides tools (evidence: `README.md`)
- Install NKP → Management cluster: deploys (evidence: `README.md`)
- Operator → Apply license: runs optionally (evidence: `README.md`)
- Apply license → License configuration: applies license
