Jenkins su Kubernetes: Pipeline as Code con Jenkinsfile e Integrazione ArgoCD

🧰 Materiali necessari

• Cluster Kubernetes 1.28+ con risorse adeguate
• Jenkins Helm chart 5.0+
• Helm 3.14+
• ArgoCD 2.10+ per CD integration
• Repository Git per application code e config separati
• HashiCorp Vault per secret management avanzato
• SonarQube per code quality
• Trivy per image scanning
• Docker registry Harbor, GHCR, o Docker Hub
• Slack workspace per notification
• Prometheus e Grafana per Jenkins monitoring
• Velero per backup PV
• Maven o Node.js per sample application
• cert-manager per TLS certificate automatico

📋 Passi

1. 1
   Installazione Jenkins su Kubernetes con Helm
   {"step":1,"title":"Installazione Jenkins su Kubernetes con Helm","description":"Crea namespace dedicato: kubectl create namespace jenkins. Aggiungi Helm repo jenkins e aggiorna. Crea file values.yaml con configurazione production: persistence size 50Gi, resources request 2 CPU e 4Gi RAM, adminPassword via secret separato. Installa con helm install jenkins jenkins\/jenkins -n jenkins -f values.yaml. Attendi pod ready con kubectl get pods -n jenkins -w. Port-forward per accesso iniziale: kubectl port-forward svc\/jenkins 8080:8080 -n jenkins."}
2. 2
   Configurazione JCasC per setup dichiarativo
   {"step":2,"title":"Configurazione JCasC per setup dichiarativo","description":"Crea ConfigMap jenkins-casc-config con jenkins.yaml dichiarativo: jenkins block con systemMessage, security con RBAC strategy, credentials con esempi GitHub token. Aggiungi a Helm values controller.JCasC.configScripts referenziando ConfigMap. Reapply Helm chart con helm upgrade. Verifica configuration applicata via UI: System Configuration mostra settings da JCasC. Committa jenkins.yaml in Git per audit e version control completo della configurazione."}
3. 3
   Setup Ingress e TLS con cert-manager
   {"step":3,"title":"Setup Ingress e TLS con cert-manager","description":"Configura Ingress per accesso esterno: in values.yaml controller.ingress.enabled true, hostName jenkins.company.com, sezione tls con secret per certificato. Se cert-manager installato nel cluster, annotation cert-manager.io\/cluster-issuer: letsencrypt-prod genera certificato automaticamente. Applica Helm upgrade. Verifica DNS A record punta a Ingress controller LoadBalancer IP. Test HTTPS access con curl verbose e verifica certificato valido."}
4. 4
   Plugin Kubernetes e agent dinamici
   {"step":4,"title":"Plugin Kubernetes e agent dinamici","description":"Verifica plugin kubernetes installato (incluso in standard Helm chart). Configura cloud Kubernetes in Manage Jenkins: kubernetes URL via service account, jenkins URL service interno al cluster. Crea ServiceAccount jenkins-agents con Role appropriato per create e delete pod. Test connection. Crea Pod Template di default con container jnlp usando image jenkins\/inbound-agent. Da Job test verifica agent pod creato e build eseguito in pod ephemeral poi distrutto."}
5. 5
   Primo Jenkinsfile dichiarativo con podTemplate
   {"step":5,"title":"Primo Jenkinsfile dichiarativo con podTemplate","description":"Crea repository sample Java con Jenkinsfile in root. Struttura: pipeline con agent kubernetes che usa YAML per podTemplate con container maven, stages con stage Build che usa container maven per mvn clean package, stage Test per mvn test, post always per pubblicare risultati junit. Configura Multibranch Pipeline job che scansiona repo e discovers branch con Jenkinsfile. Trigger build manuale o via webhook GitHub e verifica agent pod creato, results pubblicati."}
6. 6
   Pipeline complessa con multiple container
   {"step":6,"title":"Pipeline complessa con multiple container","description":"Estendi Jenkinsfile con multi-container podTemplate: container maven per build Java, container kaniko per rootless image build senza privilegi, container kubectl per deployment. Stage diverse usano container diversi tramite il blocco container(nome). Stage Build Image usa kaniko per docker build e push senza privileged mode. Stage Deploy usa kubectl per apply manifest. Verifica ogni stage esegua nel container appropriato esaminando log."}
7. 7
   Shared library per standardizzazione
   {"step":7,"title":"Shared library per standardizzazione","description":"Crea repository jenkins-shared-library con directory vars contenente file Groovy buildJavaApp.groovy che encapsula Maven build pattern standard. Definisci library in Jenkins: Manage Jenkins, System, Global Pipeline Libraries con name, default version main, retrieval method Git. Jenkinsfile usa annotazione @Library e invoca buildJavaApp come step nativo con parametri. Modifica library propaga automaticamente a tutti i consumer nel prossimo run."}
8. 8
   Credentials management e Vault integration
   {"step":8,"title":"Credentials management e Vault integration","description":"Setup credential in Jenkins: kind Secret text per GitHub PAT, kind Username\/password per Docker Hub, kind SSH key per Git server con scope folder level quando possibile. Per advanced secret management installa HashiCorp Vault plugin, configura connessione Vault con auth method approle. In Jenkinsfile usa withVault block che fetcha secret da Vault ed espone come env variable per duration del block solo. Secret mai stored in Jenkins, audit trail completo in Vault."}
9. 9
   Installazione ArgoCD per GitOps CD
   {"step":9,"title":"Installazione ArgoCD per GitOps CD","description":"Installa ArgoCD nel cluster in namespace argocd dal manifest ufficiale versione 2.10.0. Configura ArgoCD per monitorare config repository Git separato da apps-source. Crea Application per primo deployment. Setup separation of concerns fondamentale: Jenkins build image e push registry, NON deploya direttamente al cluster Kubernetes. Config repo aggiornato tramite git commit da Jenkins, ArgoCD sync automatico."}
10. 10
    Pipeline CI/CD end-to-end con ArgoCD
    {"step":10,"title":"Pipeline CI\/CD end-to-end con ArgoCD","description":"Modifica Jenkinsfile: dopo build success, stage Update Config esegue git clone del config repo, modifica image tag nel manifest con sed o yq, git commit e push con message descrittivo. Configura credential SSH per Jenkins push a config repo tramite deploy key con write access. ArgoCD detect change entro 3 minuti di polling o immediato via webhook. Verifica workflow completo: code push, Jenkins build, registry push, config update, ArgoCD sync, pod nuovo."}
11. 11
    ArgoCD API trigger per sync immediato
    {"step":11,"title":"ArgoCD API trigger per sync immediato","description":"Alternativa al polling ArgoCD: Jenkins triggera sync via API direttamente. Installa argocd CLI nel Jenkins agent container come parte del podTemplate. Stage finale esegue argocd login ARGOCD_SERVER con auth-token e argocd app sync APP_NAME --grpc-web. Token credential stored in Jenkins come Secret text. Workflow: config repo updated, sync immediato invece di attendere poll interval. Utile per development environment dove feedback rapido e prioritario."}
12. 12
    Quality gates e build con standard di qualita
    {"step":12,"title":"Quality gates e build con standard di qualita","description":"Pipeline avanzata con quality gate: stage Lint con SonarQube scan, stage Security Scan con Trivy su Docker image, stage Test con coverage threshold minimo 80%. Failure in qualsiasi stage blocca automaticamente progression della pipeline. Integration con SonarQube: results pubblicati in dashboard, breaks build se quality gate failed. Trivy scan severity CRITICAL o HIGH fails pipeline. Documenta criteri di quality gate nel repository per chiarezza."}
13. 13
    Notification e ChatOps
    {"step":13,"title":"Notification e ChatOps","description":"Setup notification Slack: installa Slack Notification plugin, configura webhook URL come credential Jenkins. In Jenkinsfile post block: failure block invia notification a canale ci-failures con job log link e autor. Success notification a canale releases per deployment completati. Implementa ChatOps con Slack slash command che triggera Jenkins job remoto via HTTP API con confirmation step per deployment critici in produzione."}
14. 14
    Monitoring Jenkins con Prometheus e Grafana
    {"step":14,"title":"Monitoring Jenkins con Prometheus e Grafana","description":"Installa Prometheus plugin Jenkins che espone metric su endpoint \/prometheus. Crea ServiceMonitor CRD per instruire Prometheus a scrapare Jenkins ad intervalli regolari. Metric esposti: jenkins_jobs_total per status, jenkins_executor_in_use, jenkins_queue_size, jenkins_node_count. Dashboard Grafana con metric chiave: build success rate, queue time trend, executor utilization. Alert su queue depth sopra 10 per 5 minuti (capacity issue) e build success rate sotto 90%."}
15. 15
    Backup e disaster recovery testing
    {"step":15,"title":"Backup e disaster recovery testing","description":"Configura Velero per backup Persistent Volume Jenkins: velero backup create jenkins-daily --include-namespaces jenkins --ttl 720h. Schedula via CronJob Kubernetes ogni notte alle 2. Sync backup a remote storage S3. Disaster recovery drill trimestrale: provision fresh cluster, installa Jenkins via Helm con stesso values.yaml, restore PV da Velero backup, verifica tutti job e configurazione ripristinata correttamente. Misura RTO e documenta procedura dettagliata in runbook."}