name: CI/CD (dev on branch, prod on tag) on: push: branches: - dev # build & deploy for dev only tags: - "*" # build & deploy for prod only when a tag is pushed jobs: setup: # Gitea Actions: runners are selected by label only (no runner groups). runs-on: ubuntu-latest outputs: matrix: ${{ steps.pick.outputs.matrix }} steps: - name: Pick matrix config from ref type id: pick shell: bash run: | if [[ "${{ github.ref_type }}" == "tag" ]]; then echo 'matrix={"include":[{"env":"prod","image_name_server":"it-cost-dashboard-server-prod","image_name_db":"it-cost-dashboard-db-prod","latest_tag":"latest-prod","release":"it-cost-dashboard-prod","namespace":"it-cost-dashboard-prod","chart":"./helm","values_file":"./helm/values-prod.yaml"}]}' >> "$GITHUB_OUTPUT" else echo 'matrix={"include":[{"env":"dev","image_name_server":"it-cost-dashboard-server-dev","image_name_db":"it-cost-dashboard-db-dev","latest_tag":"latest-dev","release":"it-cost-dashboard-dev","namespace":"it-cost-dashboard-dev","chart":"./helm","values_file":"./helm/values-dev.yaml"}]}' >> "$GITHUB_OUTPUT" fi build-and-deploy: needs: setup runs-on: ubuntu-latest strategy: matrix: ${{ fromJSON(needs.setup.outputs.matrix) }} # Per-environment group: a dev push must never cancel an in-flight prod # deploy (the original used a hardcoded "prod" group for both refs). concurrency: group: deploy-${{ matrix.env }} cancel-in-progress: true env: # Harbor on the Mac mini host. The runner pod mounts the Docker Desktop # daemon socket, so from the daemon's point of view the registry is # reachable as host.docker.internal:8080 (plain HTTP — the daemon must # list it under "insecure-registries"). Images live in Harbor's # "library" project. REGISTRY: host.docker.internal:8080/library DOCKER_BUILDKIT: "1" COMPOSE_DOCKER_CLI_BUILD: "1" steps: - name: Checkout (with tags) uses: actions/checkout@v4 with: fetch-depth: 0 # IMPORTANT to access tags - name: Verify tag is on prod branch (main) id: guard if: github.ref_type == 'tag' shell: bash run: | git fetch origin main --quiet if git merge-base --is-ancestor "${{ github.sha }}" origin/main; then echo "Tag commit is on main. Proceeding with prod deploy." else echo "::error::Tag ${GITHUB_REF#refs/tags/} points at a commit not on main. Refusing prod deploy." exit 1 fi - name: Set up kubeconfig run: | echo "KUBECONFIG=${RUNNER_TEMP}/kubeconfig" >> "$GITHUB_ENV" echo "${{ secrets.KUBE_CONFIG_DATA }}" | base64 -d > "${RUNNER_TEMP}/kubeconfig" chmod 600 "${RUNNER_TEMP}/kubeconfig" - name: Login to Harbor run: | # REGISTRY is host/project but `docker login` takes only the host. REGISTRY_HOST=$(echo "${REGISTRY}" | cut -d'/' -f1) echo "Logging in to ${REGISTRY_HOST}" echo "${{ secrets.HARBOR_PASSWORD }}" | docker login "${REGISTRY_HOST}" \ -u "${{ secrets.HARBOR_USERNAME }}" \ --password-stdin - name: Determine ref type and release tag id: refinfo shell: bash run: | echo "GITHUB_REF=${GITHUB_REF}" echo "GITHUB_REF_TYPE=${GITHUB_REF_TYPE:-${{ github.ref_type }}}" if [[ "${{ github.ref_type }}" == "tag" ]]; then echo "ref_type=tag" >> $GITHUB_OUTPUT echo "release_tag=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT elif [[ "${{ github.ref_type }}" == "branch" ]]; then echo "ref_type=branch" >> $GITHUB_OUTPUT echo "release_tag=" >> $GITHUB_OUTPUT else echo "ref_type=unknown" >> $GITHUB_OUTPUT echo "release_tag=" >> $GITHUB_OUTPUT fi - name: Pre-build diagnostics run: | echo "Ref: ${GITHUB_REF}" echo "Ref type: ${{ steps.refinfo.outputs.ref_type }}" echo "Release tag: ${{ steps.refinfo.outputs.release_tag }}" echo "Environment: ${{ matrix.env }}" echo "Server image: ${REGISTRY}/${{ matrix.image_name_server }}" echo "DB image: ${REGISTRY}/${{ matrix.image_name_db }}" docker version helm version kubectl version --client - name: Build & Push server image run: | REF_TYPE="${{ steps.refinfo.outputs.ref_type }}" RELEASE_TAG="${{ steps.refinfo.outputs.release_tag }}" IMAGE="${REGISTRY}/${{ matrix.image_name_server }}" BUILD_TAG_ARGS=( -t "${IMAGE}:${{ matrix.latest_tag }}" -t "${IMAGE}:${{ github.sha }}" ) if [[ "${REF_TYPE}" == "tag" && -n "${RELEASE_TAG}" ]]; then BUILD_TAG_ARGS+=( -t "${IMAGE}:${RELEASE_TAG}" ) fi # AUTH_SECRET is build-time only (Auth.js v5 initializes NextAuth() at # module load during `next build`). The real secret comes from k8s. docker build \ -f Dockerfile \ --build-arg AUTH_SECRET=build-placeholder-not-used-at-runtime \ "${BUILD_TAG_ARGS[@]}" \ . docker push "${IMAGE}:${{ matrix.latest_tag }}" docker push "${IMAGE}:${{ github.sha }}" if [[ "${REF_TYPE}" == "tag" && -n "${RELEASE_TAG}" ]]; then docker push "${IMAGE}:${RELEASE_TAG}" fi - name: Build & Push db image run: | REF_TYPE="${{ steps.refinfo.outputs.ref_type }}" RELEASE_TAG="${{ steps.refinfo.outputs.release_tag }}" IMAGE="${REGISTRY}/${{ matrix.image_name_db }}" BUILD_TAG_ARGS=( -t "${IMAGE}:${{ matrix.latest_tag }}" -t "${IMAGE}:${{ github.sha }}" ) if [[ "${REF_TYPE}" == "tag" && -n "${RELEASE_TAG}" ]]; then BUILD_TAG_ARGS+=( -t "${IMAGE}:${RELEASE_TAG}" ) fi docker build \ -f Dockerfile.db \ "${BUILD_TAG_ARGS[@]}" \ . docker push "${IMAGE}:${{ matrix.latest_tag }}" docker push "${IMAGE}:${{ github.sha }}" if [[ "${REF_TYPE}" == "tag" && -n "${RELEASE_TAG}" ]]; then docker push "${IMAGE}:${RELEASE_TAG}" fi - name: Ensure namespace exists run: | # `helm --atomic` against a missing namespace fails outright. kubectl create namespace "${{ matrix.namespace }}" \ --dry-run=client -o yaml | kubectl apply -f - # The kubelet pulls through the same Docker Desktop daemon that built the # image, so the pull server must match the push host exactly # (host.docker.internal:8080). - name: Ensure Harbor pull secret exists run: | kubectl create secret docker-registry harbor-pull-secret \ --docker-server="$(echo "${REGISTRY}" | cut -d'/' -f1)" \ --docker-username="${{ secrets.HARBOR_USERNAME }}" \ --docker-password="${{ secrets.HARBOR_PASSWORD }}" \ --namespace "${{ matrix.namespace }}" \ --dry-run=client -o yaml | kubectl apply -f - # ---- DEV DEPLOY (branch dev only) ---- # Deployed by commit SHA, not latest-dev: an immutable tag sidesteps the # moving-tag + IfNotPresent stale-cache trap and makes `kubectl describe # pod` show exactly which commit is live. - name: Deploy DEV with Helm if: github.ref_type == 'branch' && github.ref == 'refs/heads/dev' run: | kubectl get nodes kubectl get ns helm upgrade --install "${{ matrix.release }}" "${{ matrix.chart }}" \ -f "${{ matrix.values_file }}" \ --namespace "${{ matrix.namespace }}" \ --set server.image.repository="${REGISTRY}/${{ matrix.image_name_server }}" \ --set server.image.tag="${{ github.sha }}" \ --set db.image.repository="${REGISTRY}/${{ matrix.image_name_db }}" \ --set db.image.tag="${{ github.sha }}" \ --set-string secrets.authSecret="${{ secrets.AUTH_SECRET_DEV }}" \ --set-string secrets.dbRootPassword="${{ secrets.DB_PASSWORD_DEV }}" \ --set-string secrets.localAdminPassword="${{ secrets.LOCAL_ADMIN_PASSWORD_DEV }}" \ --wait --timeout 10m --atomic --debug # ---- PROD DEPLOY (tag push only) ---- - name: Deploy PROD with Helm if: github.ref_type == 'tag' run: | kubectl get nodes kubectl get ns TAG="${GITHUB_REF#refs/tags/}" if [[ -z "${TAG}" ]]; then echo "No tag detected; aborting prod deploy." exit 1 fi helm upgrade --install "${{ matrix.release }}" "${{ matrix.chart }}" \ -f "${{ matrix.values_file }}" \ --namespace "${{ matrix.namespace }}" \ --set server.image.repository="${REGISTRY}/${{ matrix.image_name_server }}" \ --set server.image.tag="${TAG}" \ --set db.image.repository="${REGISTRY}/${{ matrix.image_name_db }}" \ --set db.image.tag="${TAG}" \ --set-string secrets.authSecret="${{ secrets.AUTH_SECRET_PROD }}" \ --set-string secrets.dbRootPassword="${{ secrets.DB_PASSWORD_PROD }}" \ --set-string secrets.localAdminPassword="${{ secrets.LOCAL_ADMIN_PASSWORD_PROD }}" \ --wait --timeout 10m --atomic --debug # Strictly redundant with immutable image tags: Helm already rolled the # pods and --atomic already verified health. Retained as belt-and-braces. # Scoped to component=server so it does not bounce MySQL every push. - name: Rollout restart (server only) if: success() && (github.ref_type == 'branch' || github.ref_type == 'tag') run: | kubectl rollout restart deployment \ -l "app.kubernetes.io/instance=${{ matrix.release }},app.kubernetes.io/component=server" \ -n "${{ matrix.namespace }}" - name: Post-deploy diagnostics (if failure) if: failure() run: | echo "----- Diagnostics -----" kubectl get deploy,sts,po,svc,ing -n "${{ matrix.namespace }}" -o wide || true echo "----- PVCs (a Pending PVC = missing/wrong StorageClass; invisible in pod logs) -----" kubectl get pvc -n "${{ matrix.namespace }}" -o wide || true echo "----- Events -----" kubectl get events -n "${{ matrix.namespace }}" --sort-by=.lastTimestamp || true for p in $(kubectl get po -n "${{ matrix.namespace }}" -o name); do echo "### $p" kubectl describe "$p" -n "${{ matrix.namespace }}" || true kubectl logs "$p" -n "${{ matrix.namespace }}" --all-containers --tail=200 || true done