feat(argocd-understack): refactor deployment directory layout

This introduces three new understackctl deploy subcommands to
streamline deployment repository management. The deploy init command
creates a cluster directory with a deploy.yaml configuration file that
follows the ArgoCD Helm chart values structure, where each component
has an individual enabled flag. Component names use underscores in
the YAML to match Helm conventions. The deploy update command syncs
the filesystem by creating manifests directories for enabled
components and removing directories for disabled ones, automatically
generating kustomization.yaml and values.yaml files in each component
directory. The deploy check command validates that all required files
exist for enabled components. These commands replace the manual
directory creation and gitops-deploy.sh script workflow previously
documented.

The ArgoCD chart templates are updated to look for Helm values at
manifests/component/values.yaml instead of helm-configs/component.yaml,
consolidating all component configuration into a single manifests
directory structure. This allows Kustomize resources and Helm values
to coexist in the same component directory, simplifying the deployment
repository layout.

Documentation is updated throughout the deploy guide to use the new
understackctl commands instead of manual mkdir and file creation
steps. The gitops-deploy.sh script is deprecated with a notice
directing users to the new CLI commands. A GitHub Actions workflow
is added to run Go tests for all Go projects in the repository,
ensuring the new deploy commands remain tested in CI.

Author: cardoe

.github/workflows/go-test.yaml

@@ -0,0 +1,55 @@
+name: Go Tests
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "go/**"
+      - .github/workflows/go-test.yaml
+  pull_request:
+    paths:
+      - "go/**"
+      - .github/workflows/go-test.yaml
+  workflow_dispatch:
+  merge_group:
+    types: [checks_requested]
+    paths:
+      - "go/**"
+      - .github/workflows/go-test.yaml
+
+permissions:
+  contents: read
+
+jobs:
+  setup:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+
+      - name: List Applications
+        id: list_dirs
+        run: |
+          apps=$(ls -d go/* | xargs -n1 basename)
+          app_array=$(printf '%s\n' $apps | jq -R . | jq -cs .)
+          echo "apps=${app_array}"
+          printf "apps=%s\n" "${app_array}" >> "$GITHUB_OUTPUT"
+        shell: bash
+    outputs:
+      apps: ${{ steps.list_dirs.outputs.apps }}
+
+  test:
+    runs-on: ubuntu-latest
+    needs: setup
+    strategy:
+      matrix:
+        app: ${{ fromJson(needs.setup.outputs.apps) }}
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+
+      - uses: actions/setup-go@4dc6199c7b1a012772edbd06daecab0f50c9053c # v6
+        with:
+          go-version-file: go/${{ matrix.app }}/go.mod
+
+      - name: Test ${{ matrix.app }}
+        working-directory: go/${{ matrix.app }}
+        run: go test -v ./...

charts/argocd-understack/templates/_helpers.tpl

@@ -108,7 +108,7 @@ Examples:
   deploy_path_prefix: "us/east" -> "us/east/uc-iad3-prod"
 
 Usage in valueFiles:
-  - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/dex.yaml
+  - $deploy/{{ include "understack.deploy_path" $ }}/manifests/dex/values.yaml
 
 Usage in source path:
   path: {{ include "understack.deploy_path" $ }}/manifests/dex

charts/argocd-understack/templates/application-dex.yaml.tpl

@@ -18,7 +18,7 @@ spec:
       releaseName: dex
       valueFiles:
       - $understack/components/dex/values.yaml
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/dex.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/dex/values.yaml
     repoURL: https://charts.dexidp.io
     targetRevision: 0.16.0
   - path: components/dex

charts/argocd-understack/templates/application-envoy-configs.yaml.tpl

@@ -17,7 +17,7 @@ spec:
       ignoreMissingValueFiles: true
       valueFiles:
       - $understack/components/envoy-configs/values.yaml
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/envoy-configs.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/envoy-configs/values.yaml
     ref: understack
     repoURL: {{ include "understack.understack_url" $ }}
     targetRevision: {{ include "understack.understack_ref" $ }}

charts/argocd-understack/templates/application-envoy-gateway.yaml.tpl

@@ -18,7 +18,7 @@ spec:
       releaseName: gateway-helm
       valueFiles:
       - $understack/components/envoy-gateway/values.yaml
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/envoy-gateway.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/envoy-gateway/values.yaml
     repoURL: docker.io/envoyproxy
     targetRevision: v1.6.0
   - path: components/envoy-gateway

charts/argocd-understack/templates/application-etcdbackup.yaml.tpl

@@ -16,7 +16,7 @@ spec:
       ignoreMissingValueFiles: true
       valueFiles:
       - $understack/components/etcdbackup/values.yaml
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/etcdbackup.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/etcdbackup/values.yaml
     path: components/etcdbackup
     ref: understack
     repoURL: {{ include "understack.understack_url" $ }}

charts/argocd-understack/templates/application-external-dns.yaml.tpl

@@ -17,7 +17,7 @@ spec:
       ignoreMissingValueFiles: true
       releaseName: external-dns-rackspace
       valueFiles:
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/external-dns.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/external-dns/values.yaml
     repoURL: ghcr.io/rackerlabs/charts
     targetRevision: 0.2.0
   - path: {{ include "understack.deploy_path" $ }}/manifests/external-dns

charts/argocd-understack/templates/application-ingress-nginx.yaml.tpl

@@ -17,7 +17,7 @@ spec:
       ignoreMissingValueFiles: true
       releaseName: ingress-nginx
       valueFiles:
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/ingress-nginx.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/ingress-nginx/values.yaml
     repoURL: https://kubernetes.github.io/ingress-nginx
     targetRevision: 4.12.1
   - ref: deploy

charts/argocd-understack/templates/application-monitoring.tpl

@@ -23,7 +23,7 @@ spec:
       releaseName: kube-prometheus-stack
       valueFiles:
       - $understack/operators/monitoring/values.yaml
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/monitoring.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/monitoring/values.yaml
     repoURL: https://prometheus-community.github.io/helm-charts
     targetRevision: 79.5.0
   - path: operators/monitoring

charts/argocd-understack/templates/application-nautobot.yaml.tpl

@@ -21,7 +21,7 @@ spec:
       releaseName: nautobot
       valueFiles:
       - $understack/components/nautobot/values.yaml
-      - $deploy/{{ include "understack.deploy_path" $ }}/helm-configs/nautobot.yaml
+      - $deploy/{{ include "understack.deploy_path" $ }}/manifests/nautobot/values.yaml
     repoURL: https://nautobot.github.io/helm-charts/
     targetRevision: 2.5.6
   - path: components/nautobot