feat(apps): onboard semaphore (Phase 6) — second CNPG-DB + OIDC-target app

Semaphore (Ansible UI, docs/13 row 10): internal exposure, internet egress,
config on Longhorn + external PostgreSQL, auth oidc. Reuses the CNPG-DB pattern
nextcloud established (apps/nextcloud-db.yaml, commit 4be6752).

- catalog/semaphore.yaml: ServiceDefinition (schema >=1.2.0 env) wiring the
  SEMAPHORE_DB_* connection to semaphore-db-rw.semaphore-db:5432, break-glass
  SEMAPHORE_ADMIN* local admin, and the FIXED base64 SEMAPHORE_ACCESS_KEY_ENCRYPTION.
- apps/semaphore.yaml: rendered (render.py --no-image-automation) — Deployment,
  config PVC, Service, default-deny + egress/gateway/internet CNPs, HTTPRoute
  semaphore.home.keithjackson.dev:3000, ServiceMonitor, SLI alert.
- apps/semaphore-db.yaml: CNPG Cluster in dedicated ns semaphore-db, initdb from
  the owner secret, inheritedMetadata app.kubernetes.io/name=semaphore-db so the
  dep-edge egress CNP matches.
- apps/semaphore-db-app.sops.yaml + apps/semaphore-bootstrap-secret.sops.yaml:
  SOPS(age) owner creds (basic-auth) + mirrored db-password, break-glass admin,
  and the persistent access-key encryption key.

OIDC (Keycloak realm client) is DEFERRED like gitea/nextcloud — comes up on the
break-glass local admin; realm-client wiring is the batched follow-up.

Co-Authored-By: Claude Opus 4.8 <[email protected]>

apps/semaphore.yaml

@@ -0,0 +1,269 @@
+---
+# Namespace (trust zone; default-deny + policies apply)
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: semaphore
+  labels:
+    homelab.keithjackson.dev/app-namespace: 'true'
+    gateway-access: shared
+  annotations:
+    homelab.keithjackson.dev/backup-policy: daily-offcluster
+---
+# Default-deny baseline (R-NET-01): deny all, allow only DNS
+apiVersion: networking.k8s.io/v1
+kind: NetworkPolicy
+metadata:
+  name: default-deny
+  namespace: semaphore
+  labels:
+    homelab.keithjackson.dev/baseline: default-deny
+spec:
+  podSelector: {}
+  policyTypes:
+  - Ingress
+  - Egress
+  ingress: []
+  egress:
+  - to:
+    - namespaceSelector:
+        matchLabels:
+          kubernetes.io/metadata.name: kube-system
+    ports:
+    - protocol: UDP
+      port: 53
+    - protocol: TCP
+      port: 53
+---
+# PVC semaphore-config (R-STATE)
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: semaphore-config
+  namespace: semaphore
+  labels:
+    app.kubernetes.io/name: semaphore
+spec:
+  accessModes:
+  - ReadWriteOnce
+  storageClassName: longhorn
+  resources:
+    requests:
+      storage: 1Gi
+---
+# Deployment (R-PLAT-02)
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: semaphore
+  namespace: semaphore
+  labels:
+    app.kubernetes.io/name: semaphore
+spec:
+  replicas: 1
+  strategy:
+    type: Recreate
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: semaphore
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: semaphore
+        homelab.keithjackson.dev/egress-class: internet
+        homelab.keithjackson.dev/auth-mode: oidc
+      annotations:
+        homelab.keithjackson.dev/auth-mode: oidc
+        homelab.keithjackson.dev/auth-groups: platform-admins
+    spec:
+      containers:
+      - name: semaphore
+        image: semaphoreui/semaphore:v2.19.10
+        ports:
+        - containerPort: 3000
+        env:
+        - name: SEMAPHORE_DB_DIALECT
+          value: postgres
+        - name: SEMAPHORE_DB_HOST
+          value: semaphore-db-rw.semaphore-db.svc.cluster.local
+        - name: SEMAPHORE_DB_PORT
+          value: '5432'
+        - name: SEMAPHORE_DB
+          value: semaphore
+        - name: SEMAPHORE_DB_USER
+          value: semaphore
+        - name: SEMAPHORE_DB_PASS
+          valueFrom:
+            secretKeyRef:
+              name: semaphore-bootstrap
+              key: db-password
+        - name: SEMAPHORE_ADMIN
+          valueFrom:
+            secretKeyRef:
+              name: semaphore-bootstrap
+              key: admin-username
+        - name: SEMAPHORE_ADMIN_PASSWORD
+          valueFrom:
+            secretKeyRef:
+              name: semaphore-bootstrap
+              key: admin-password
+        - name: SEMAPHORE_ADMIN_NAME
+          value: Semaphore Admin
+        - name: SEMAPHORE_ADMIN_EMAIL
+          value: [email protected]
+        - name: SEMAPHORE_ACCESS_KEY_ENCRYPTION
+          valueFrom:
+            secretKeyRef:
+              name: semaphore-bootstrap
+              key: access-key-encryption
+        volumeMounts:
+        - name: config
+          mountPath: /etc/semaphore
+      volumes:
+      - name: config
+        persistentVolumeClaim:
+          claimName: semaphore-config
+---
+# Service
+apiVersion: v1
+kind: Service
+metadata:
+  name: semaphore
+  namespace: semaphore
+  labels:
+    app.kubernetes.io/name: semaphore
+spec:
+  selector:
+    app.kubernetes.io/name: semaphore
+  ports:
+  - name: port-3000
+    port: 3000
+    targetPort: 3000
+---
+# CiliumNetworkPolicy egress allow (R-NET-02): semaphore-allow-semaphore-db-5432
+apiVersion: cilium.io/v2
+kind: CiliumNetworkPolicy
+metadata:
+  name: semaphore-allow-semaphore-db-5432
+  namespace: semaphore
+  labels:
+    app.kubernetes.io/name: semaphore
+spec:
+  endpointSelector:
+    matchLabels:
+      app.kubernetes.io/name: semaphore
+  egress:
+  - toEndpoints:
+    - matchLabels:
+        app.kubernetes.io/name: semaphore-db
+        k8s:io.kubernetes.pod.namespace: semaphore-db
+    toPorts:
+    - ports:
+      - port: '5432'
+        protocol: TCP
+---
+# CiliumNetworkPolicy gateway-ingress allow (R-NET-01/02): semaphore-allow-gateway-ingress
+apiVersion: cilium.io/v2
+kind: CiliumNetworkPolicy
+metadata:
+  name: semaphore-allow-gateway-ingress
+  namespace: semaphore
+  labels:
+    app.kubernetes.io/name: semaphore
+spec:
+  endpointSelector:
+    matchLabels:
+      app.kubernetes.io/name: semaphore
+  ingress:
+  - fromEntities:
+    - ingress
+    toPorts:
+    - ports:
+      - port: '3000'
+        protocol: TCP
+---
+# CiliumNetworkPolicy world egress allow (egress class governs the path; R-NET-05): semaphore-allow-internet-egress
+apiVersion: cilium.io/v2
+kind: CiliumNetworkPolicy
+metadata:
+  name: semaphore-allow-internet-egress
+  namespace: semaphore
+  labels:
+    app.kubernetes.io/name: semaphore
+spec:
+  endpointSelector:
+    matchLabels:
+      app.kubernetes.io/name: semaphore
+  egress:
+  - toEntities:
+    - world
+---
+# HTTPRoute semaphore-3000 (R-TLS/R-DNS)
+apiVersion: gateway.networking.k8s.io/v1
+kind: HTTPRoute
+metadata:
+  name: semaphore-3000
+  namespace: semaphore
+  labels:
+    app.kubernetes.io/name: semaphore
+  annotations:
+    homelab.keithjackson.dev/auth-mode: oidc
+    homelab.keithjackson.dev/auth-groups: platform-admins
+spec:
+  parentRefs:
+  - name: shared
+    namespace: gateway
+    sectionName: https
+  hostnames:
+  - semaphore.home.keithjackson.dev
+  rules:
+  - matches:
+    - path:
+        type: PathPrefix
+        value: /
+    backendRefs:
+    - name: semaphore
+      port: 3000
+---
+# ServiceMonitor (R-OBS-01)
+apiVersion: monitoring.coreos.com/v1
+kind: ServiceMonitor
+metadata:
+  name: semaphore
+  namespace: semaphore
+  labels:
+    release: kube-prometheus-stack
+    app.kubernetes.io/name: semaphore
+spec:
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: semaphore
+  namespaceSelector:
+    matchNames:
+    - semaphore
+  endpoints:
+  - port: metrics
+    interval: 30s
+---
+# PrometheusRule SLI alerts (R-OBS-01)
+apiVersion: monitoring.coreos.com/v1
+kind: PrometheusRule
+metadata:
+  name: semaphore-slis
+  namespace: semaphore
+  labels:
+    release: kube-prometheus-stack
+    app.kubernetes.io/name: semaphore
+spec:
+  groups:
+  - name: semaphore.slis
+    rules:
+    - alert: semaphore-down
+      expr: up{job="semaphore"} == 0
+      for: 5m
+      labels:
+        severity: critical
+        service: semaphore
+      annotations:
+        summary: semaphore is down
+        description: 'semaphore has been unreachable for 5m (SLI: up).'