Implementar un Pipeline GitHub Actions con SAST, DAST y Deploy GitOps en Kubernetes
Introducción
En la era de la entrega continua, la seguridad debe ser parte integral del proceso de desarrollo. GitHub Actions permite orquestar pipelines completos, integrando análisis estático de código (SAST), pruebas dinámicas (DAST) y despliegue en Kubernetes con GitOps. Este artículo detalla cómo construir un pipeline reproducible, explicar la lógica detrás de cada paso y solucionar errores comunes.
1. Estructura del Pipeline
1.1. Arquitectura general
La arquitectura se divide en tres etapas principales:
- Build & Test: Compilar, ejecutar pruebas unitarias y generar artefactos.
- Security Scan: SAST con
semgrepy DAST conOWASP ZAP. - Deploy GitOps: GitOps con
Argo CDque observa cambios enkustomizey actualiza clústeres.
1.2. Archivos de configuración
Se requieren los siguientes archivos en el repositorio:
.github/workflows/ci-cd.yml– definición de workflow.- Directorios
k8s/con archivoskustomization.yaml, manifests y overlays. - Archivo
Dockerfileydocker-compose.ymlpara la aplicación. - Archivo
zap-baseline.yamlque describe la política de DAST.
2. Configuración de GitHub Actions
2.1. Definición del workflow
El siguiente bloque crea un workflow que se dispara en push y pull_request en la rama main:
name: CI/CD Pipelineon: push: branches: [ main ] pull_request: branches: [ main ]
env: DOCKER_REGISTRY: ghcr.io IMAGE_NAME: ${{ github.repository }}
jobs: build: runs-on: ubuntu-latest outputs: image: ${{ steps.build.outputs.image }} steps: - uses: actions/checkout@v3
- name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Login to GHCR uses: docker/login-action@v3 with: registry: ${{ env.DOCKER_REGISTRY }} username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Build and push image id: build uses: docker/build-push-action@v5 with: context: . push: true tags: ${{ env.DOCKER_REGISTRY }}/${{ env.IMAGE_NAME }}:latest
2.2. Análisis SAST
Se emplea semgrep para detectar vulnerabilidades de código:
sast: runs-on: ubuntu-latest needs: build steps: - uses: actions/checkout@v3- name: Install Semgrep run: pip install semgrep - name: Run Semgrep run: semgrep ci env: SEMGREP_RULES: p/py3
2.3. DAST con OWASP ZAP
El análisis dinámico se ejecuta contra la aplicación en un contenedor aislado:
dast: runs-on: ubuntu-latest needs: build steps: - uses: actions/checkout@v3- name: Start the service run: docker compose up -d - name: Run ZAP Baseline uses: zaproxy/action-full-scan@v0.10.0 with: target: http://localhost:8080 rules-file: zap-baseline.yaml - name: Stop the service run: docker compose down
2.4. Despliegue GitOps con Argo CD
Una vez que los escaneos pasan, la imagen se etiqueta y se actualiza el manifiesto Kubernetes.
deploy: runs-on: ubuntu-latest needs: [build, sast, dast] steps: - uses: actions/checkout@v3- name: Update image tag in kustomization run: | sed -i "s|image: .*|image: ${{ env.DOCKER_REGISTRY }}/${{ env.IMAGE_NAME }}:latest|" k8s/base/kustomization.yaml - name: Commit changes run: | git config user.name "github-actions" git config user.email "github-actions@github.com" git add k8s/base/kustomization.yaml git commit -m "Bump image to latest" git push origin HEAD:main
Argo CD monitorea main y aplica automáticamente la nueva versión.
3. Configuración de Argo CD y GitOps
3.1. Instalación de Argo CD
En el clúster Kubernetes:
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
Acceder al UI:
kubectl port-forward svc/argocd-server -n argocd 8080:443
3.2. Configurar el App de Argo CD
Crear argocd-app.yaml:
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: myapp
namespace: argocd
spec:
project: default
source:
repoURL: 'https://github.com/<usuario>/<repo>'
targetRevision: main
path: k8s/base
destination:
server: 'https://kubernetes.default.svc'
namespace: myapp
syncPolicy:
automated:
prune: true
selfHeal: true
Este manifiesto hace que Argo CD sincronice k8s/base con el clúster.
4. Troubleshooting
4.1. Error: semgrep: command not found
Usar actions/setup-python@v4 antes de instalar semgrep:
- uses: actions/setup-python@v4
with:
python-version: '3.10'
4.2. DAST fallando con timeout
Incrementar el tiempo de espera en el job DAST:
timeout-minutes: 20
4.3. Argo CD no actualiza el despliegue
Verificar que el manifiesto image esté correctamente actualizado y que el repo tenga permisos de lectura.
4.4. Docker push rechazado por GHCR
Confirmar que el GITHUB_TOKEN tenga permiso write:packages en Settings > Actions > General.
Conclusión
Con GitHub Actions, SAST, DAST y GitOps de Argo CD se logra un pipeline completo que garantiza la calidad, seguridad y disponibilidad de la aplicación. La automatización reduce la exposición a errores humanos y acelera el feedback del equipo de desarrollo. Implementar estos pasos en tu flujo de trabajo fortalecerá la postura de seguridad y optimizará la entrega continua en Kubernetes.