feat: Kea dhcp

.yamllint.yaml

@@ -3,6 +3,7 @@ extends: default
 ignore:
   - components/etcdbackup/templates/
   - charts/argocd-understack/templates/
+  - charts/kea-dhcp/templates/
   - charts/nautobot-api-tokens/templates/
   - charts/nautobot-job-queues/templates/
   - charts/site-workflows/templates/

apps/appsets/project-understack.yaml

@@ -7,38 +7,40 @@ metadata:
   # they move between AppProject's
 spec:
   sourceRepos:
-  - '*'
+    - "*"
   destinations:
-  - namespace: 'argo'
-    server: '*'
-  - namespace: 'argocd'
-    server: '*'
-  - namespace: 'argo-events'
-    server: '*'
-  - namespace: 'understack-cdn'
-    server: '*'
-  - namespace: 'cert-manager'
-    server: '*'
-  - namespace: 'dex'
-    server: '*'
-  - namespace: 'nautobot'
-    server: '*'
-  - namespace: 'nautobotop'
-    server: '*'
-  - namespace: 'undersync'
-    server: '*'
-  - namespace: 'openstack'
-    server: '*'
-  - namespace: 'monitoring'
-    server: '*'
-  - namespace: 'otel-collector'
-    server: '*'
-  - namespace: 'kube-system'
-    server: '*'
-  - namespace: 'envoy-gateway'
-    server: '*'
-  - namespace: 'rook-ceph'
-    server: '*'
+    - namespace: "argo"
+      server: "*"
+    - namespace: "argocd"
+      server: "*"
+    - namespace: "argo-events"
+      server: "*"
+    - namespace: "understack-cdn"
+      server: "*"
+    - namespace: "cert-manager"
+      server: "*"
+    - namespace: "dex"
+      server: "*"
+    - namespace: "kea"
+      server: "*"
+    - namespace: "nautobot"
+      server: "*"
+    - namespace: "nautobotop"
+      server: "*"
+    - namespace: "undersync"
+      server: "*"
+    - namespace: "openstack"
+      server: "*"
+    - namespace: "monitoring"
+      server: "*"
+    - namespace: "otel-collector"
+      server: "*"
+    - namespace: "kube-system"
+      server: "*"
+    - namespace: "envoy-gateway"
+      server: "*"
+    - namespace: "rook-ceph"
+      server: "*"
   clusterResourceWhitelist:
-  - group: '*'
-    kind: '*'
+    - group: "*"
+      kind: "*"

charts/argocd-understack/README.md

@@ -177,6 +177,7 @@ Components deployed on site clusters:
 | argo-workflows | `site.argo_workflows` | Workflow engine |
 | chrony | `site.chrony` | NTP service |
 | envoy-configs | `site.envoy_configs` | Gateway configs |
+| kea | `site.kea` | DHCP server |
 | openstack-exporter | `site.openstack_exporter` | Metrics exporter |
 | openstack-memcached | `site.openstack_memcached` | Caching |
 | site-workflows | `site.site_workflows` | Site workflows |

charts/argocd-understack/templates/application-kea.yaml

@@ -0,0 +1,45 @@
+{{- if eq (include "understack.isEnabled" (list $.Values.site "kea")) "true" }}
+---
+apiVersion: argoproj.io/v1alpha1
+kind: Application
+metadata:
+  name: {{ printf "%s-%s" $.Release.Name "kea" }}
+  finalizers:
+  - resources-finalizer.argocd.argoproj.io
+  annotations:
+    argocd.argoproj.io/compare-options: ServerSideDiff=true,IncludeMutationWebhook=true
+{{- include "understack.appLabelsBlock" $ | nindent 2 }}
+spec:
+  destination:
+    # TODO: revert to `kea` once that namespace is deployable again
+    namespace: openstack
+    server: {{ $.Values.cluster_server }}
+  project: understack
+  sources:
+  - ref: understack
+    path: 'charts/kea-dhcp'
+    repoURL: {{ include "understack.understack_url" $ }}
+    targetRevision: {{ include "understack.understack_ref" $ }}
+    helm:
+      ignoreMissingValueFiles: true
+      releaseName: kea
+      valueFiles:
+      - $understack/components/kea/values.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/kea/values.yaml
+  - path: {{ include "understack.deploy_path" $ }}/kea
+    ref: deploy
+    repoURL: {{ include "understack.deploy_url" $ }}
+    targetRevision: {{ include "understack.deploy_ref" $ }}
+  syncPolicy:
+    automated:
+      prune: true
+      selfHeal: true
+    managedNamespaceMetadata:
+      annotations:
+        argocd.argoproj.io/sync-options: Delete=false
+    syncOptions:
+    - CreateNamespace=true
+    - ServerSideApply=true
+    - RespectIgnoreDifferences=true
+    - ApplyOutOfSyncOnly=true
+{{- end }}

charts/argocd-understack/values.yaml

@@ -475,6 +475,12 @@ site:
     # @default -- false
     enabled: false
 
+  # -- Kea DHCP server
+  kea:
+    # -- Enable/disable deploying Kea DHCP
+    # @default -- false
+    enabled: false
+
   # -- External DNS operator
   external_dns:
     # -- Enable/disable deploying External DNS

charts/kea-dhcp/.helmignore

@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/

charts/kea-dhcp/Chart.yaml

@@ -0,0 +1,33 @@
+apiVersion: v2
+name: kea-dhcp
+description: Helm chart for kea-dhcp
+
+# A chart can be either an 'application' or a 'library' chart.
+#
+# Application charts are a collection of templates that can be packaged into versioned archives
+# to be deployed.
+#
+# Library charts provide useful utilities or functions for the chart developer. They're included as
+# a dependency of application charts to inject those utilities and functions into the rendering
+# pipeline. Library charts do not define any templates and therefore cannot be deployed.
+type: application
+
+# This is the chart version. This version number should be incremented each time you make changes
+# to the chart and its templates, including the app version.
+# Versions are expected to follow Semantic Versioning (https://semver.org/)
+version: 0.8.0
+
+# This is the version number of the application being deployed. This version number should be
+# incremented each time you make changes to the application. Versions are not expected to
+# follow Semantic Versioning. They should reflect the version the application is using.
+# It is recommended to use it with quotes.
+appVersion: "2.5.8"
+home: https://www.isc.org/kea/
+icon: https://raw.githubusercontent.com/isc-projects/kea/3eee114614162b087e415e0a6ce1057d422c8174/doc/images/kea-logo-100x70.png
+maintainers:
+  - name: Mark Glants
+    email: m@gearage.ru
+annotations:
+  artifacthub.io/changes: |
+    - kind: changed
+      description: allow to use custom interface

charts/kea-dhcp/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Jack Maloney
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

charts/kea-dhcp/README.md

@@ -0,0 +1,7 @@
+# kea-dhcp
+
+This is a Helm chart adapted from https://github.com/Turgon37/mglants-charts/tree/main
+
+Credits:
+- original chart https://github.com/mglants/charts
+- Turgon37's fixes - https://github.com/Turgon37/mglants-charts/tree/main

charts/kea-dhcp/README.md.gotmpl

@@ -0,0 +1,161 @@
+{{- define "custom.repository.organization" -}}
+mglants
+{{- end -}}
+
+{{- define "custom.repository.url" -}}
+https://github.com/MGlants/charts
+{{- end -}}
+
+{{- define "custom.helm.url" -}}
+http://charts.glants.xyz
+{{- end -}}
+
+{{- define "custom.helm.path" -}}
+{{ template "custom.repository.organization" . }}/{{ template "chart.name" . }}
+{{- end -}}
+
+{{- define "custom.notes" -}}
+**This chart is not maintained by the upstream project and any issues with the chart should be raised [here](https://github.com/MGlants/charts/issues/new/choose)**
+**More than 1 replicas is not supported by now**
+{{- end -}}
+
+{{- define "custom.requirements" -}}
+## Requirements
+
+{{ template "chart.kubeVersionLine" . }}
+{{- end -}}
+
+{{- define "custom.dependencies" -}}
+## Dependencies
+
+{{ template "chart.requirementsTable" . }}
+{{- end -}}
+
+{{- define "custom.install.tldr" -}}
+## TL;DR
+
+```console
+helm repo add {{ template "custom.repository.organization" . }} {{ template "custom.helm.url" . }}
+helm repo update
+helm install {{ template "chart.name" . }} {{ template "custom.helm.path" . }}
+```
+{{- end -}}
+
+{{- define "custom.install" -}}
+## Installing the Chart
+
+To install the chart with the release name `{{ template "chart.name" . }}`
+
+```console
+helm install {{ template "chart.name" . }} {{ template "custom.helm.path" . }}
+```
+{{- end -}}
+
+{{- define "custom.uninstall" -}}
+## Uninstalling the Chart
+
+To uninstall the `{{ template "chart.name" . }}` deployment
+
+```console
+helm uninstall {{ template "chart.name" . }}
+```
+
+The command removes all the Kubernetes components associated with the chart **including persistent volumes** and deletes the release.
+{{- end -}}
+
+{{- define "custom.configuration.header" -}}
+## Configuration
+{{- end -}}
+
+{{- define "custom.configuration.readValues" -}}
+Read through the [values.yaml](./values.yaml) file. It has several commented out suggested values.
+{{- end -}}
+
+{{- define "custom.configuration.example.set" -}}
+Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`.
+
+```console
+helm install {{ template "chart.name" . }} \
+  --set env.TZ="America/New York" \
+    {{ template "custom.helm.path" . }}
+```
+{{- end -}}
+
+{{- define "custom.configuration.example.file" -}}
+Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart.
+
+```console
+helm install {{ template "chart.name" . }} {{ template "custom.helm.path" . }} -f values.yaml
+```
+{{- end -}}
+
+{{- define "custom.valuesSection" -}}
+## Values
+
+{{ template "chart.valuesTable" . }}
+{{- end -}}
+
+{{- define "custom.changelog" -}}
+{{ $changeTypes := list "added" "changed" "fixed" }}
+## Changelog
+
+### Version {{ template "chart.version" . }}
+
+{{ range $changeType := $changeTypes }}
+  {{- with (index $.Annotations "artifacthub.io/changes") }}
+    {{- print "#### " ($changeType | title)  | nindent 0  }}
+    {{- print "" | nindent 0  }}
+    {{- $changesFound := false }}
+    {{- range (print "changes:\n" . | fromYaml).changes }}
+      {{- if eq .kind $changeType }}
+        {{- print "* " .description  | nindent 0 }}
+        {{- $changesFound = true }}
+      {{- end }}
+    {{- end }}
+    {{- if not $changesFound }}
+      {{- print "N/A" | nindent 0 }}
+    {{- end }}
+    {{- print "" | nindent 0  }}
+  {{- end }}
+{{- end }}
+
+### Older versions
+
+A historical overview of changes can be found on [ArtifactHUB](https://artifacthub.io/packages/helm/mglants/{{- template "chart.name" . }}?modal=changelog)
+
+{{- end -}}
+
+{{ template "chart.header" . }}
+
+{{ template "chart.versionBadge" . }}{{ template "chart.typeBadge" . }}{{ template "chart.appVersionBadge" . }}
+
+{{ template "chart.description" . }}
+
+{{ template "custom.notes" . }}
+
+{{ template "chart.sourcesSection" . }}
+
+{{ template "custom.requirements" . }}
+
+{{ template "custom.dependencies" . }}
+
+{{ template "custom.install.tldr" . }}
+
+{{ template "custom.install" . }}
+
+{{ template "custom.uninstall" . }}
+
+{{ template "custom.configuration.header" . }}
+
+{{ template "custom.configuration.readValues" . }}
+
+{{ template "custom.configuration.example.set" . }}
+
+{{ template "custom.configuration.example.file" . }}
+
+{{ template "custom.valuesSection" . }}
+
+{{ template "custom.changelog" . }}
+
+{{ template "helm-docs.versionFooter" . }}
+{{ "" }}