name: lpt-be Build & Deploy on: workflow_dispatch: inputs: environment: description: '部署环境(dev 仅允许 dev 分支;prod 仅允许 master/main)' required: true type: choice options: - dev - prod env: REGISTRY: 192.168.123.199:5000 APP: lpt-be REPO_URL: https://git.cat-shark.xyz/cat-shark/lpt-be.git # 仅在 runner 镜像里没有 kubectl 时才会触发下载(自定义镜像已内置) KUBECTL_VERSION: v1.32.4 jobs: build-and-deploy: runs-on: ubuntu-latest env: KUBECONFIG: /tmp/kubeconfig steps: # 2026-11-22 事故复盘:runner 以 host 模式运行(labels 带 :host), # 官方 act_runner 镜像不含 docker/curl/kubectl,导致 docker login 直接 127。 # 这里前置检查 + 自愈,缺工具就明确报错,而不是在第二步莫名其妙失败。 - name: Preflight runner toolchain run: | set -euo pipefail echo "host=$(uname -sm) uid=$(id -u)" missing() { local need="" for b in docker curl base64 git; do command -v "$b" >/dev/null 2>&1 || need="$need $b" done printf '%s' "$need" } NEED="$(missing)" if [ -n "$NEED" ]; then echo "runner 缺少工具:$NEED —— 尝试自愈安装(apk)" if command -v apk >/dev/null 2>&1 && [ "$(id -u)" = 0 ]; then apk add --no-cache docker-cli curl ca-certificates || true fi NEED="$(missing)" fi for b in docker curl kubectl git base64; do if command -v "$b" >/dev/null 2>&1; then echo "OK $b -> $(command -v "$b")" else echo "MISS $b" fi done if [ -n "$NEED" ]; then echo "" echo "ERROR: runner 缺少必需工具:$NEED" echo " 由于 labels 全为 :host,job 直接在 runner 容器内执行," echo " docker / curl / kubectl 必须存在于 runner 镜像里。" echo " 修复:docker build -f /vol1/1000/gitea/runner.Dockerfile -t lpt-runner:0.6.1-tools /vol1/1000/gitea" echo " cd /vol1/1000/gitea && docker compose up -d runner" exit 1 fi docker version --format 'docker client {{.Client.Version}} / server {{.Server.Version}}' docker info >/dev/null echo "OK docker daemon reachable" - name: Validate branch ↔ environment run: | set -euo pipefail REF="${{ gitea.ref }}" BRANCH="${REF#refs/heads/}" if [[ "$REF" == refs/tags/* ]]; then echo "ERROR: 请从分支触发部署,不要用 tag。当前 ref=$REF" exit 1 fi ENV="${{ inputs.environment }}" echo "branch=$BRANCH environment=$ENV sha=${{ gitea.sha }}" case "$ENV" in prod) case "$BRANCH" in master|main) echo "OK: prod 允许从 $BRANCH 部署" ;; *) echo "ERROR: prod 只能从 master/main 部署,当前分支是 '$BRANCH'" echo "请切换到 master 后再 Run workflow,并选择 environment=prod" exit 1 ;; esac ;; dev) case "$BRANCH" in dev) echo "OK: dev 允许从 $BRANCH 部署" ;; *) echo "ERROR: dev 只能从 dev 分支部署,当前分支是 '$BRANCH'" echo "请切换到 dev 后再 Run workflow,并选择 environment=dev" echo "(禁止用 master 代码部署到 lpt-dev,避免环境错配)" exit 1 ;; esac ;; *) echo "ERROR: 未知 environment=$ENV" exit 1 ;; esac - name: Checkout code run: | set -euo pipefail SHA="${{ gitea.sha }}" # 优先只取目标提交(省 10s+);服务器不支持任意 SHA 时回退完整克隆 if ! { git init -q . && git remote add origin "$REPO_URL" \ && git fetch -q --depth 1 origin "$SHA" && git checkout -q FETCH_HEAD; } 2>/dev/null; then echo "浅拉取失败,回退完整克隆" rm -rf .git git clone -q "$REPO_URL" . git checkout -q "$SHA" fi echo "checked out $(git rev-parse HEAD)" test "$(git rev-parse HEAD)" = "$SHA" - name: Login to Docker Registry run: | set -euo pipefail echo "${{ secrets.REGISTRY_PASSWORD }}" | docker login "$REGISTRY" -u "${{ secrets.REGISTRY_USERNAME }}" --password-stdin - name: Build & Push Docker image run: | set -euo pipefail ENV="${{ inputs.environment }}" TAG="${{ gitea.sha }}-$(date +%s)" echo "Building $REGISTRY/$APP:$TAG (env tag=$ENV)" docker build \ -t "$REGISTRY/$APP:$TAG" \ -t "$REGISTRY/$APP:$ENV" . docker push "$REGISTRY/$APP:$TAG" docker push "$REGISTRY/$APP:$ENV" # 同时打 :$TAG(可追溯)与 :$ENV(k8s 环境指针)两个 tag mkdir -p /tmp/lpt-ci echo "$TAG" > image_tag.txt echo "$TAG" > /tmp/lpt-ci/image_tag.txt echo "IMAGE_TAG=$TAG" - name: Setup kubectl run: | set -euo pipefail if ! command -v kubectl >/dev/null 2>&1; then echo "kubectl 不在 runner 镜像中,临时下载 $KUBECTL_VERSION" curl -fsSLo /usr/local/bin/kubectl \ "https://dl.k8s.io/release/${KUBECTL_VERSION}/bin/linux/amd64/kubectl" chmod +x /usr/local/bin/kubectl fi echo "${{ secrets.KUBECONFIG_B64 }}" | base64 -d > /tmp/kubeconfig chmod 600 /tmp/kubeconfig kubectl version --client kubectl cluster-info --request-timeout=20s - name: Create/Update imagePullSecret run: | set -euo pipefail kubectl create secret docker-registry regcred \ --docker-server="$REGISTRY" \ --docker-username="${{ secrets.REGISTRY_USERNAME }}" \ --docker-password="${{ secrets.REGISTRY_PASSWORD }}" \ -n "lpt-${{ inputs.environment }}" \ --dry-run=client -o yaml | kubectl apply -f - - name: Deploy to K8s run: | set -euo pipefail ENV="${{ inputs.environment }}" IMAGE_TAG="$(cat /tmp/lpt-ci/image_tag.txt 2>/dev/null || echo '')" if [ -z "$IMAGE_TAG" ]; then echo "ERROR: IMAGE_TAG 为空,无法部署" exit 1 fi # 只有真正进入部署阶段才允许回滚,避免 build/checkout 失败时回滚掉上一次成功的版本 mkdir -p /tmp/lpt-ci : > /tmp/lpt-ci/deploy_attempted echo "Deploying $REGISTRY/$APP:$IMAGE_TAG -> namespace lpt-$ENV" # kubectl 1.30+ 已移除 --record,用 annotate 记录本次部署的镜像 kubectl set image "deployment/$APP" \ "$APP=$REGISTRY/$APP:$IMAGE_TAG" \ -n "lpt-$ENV" kubectl annotate "deployment/$APP" -n "lpt-$ENV" \ "lpt/deployed-image=$IMAGE_TAG" --overwrite || true kubectl rollout status "deployment/$APP" \ -n "lpt-$ENV" --timeout=5m - name: Debug on failure if: failure() run: | ENV="${{ inputs.environment }}" echo "=== Deployment Status ===" kubectl get deployment "$APP" -n "lpt-$ENV" || true echo "" echo "=== Pod Status ===" kubectl get pods -n "lpt-$ENV" -l "app=$APP" || true echo "" echo "=== Recent Events ===" kubectl get events -n "lpt-$ENV" --sort-by='.lastTimestamp' | tail -20 || true echo "" echo "=== Pod Describe (latest) ===" POD=$(kubectl get pods -n "lpt-$ENV" -l "app=$APP" --sort-by=.metadata.creationTimestamp -o jsonpath='{.items[-1].metadata.name}' 2>/dev/null || true) if [ -n "${POD:-}" ]; then kubectl describe pod "$POD" -n "lpt-$ENV" || true echo "" echo "=== Pod Logs (latest) ===" kubectl logs "$POD" -n "lpt-$ENV" --tail=50 || true fi - name: Rollback on failure if: failure() run: | set -euo pipefail ENV="${{ inputs.environment }}" if [ ! -f /tmp/lpt-ci/deploy_attempted ]; then echo "本次运行未进入部署阶段(失败在 checkout/build/login 等前置步骤),跳过回滚" echo "避免把上一次成功的部署回滚掉" exit 0 fi kubectl rollout undo "deployment/$APP" -n "lpt-$ENV" || true kubectl rollout status "deployment/$APP" -n "lpt-$ENV" || true