Files
devops-lib-gcp/vars/homelabPipeline.groovy
T
Mukul Sharma 51d3a0a033 Fix env.FAILURE NPE and buildx read-only-mount failure
Build #5 got through checkout, loadConfig, and the pre_build hook,
then hit two real bugs at the actual docker build step:

1. `docker build` failed with "mkdir /root/.docker/buildx: read-only
   file system" — dind-pod.yaml mounts the Harbor push-auth secret
   read-only at /root/.docker, but modern docker defaults to
   BuildKit/buildx, which wants to write its own state there. Forces
   the classic builder via DOCKER_BUILDKIT=0 instead.

2. The subsequent error-handling itself then threw a
   NullPointerException — every stage file (including untouched
   legacy ones from the real devops-lib) reads env.FAILURE when
   setting currentBuild.result, but nothing in this repo ever defined
   it, so it was null. Defined once in homelabPipeline.groovy rather
   than touching 40+ individual occurrences across every stage file.
2026-09-02 16:17:56 +05:30

72 lines
3.7 KiB
Groovy

// New entry point — the homelab equivalent of the real devops-lib's
// buildPipeline.groovy. Same shape: a scripted pipeline global, so a
// service Jenkinsfile needs nothing but `@Library('devops-lib') _` plus
// one call to this — no pipeline{}/agent{}/stages{} block in the
// consuming repo at all, matching gkeCICD.groovy's Podcall precedent
// (podTemplate { node(POD_LABEL) { ... } }) rather than the declarative
// style the earlier version of this Jenkinsfile template used.
//
// Only repo_name is required — everything else defaults sensibly for a
// single-service repo on this one homelab cluster. Override any key by
// passing it explicitly, same as the real buildPipeline's param map, or
// by committing a config.yaml to the repo root (loadConfig merges it in
// after checkout — repo-committed values win over these defaults, same
// as the real system's config.yaml).
//
// dockerBuildVersion (e.g. 'go-1.22', 'node-20', 'python-3.12', 'java-21',
// 'php-8.3') is read by buildDocker.groovy only when the repo has no
// Dockerfile of its own — it picks which resources/com/homelab/<lang>-
// Dockerfile template to render and which base-image version to bake in.
// Repos that already ship a Dockerfile (like demo-go-app) never touch
// this key at all; it has no default because there's no sensible one to
// fall back to.
def call(Map config) {
config.service_name = config.service_name ?: config.repo_name
config.argo_app_name = config.argo_app_name ?: config.repo_name
config.harbor_project = config.harbor_project ?: 'homelab'
config.helm_repo_url = config.helm_repo_url ?: 'http://gitea.192.168.1.7.nip.io/mukul/devops-helm-charts.git'
config.image_tag_yq_path = config.image_tag_yq_path ?: '.deployment.image.tag'
// Every stage file (both the ones adapted for this homelab and the
// untouched legacy ones carried over from the real devops-lib) reads
// `env.FAILURE` when setting currentBuild.result on error — the real
// system must define this as a global Jenkins environment variable
// somewhere upstream of buildPipeline.groovy, since it's referenced
// everywhere but never set anywhere in this repo. Left undefined,
// `env.FAILURE` is null, and `currentBuild.result = null` throws
// `NoSuchMethodError`/`NullPointerException` deep inside Jenkins'
// own result-normalization code — masking whatever the real error
// was. Defining it once here, before any stage runs, is the minimal
// fix rather than touching every individual stage file.
env.FAILURE = 'FAILURE'
podTemplate(yaml: libraryResource('org/homelab/dind-pod.yaml')) {
node(POD_LABEL) {
def checkOutObj = new com.homelab.stages.checkOut()
def loadConfigObj = new com.homelab.stages.loadConfig()
def runHooksObj = new com.homelab.stages.runHooks()
def buildDockerObj = new com.homelab.stages.buildDocker()
def updateHelmTagObj = new com.homelab.stages.updateHelmTag()
def syncArgoAppObj = new com.homelab.stages.syncArgoApp()
def notifyObj = new com.homelab.stages.notify()
try {
checkOutObj.run(config)
loadConfigObj.run(config)
runHooksObj.run(config, 'pre_build')
buildDockerObj.run(config)
runHooksObj.run(config, 'post_build')
updateHelmTagObj.run(config)
syncArgoAppObj.run(config)
}
catch (Exception e) {
currentBuild.result = 'FAILURE'
log.error(e.toString())
}
finally {
notifyObj.run(config)
}
}
}
}