refactor(docs-portal): migrar a base+overlay de platform-templates

Reemplaza los manifiestos sueltos (deployment/service/ingress) por un
overlay de Kustomize sobre el base remoto de platform-templates. Agrega
readinessProbe/livenessProbe (no tenia ninguna) y securityContext
(ajustado: runAsNonRoot=false + NET_BIND_SERVICE, porque la imagen
actual de docs-portal corre como root en el puerto 80 -- se resuelve
del todo cuando docs-portal adopte dockerfiles/static-nginx.Dockerfile
de platform-templates, cambio de imagen aparte). Validado con kubectl
kustomize contra el manifiesto real desplegado antes de aplicar.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_011FqYP3Wf1W63Qmh7qgXAAT

workloads/docs-portal/deployment.yaml

@@ -1,28 +0,0 @@
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: docs-portal-deployment
-spec:
-  replicas: 1
-  selector:
-    matchLabels:
-      app: docs-portal
-  template:
-    metadata:
-      labels:
-        app: docs-portal
-    spec:
-      imagePullSecrets:
-      - name: gitea-registry-secret
-      containers:
-      - name: docs-portal
-        image: gitea.cruzcloud.net/devops/docs-portal:v1.0.116
-        ports:
-        - containerPort: 80
-        resources:
-          requests:
-            cpu: 50m
-            memory: 64Mi
-          limits:
-            cpu: 200m
-            memory: 128Mi

workloads/docs-portal/ingress.yaml

@@ -1,19 +0,0 @@
-apiVersion: networking.k8s.io/v1
-kind: Ingress
-metadata:
-  name: docs-portal-ingress
-  annotations:
-    traefik.ingress.kubernetes.io/router.entrypoints: web
-spec:
-  ingressClassName: traefik
-  rules:
-  - host: docs.cruzcloud.net
-    http:
-      paths:
-      - path: /
-        pathType: Prefix
-        backend:
-          service:
-            name: docs-portal-svc
-            port:
-              number: 80

workloads/docs-portal/kustomization.yaml

@@ -1,7 +1,48 @@
 apiVersion: kustomize.config.k8s.io/v1beta1
 kind: Kustomization
+
 namespace: docs-portal
+
 resources:
-  - deployment.yaml
-  - service.yaml
-  - ingress.yaml
+  - https://gitea.cruzcloud.net/devops/platform-templates.git//k8s-manifests/base?ref=main
+
+patches:
+  - target:
+      kind: Deployment
+      name: app-deployment
+    path: patches/deployment.yaml
+  - target:
+      kind: Service
+      name: app-svc
+    path: patches/service.yaml
+  - target:
+      kind: Ingress
+      name: app-ingress
+    path: patches/ingress.yaml
+
+  - target:
+      kind: Deployment
+      name: app-deployment
+    patch: |-
+      - op: replace
+        path: /metadata/name
+        value: docs-portal-deployment
+      - op: replace
+        path: /spec/template/spec/containers/0/ports
+        value:
+          - name: http
+            containerPort: 80
+  - target:
+      kind: Service
+      name: app-svc
+    patch: |-
+      - op: replace
+        path: /metadata/name
+        value: docs-portal-svc
+  - target:
+      kind: Ingress
+      name: app-ingress
+    patch: |-
+      - op: replace
+        path: /metadata/name
+        value: docs-portal-ingress

workloads/docs-portal/patches/deployment.yaml

@@ -0,0 +1,49 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: app-deployment
+  labels:
+    app: docs-portal
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: docs-portal
+  template:
+    metadata:
+      labels:
+        app: docs-portal
+    spec:
+      # El base fuerza runAsNonRoot: true a nivel pod. La imagen ACTUAL
+      # de docs-portal (nginx:1.27-alpine, sin USER) corre como root --
+      # aplicar el default del base tal cual rompe el pod
+      # (CreateContainerConfigError). Override explícito acá hasta que
+      # docs-portal adopte dockerfiles/static-nginx.Dockerfile
+      # (nginx-unprivileged, no-root) como cambio de imagen aparte --
+      # no es parte de esta migración de manifiestos.
+      securityContext:
+        runAsNonRoot: false
+      containers:
+        - name: app
+          image: gitea.cruzcloud.net/devops/docs-portal:v1.0.116
+          # El base saca TODAS las capabilities. Corriendo como root en
+          # el puerto 80 (privilegiado), eso rompe el bind() -- incluso
+          # root necesita CAP_NET_BIND_SERVICE si se le sacan las demás.
+          # Mismo motivo que el runAsNonRoot de arriba: se resuelve del
+          # todo cuando docs-portal pase a nginx-unprivileged (puerto
+          # 8080, no privilegiado, no necesita esta capability).
+          securityContext:
+            allowPrivilegeEscalation: false
+            readOnlyRootFilesystem: false
+            capabilities:
+              drop:
+                - ALL
+              add:
+                - NET_BIND_SERVICE
+          resources:
+            requests:
+              cpu: 50m
+              memory: 64Mi
+            limits:
+              cpu: 200m
+              memory: 128Mi

workloads/docs-portal/patches/ingress.yaml

@@ -0,0 +1,16 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: app-ingress
+spec:
+  rules:
+    - host: docs.cruzcloud.net
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: docs-portal-svc
+                port:
+                  number: 80

workloads/docs-portal/patches/service.yaml

@@ -1,11 +1,11 @@
 apiVersion: v1
 kind: Service
 metadata:
-  name: docs-portal-svc
+  name: app-svc
 spec:
   selector:
     app: docs-portal
   ports:
-    - protocol: TCP
+    - name: http
       port: 80
       targetPort: 80