GitLab CI rules配合extends使用不生效及语法错误排查

问题1：create-admin-server 作业未在$ADMIN_SERVER_IP为空时触发 #

根因 #

• GitLab CI 中作业通过extends继承模板配置时，作业本地定义的rules配置会完全覆盖父模板的rules，不会做拼接合并。
• 当前create-admin-server本地仅配置了「$ADMIN_SERVER_IP非空时跳过作业」的规则，完全覆盖了.ifawsdeploy中定义的通用AWS部署触发规则，没有配置任何「满足条件时允许作业运行」的匹配项，因此无论$ADMIN_SERVER_IP是否为空，作业都无法被触发。
• 补充说明：当前connect-admin-server作业看似运行正常，实际也存在相同的规则覆盖问题：它仅判断了IP和密钥非空就运行，没有校验AWS相关必填变量，存在缺参运行失败的隐患。

修复方案 #

将通用触发规则和互斥判断规则合并，按「先匹配跳过逻辑、后匹配放行逻辑」的顺序配置rules即可，修复后配置片段如下：

connect-admin-server:
  stage: build
  allow_failure: true
  image:
    name: amazon/aws-cli:latest
    entrypoint: [ "" ]
  rules:
    # 先匹配：IP和密钥均非空、且满足AWS部署通用条件时运行作业
    - if: '$ADMIN_SERVER_IP && $ADMIN_SERVER_IP != "" && $ADMIN_SERVER_SSH_KEY && $ADMIN_SERVER_SSH_KEY != "" && $TEST_CREATE_ADMIN && $REGION && $ROLE_ARN && $PACKAGEURL && $TEST_CREATE_ADMIN == "aws" && $SUB_PLATFORM == "aws" && $ROLE_ARN != "" && $PACKAGEURL != "" && $REGION != ""'
  # 原有script、artifacts等配置保持不变，移除对.ifawsdeploy的extends引用避免规则冲突

create-admin-server:
  stage: build
  allow_failure: false
  image:
    name: amazon/aws-cli:latest
    entrypoint: [ "" ]
  rules:
    # 先匹配：IP非空时直接跳过作业
    - if: '$ADMIN_SERVER_IP && $ADMIN_SERVER_IP != ""'
      when: never
    # 再匹配：满足AWS部署通用条件时运行作业
    - if: '$TEST_CREATE_ADMIN && $REGION && $ROLE_ARN && $PACKAGEURL && $TEST_CREATE_ADMIN == "aws" && $SUB_PLATFORM == "aws" && $ROLE_ARN != "" && $PACKAGEURL != "" && $REGION != ""'
  # 原有script、artifacts等配置保持不变，移除对.ifawsdeploy的extends引用避免规则冲突

如果不想重复写通用规则判断，可以用!reference在作业内直接引用公共规则片段，避免硬编码重复。

问题2：配置!reference后流水线报jobs:destroy-admin-server:rules:rule if invalid expression syntax错误 #

根因 #

1. !reference标签使用位置错误：GitLab CI 不支持在隐藏模板（以.开头的模板作业）的顶层配置段中跨模板引用其他配置，!reference只能直接写在实际运行的作业配置段中。在.ifteardownordestroy模板的rules里用!reference，会导致标签无法被解析，被当成普通的if表达式内容触发语法错误。
2. 规则表达式语法错误：GitLab CI的rules:if表达式中，所有变量（包括预定义变量）必须加$前缀，写法CI_PIPELINE_SOURCE == "triggered"缺少$，本身就是非法表达式。

修复方案 #

两种可落地方案二选一即可：

方案1：直接在作业内使用!reference复用规则（最简洁）

.generalgrabclustertrigger:
  rules:
    - if: '$TEST_CREATE_ADMIN && $REGION && $ROLE_ARN && $PACKAGEURL && $TEST_CREATE_ADMIN == "aws" && $SUB_PLATFORM == "aws" && $ROLE_ARN != "" && $PACKAGEURL != "" && $REGION != ""'

destroy-admin-server:
  stage: cleanup
  allow_failure: true
  interruptible: false
  rules:
    # 直接在作业里引用公共规则
    - !reference [.generalgrabclustertrigger, rules]
    # 注意变量前加$
    - if: '$CI_PIPELINE_SOURCE == "triggered"'
      when: never

方案2：通过extends多继承合并规则（兼容性更好）

.generalgrabclustertrigger:
  rules:
    - if: '$TEST_CREATE_ADMIN && $REGION && $ROLE_ARN && $PACKAGEURL && $TEST_CREATE_ADMIN == "aws" && $SUB_PLATFORM == "aws" && $ROLE_ARN != "" && $PACKAGEURL != "" && $REGION != ""'

.ifteardownordestroy:
  rules:
    - if: '$CI_PIPELINE_SOURCE == "triggered"'
      when: never

destroy-admin-server:
  stage: cleanup
  # 多继承合并两个模板的规则，后写的模板规则会排在匹配顺序的前面
  extends:
    - .generalgrabclustertrigger
    - .ifteardownordestroy
  allow_failure: true
  interruptible: false

注意：GitLab CI 合并多个继承来源的rules时，会按照extends列表的倒序排列规则优先级，上面的写法会优先匹配「触发式流水线跳过」的逻辑，再匹配通用AWS部署条件，符合预期。

内容的提问来源于stack exchange，提问作者Jor-El