如何让AWS EKS部署使用GitLab CI的$CI_PIPELINE_IID标签镜像？

你的问题核心是K8s拿到的部署配置里，镜像标签还是未替换的$CI_PIPELINE_IID变量字符串，导致镜像名称无效。以下是几种接地气的解决方法：

方法1：用sed直接替换占位符 #

先把deployment.yml里的镜像名改成带自定义占位符的格式，比如：

image: registry.gitlab.com/proj/repo/backend:BACKEND-__PIPELINE_IID__

然后在GitLab CI的部署步骤里，用sed替换占位符为实际的流水线ID：

deploy:
  stage: deploy
  image: alpine/k8s:latest # 自带kubectl和sed的镜像
  script:
    # 替换占位符为当前流水线ID
    - sed -i "s/__PIPELINE_IID__/$CI_PIPELINE_IID/g" deployment.yml
    # 应用到EKS集群
    - kubectl apply -f deployment.yml -n your-namespace

方法2：用envsubst批量替换环境变量 #

如果配置里有多个GitLab变量需要替换，用envsubst更高效。保持deployment.yml里的镜像名不变：

image: registry.gitlab.com/proj/repo/backend:BACKEND-$CI_PIPELINE_IID

然后在部署步骤中用envsubst处理配置文件后再部署：

deploy:
  stage: deploy
  image: alpine/k8s:latest
  before_script:
    - apk add gettext # 安装envsubst工具（如果镜像自带可以省略）
  script:
    # 替换所有环境变量后，通过管道传给kubectl
    - envsubst < deployment.yml | kubectl apply -f - -n your-namespace

方法3：用Helm管理部署（适合复杂场景） #

如果你的部署配置涉及多个资源或变量，用Helm更灵活。

1. 在Helm Chart的values.yaml中定义镜像标签变量：

backend:
  image:
    repository: registry.gitlab.com/proj/repo/backend
    tag: BACKEND-${pipelineIid}

2. 在GitLab CI部署步骤中传入流水线ID参数：

deploy:
  stage: deploy
  image: alpine/helm:latest
  script:
    - helm upgrade --install backend ./charts/backend \
        --set backend.image.tag=BACKEND-$CI_PIPELINE_IID \
        -n your-namespace

调试小技巧 #

部署前可以加一步查看替换后的配置，确认变量已正确替换：

# 方法1/2中加入
- cat deployment.yml
# 方法3中加入
- helm template ./charts/backend --set backend.image.tag=BACKEND-$CI_PIPELINE_IID

内容的提问来源于stack exchange，提问作者user23627827