环境和部署

环境描述了代码的部署位置。

每次 GitLab CI/CD 将一个版本的代码部署到环境中,就会创建一个部署。

极狐GitLab:

  • 提供每个环境的完整部署历史。
  • 跟踪您的部署,以便您始终了解服务器上部署的内容。

如果你有一个像 Kubernetes 这样的部署服务与您的项目相关联,您可以用它来协助你的部署。

查看环境和部署

先决条件:

  • 您必须至少拥有报告者角色。

查看环境和部署列表:

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 部署 > 环境,显示环境。

    Environments list

  3. 要查看环境的部署列表,请选择环境名称,例如staging

    Deployments list

部署仅在部署作业创建之后才会显示在此列表中。

环境类型

有两种类型的环境:

  • 静态环境具有静态名称,例如 stagingproduction
  • 动态环境具有动态名称。动态环境是 Review apps 的基本组成部分。

创建静态环境

您可以在 UI 或您的 .gitlab-ci.yml 文件中创建环境和部署。

在用户界面中:

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 部署 > 环境
  3. 选择 新建环境
  4. 输入名称和外部 URL。
  5. 选择 保存

在您的 .gitlab-ci.yml 文件中:

  1. 指定环境名称和可选的 URL,确定部署 URL。例如:

    deploy_staging:
      stage: deploy
      script:
        - echo "Deploy to staging server"
      environment:
        name: staging
        url: https://staging.example.com
    
  2. 触发部署。(例如,通过创建和推送提交。)

作业运行时,将创建环境和部署。

note某些字符不能在环境名称中使用。 有关 environment 关键字的更多信息,请参阅 .gitlab-ci.yml 关键字参考

创建动态环境

要为环境创建动态名称和 URL,您可以使用预定义 CI/CD 变量。例如:

deploy_review:
  stage: deploy
  script:
    - echo "Deploy a review app"
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    url: https://$CI_ENVIRONMENT_SLUG.example.com
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
      when: never
    - if: $CI_COMMIT_BRANCH

在这个例子中:

  • namereview/$CI_COMMIT_REF_SLUG。由于 环境名称 可以包含斜杠 (/),因此可以使用此模式来区分动态和静态环境。
  • 对于 url,您可以使用 $CI_COMMIT_REF_SLUG,但由于该值可能包含 / 或其他在域名或 URL 中无效的字符,请改用$CI_ENVIRONMENT_SLUG$CI_ENVIRONMENT_SLUG 变量保证是唯一的。

您不必在动态环境名称中使用相同的前缀或仅使用斜杠 (/)。 但是,当您使用这种格式时,您可以分组相似的环境

note某些变量不能用作环境名称或 URL。 有关 environment 关键字的更多信息,请参阅 .gitlab-ci.yml 关键字参考

环境部署级别

引入于 13.10 版本。

有时,您可能不想使用行业标准环境名称(如 production),而是希望使用代码名称(如 customer-portal)。 虽然没有技术上的理由不使用 “customer-portal 这样的名称,但该名称不再表明该环境用于生产。

要指示特定环境用于特定用途,您可以使用 tier:

环境 tier 环境名称示例
production Production, Live
staging Staging, Model, Demo
testing Test, QC
development Dev, Review apps, Trunk
other  

默认情况下,系统假定一个基于 环境名称 的 tier。 相反,您可以使用 deployment_tier 关键字 来指定 tier。

配置手动部署

您可以创建需要有人手动启动部署的作业。 例如:

deploy_prod:
  stage: deploy
  script:
    - echo "Deploy to production server"
  environment:
    name: production
    url: https://example.com
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
      when: manual

when: manual 操作:

  • 在 GitLab UI 中公开作业的运行按钮,带有可以手动部署到<环境>的文字。
  • 表示只有在单击运行按钮时才会触发 deploy_prod 作业。

您可以在流水线、环境、部署和作业视图中找到运行按钮。

配置 Kubernetes 部署(已弃用)

  • 引入于 12.6 版本。
  • 废弃于 14.5 版本。
caution此功能废弃于 14.5 版本。

如果您要部署到与您的项目关联的 Kubernetes 集群,您可以从您的 .gitlab-ci.yml 文件中配置这些部署。

note由极狐GitLab 管理的 Kubernetes 集群不支持 Kubernetes 配置。

支持以下配置选项:

在以下示例中,该作业将您的应用程序部署到 production Kubernetes 命名空间。

deploy:
  stage: deploy
  script:
    - echo "Deploy to production server"
  environment:
    name: production
    url: https://example.com
    kubernetes:
      namespace: production
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

当您使用 GitLab Kubernetes 集成部署到 Kubernetes 集群时,您可以查看集群和命名空间信息。在部署作业页面上,它显示在作业跟踪上方:

Deployment cluster information

环境和部署的 CI/CD 变量

创建环境时,指定名称和 URL。

如果要在另一个作业中使用名称或 URL,可以使用:

  • $CI_ENVIRONMENT_NAME.gitlab-ci.yml 文件中定义的名称。
  • $CI_ENVIRONMENT_SLUG。例如,名称的 “cleaned-up” 版本,适用于 URL 和 DNS。这个变量保证是唯一的。
  • $CI_ENVIRONMENT_URL。环境的 URL,在 .gitlab-ci.yml 文件中指定或自动分配。

如果更改现有环境的名称,则:

  • $CI_ENVIRONMENT_NAME 变量更新为新的环境名称。
  • $CI_ENVIRONMENT_SLUG 变量保持不变以防止意外的副作用。

作业完成后设置动态环境 URL

在作业脚本中,您可以指定静态环境 URL。 但是,有时您可能需要动态 URL。 例如,如果您将 Review App 部署到每次部署生成随机 URL 的外部托管服务,例如 https://94dd65b.amazonaws.com/qa-lambda-1234567。 在这种情况下,在部署脚本完成之前您不知道 URL。如果要在极狐GitLab 中使用环境 URL,则必须手动更新它。

为了解决这个问题,您可以配置一个部署作业来报告一组变量。这些变量包括由外部服务动态生成的 URL。 系统支持 dotenv (.env) 文件格式,并使用 .env 文件中定义的变量扩展 environment:url 值。

要使用此功能,请在 .gitlab-ci.yml 中指定 artifacts:reports:dotenv 关键字。

设置动态环境 URL 示例

以下示例显示了一个 Review App,它为每个合并请求创建一个新环境。review 作业由每次推送触发,并创建或更新名为 review/your-branch-name 的环境。环境 URL 设置为 $DYNAMIC_ENVIRONMENT_URL

review:
  script:
    - DYNAMIC_ENVIRONMENT_URL=$(deploy-script)                                 # In script, get the environment URL.
    - echo "DYNAMIC_ENVIRONMENT_URL=$DYNAMIC_ENVIRONMENT_URL" >> deploy.env    # Add the value to a dotenv file.
  artifacts:
    reports:
      dotenv: deploy.env                                                       # Report back dotenv file to rails.
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    url: $DYNAMIC_ENVIRONMENT_URL                                              # and set the variable produced in script to `environment:url`
    on_stop: stop_review

stop_review:
  script:
    - ./teardown-environment
  when: manual
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    action: stop

一旦 review 作业完成,系统就会更新 review/your-branch-name 环境的 URL。 通过解析 deploy.env 报告产物,将变量列表注册为 runtime-created,使用它来扩展 environment:url: $DYNAMIC_ENVIRONMENT_URL 并将其设置为环境 URL。 您还可以在 environment:url 指定 URL 的静态部分,例如 https://$DYNAMIC_ENVIRONMENT_URL。 如果 DYNAMIC_ENVIRONMENT_URL的值为 example.com,则最终结果为 https://example.com

review/your-branch-name 环境分配的 URL 在 UI 中可见。

请注意以下事项:

  • stop_review 不会生成 dotenv 报告产物,因此它无法识别 DYNAMIC_ENVIRONMENT_URL 环境变量。因此您不应该在 stop_review 作业中设置 environment:url
  • 如果环境 URL 无效(例如,URL 格式错误),系统不会更新环境 URL。
  • 如果在 stop_review 中运行的脚本只存在于您的仓库中,因此不能使用 GIT_STRATEGY: none,请为这些作业配置合并请求流水线。这确保即使在删除功能分支后, runners 也可以获取仓库。有关更多信息,请参阅 runners 参考规范
note对于 Windows runners,使用 echo 写入 .env 文件可能会失败。在这种情况下,使用 PowerShell Add-Content 命令会有所帮助。 例如:
Add-Content -Path deploy.env -Value "DYNAMIC_ENVIRONMENT_URL=$DYNAMIC_ENVIRONMENT_URL"

跟踪每个部署新包含的合并请求

极狐GitLab 可以跟踪每个部署中新包含的合并请求。 当部署成功时,系统会计算最新部署和先前部署之间的提交差异。 此跟踪信息可以通过 Deployment API 获取并在合并请求页面,显示在合并后的流水线中。

要激活此跟踪,您的环境必须配置如下:

以下是 .gitlab-ci.ymlenvironment 关键字的示例设置:

# Trackable
environment: production
environment: production/aws
environment: development

# Non Trackable
environment: review/$CI_COMMIT_REF_SLUG
environment: testing/aws

使用环境

配置环境后,极狐GitLab 提供了许多使用它们的功能,如下所述。

环境回滚

当您在特定提交上回滚部署时,会创建一个部署。此部署有自己唯一的作业 ID。 它指向您要回滚的提交。

为了使回滚成功,部署过程必须在作业的 script 中定义。

重试或回滚部署

如果部署出现问题,您可以重试或回滚。

要重试或回滚部署:

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 部署 > 环境
  3. 选择环境。
  4. 在部署名称的右侧:
    • 要重试部署,请选择 重新部署至环境
    • 要回滚到部署,在之前成功的部署旁边,选择 回滚环境
note如果您的项目中阻止过期的部署作业,回滚按钮可能会被隐藏或禁用。在这种情况下,请参阅如何回滚到过期的部署

环境 URL

环境 URL 显示在极狐GitLab 的几个地方:

  • 在作为链接的合并请求中: Environment URL in merge request
  • 在环境视图中作为一个按钮: Open live environment from environments view
  • 在部署视图中作为一个按钮: Environment URL in deployments

如果出现以下情况,您可以在合并请求中看到此信息:

  • 合并请求最终合并到默认分支(通常是 main)。
  • 该分支还部署到环境(例如,stagingproduction)。

例如:

Environment URLs in merge request

从源文件转到公共页面

使用 GitLab Route Maps,您可以直接从源文件转到为 Review Apps 设置的环境中的公共页面。

停止环境

当您停止环境时:

  • 环境 页面上,它从 可用的 环境列表移动到 已停止 环境列表。
  • 执行 on_stop 操作(如果已定义)。

有多种方法可以清理动态环境

删除分支时停止环境

您可以将环境配置为在删除分支时停止。

以下示例显示了一个 deploy_review 作业,它调用 stop_review 作业来清理和停止环境。

deploy_review:
  stage: deploy
  script:
    - echo "Deploy a review app"
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    url: https://$CI_ENVIRONMENT_SLUG.example.com
    on_stop: stop_review

stop_review:
  stage: deploy
  script:
    - echo "Remove review app"
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    action: stop
  when: manual

两个作业必须具有相同的 rulesonly/except 配置。否则,stop_review 作业可能不会包含在具有 deploy_review 作业的所有流水线中,并且您无法触发 action: stop 来自动停止环境。

如果比启动环境的作业晚。带有 action: stop 的作业可能不会运行

如果您不能使用合并请求流水线,请将 GIT_STRATEGYstop_review 作业中设置为 none。然后 runner 在分支被删除后不会尝试检出代码。

.gitlab-ci.yml 参考中阅读更多内容。

合并或关闭合并请求时停止环境

您可以将环境配置为在合并或关闭合并请求时停止。 当您使用合并请求流水线时,此停止触发器会自动启用。

以下示例显示了一个调用 stop_review 作业来清理和停止环境的 deploy_review 作业。

deploy_review:
  stage: deploy
  script:
    - echo "Deploy a review app"
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    on_stop: stop_review
  rules:
    - if: $CI_MERGE_REQUEST_ID

stop_review:
  stage: deploy
  script:
    - echo "Remove review app"
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    action: stop
  rules:
    - if: $CI_MERGE_REQUEST_ID
      when: manual

当另一个作业完成时停止一个环境

您可以将环境设置为在另一个作业完成时停止。

在您的 .gitlab-ci.yml 文件中,在 on_stop: 关键字中指定停止环境的作业的名称。

以下示例显示了一个 review_app 作业,它在第一个作业完成后调用了一个 stop_review_app 作业。stop_review_app 是根据 when 下定义的内容触发的。在这种情况下,它被设置为 manual,因此它需要来自 GitLab UI 的手动操作运行。

两个作业必须具有相同的规则或仅/除外配置。 在本例中,如果配置不相同:

  • stop_review_app 作业可能不会包含在包含 review_app 作业的所有流水线中。
  • 无法触发 action: stop 来自动停止环境。

同样在示例中,GIT_STRATEGY 设置为 none。 如果 stop_review_app 作业是自动触发,则在删除分支后 runner 不会尝试检出代码。

该示例还覆盖了全局变量。如果您的 environment 作业的 stop 依赖于全局变量,请在设置 GIT_STRATEGY 时使用锚点变量来更改作业,而不覆盖全局变量。

The stop_review_app job must have the following keywords defined:

stop_review_app 作业必须定义以下关键字:

review_app:
  stage: deploy
  script: make deploy-app
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    url: https://$CI_ENVIRONMENT_SLUG.example.com
    on_stop: stop_review_app

stop_review_app:
  stage: deploy
  variables:
    GIT_STRATEGY: none
  script: make delete-app
  when: manual
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    action: stop

在特定时间段后停止环境

您可以将环境设置为在特定时间段后自动停止。

在你的 .gitlab-ci.yml 文件中,指定 environment:auto_stop_in 关键字。您可以指定一个人性化的日期作为值,例如 1 hour and 30 minutes1 day。 时间段过去后,系统会自动触发作业以停止环境。

由于资源限制,用于停止环境的后台 worker 每小时仅运行一次。这意味着环境不会在指定的确切时间戳处停止,而是在每小时 cron 工作器检测到过期环境时停止。

在以下示例中,每个合并请求都会创建一个 Review App 环境。 每次推送都会触发 review_app 作业,并创建或更新名为 review/your-branch-name 的环境。环境运行直到 stop_review_app 被执行:

review_app:
  script: deploy-review-app
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    on_stop: stop_review_app
    auto_stop_in: 1 week
  rules:
    - if: $CI_MERGE_REQUEST_ID

stop_review_app:
  script: stop-review-app
  environment:
    name: review/$CI_COMMIT_REF_SLUG
    action: stop
  rules:
    - if: $CI_MERGE_REQUEST_ID
      when: manual

只要合并请求处于活动状态并不断获得新的提交,Review App 就不会停止。开发者无需担心重新启动 Review App。

因为 stop_review_app 设置为 auto_stop_in: 1 week,如果一个合并请求超过一个星期没有活动,系统自动触发 stop_review_app 作业来停止环境。

环境的多个停止操作

  • 引入于 14.10 版本,带有名为 environment_multiple_stop_actions 的功能标志。默认禁用。
  • 一般可用于 15.0 版本。功能标志 environment_multiple_stop_actions 已删除。 FLAG: 在私有化部署实例上,默认情况下此功能不可用。要使其可用,请要求管理员启用名为 environment_multiple_stop_actions 的功能标志。 在 SaaS 上,此功能不可用。

当您需要对环境执行多个并行停止操作时,此功能很有用。

要在环境上配置多个停止操作,请在 .gitlab-ci.yml 文件中定义的相同 environment 的多个部署作业中指定 on_stop 关键字。

当环境停止时,仅来自成功部署作业的匹配 on_stop 操作会以无特定顺序并行运行。

在以下示例中,对于 test 环境,有两个部署作业 deploy-to-cloud-adeploy-to-cloud-b

deploy-to-cloud-a:
  script: echo "Deploy to cloud a"
  environment:
    name: test
    on_stop: teardown-cloud-a

deploy-to-cloud-b:
  script: echo "Deploy to cloud b"
  environment:
    name: test
    on_stop: teardown-cloud-b

teardown-cloud-a:
  script: echo "Delete the resources in cloud a"
  environment:
    name: test
    action: stop
  when: manual

teardown-cloud-b:
  script: echo "Delete the resources in cloud b"
  environment:
    name: test
    action: stop
  when: manual

当环境停止时,系统会并行运行 on_stop 操作 teardown-cloud-ateardown-cloud-b

查看部署的计划停止时间

您可以在 GitLab UI 中查看部署的到期日期。

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 部署 > 环境
  3. 选择部署名称。

在左上角,在环境名称旁边,显示到期日期。

覆盖部署的预定停止时间

您可以手动覆盖部署的到期日期。

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 部署 > 环境
  3. 选择部署名称。
  4. 在右上角,选择图钉 ()。

Environment auto stop

auto_stop_in 设置被覆盖,环境保持活动状态,直到它被手动停止。

删除一个停止的环境

引入于 12.10 版本。

您可以在 GitLab UI 中或使用 API 删除停止环境

要在 GitLab UI 中删除已停止的环境:

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 部署 > 环境
  3. 选择 已停止 选项卡。
  4. 在要删除的环境旁边,选择 删除环境
  5. 在确认对话框中,选择 删除环境

访问环境用于准备或验证的环境

引入于 13.2 版本

您可以定义访问环境用于各种目的的作业,例如验证或准备,可以有效地绕过部署创建,以便您可以更准确地调整 CD 工作流程。

为此,请将 action: prepareaction: verifyaction: access 添加到作业的 environment 部分:

build:
  stage: build
  script:
    - echo "Building the app"
  environment:
    name: staging
    action: prepare
    url: https://staging.example.com

这使您可以访问环境范围变量,并可用于保护构建免受未经授权的访问。您可以访问环境范围的变量,并可用于保护构建免受未经授权的访问。此外,有效避免阻止过期的部署作业功能。

分组相似的环境

您可以将环境分组到 UI 中的可折叠部分。

例如,如果您的所有环境都以名称 review 开头,那么在 UI 中,环境将分组在该标题下:

Environment groups

下面的例子展示了如何用 review 开始您的环境名称。 $CI_COMMIT_REF_SLUG 变量在运行时用分支名称填充:

deploy_review:
  stage: deploy
  script:
    - echo "Deploy a review app"
  environment:
    name: review/$CI_COMMIT_REF_SLUG

环境事件管理

生产环境可能会意外停机,包括由于您无法控制的原因。例如,外部依赖、基础设施或人为错误的问题可能会导致环境出现重大问题。例如:

  • 依赖的云服务出现故障。
  • 更新了第三方库,它与您的应用程序不兼容。
  • 有人对您服务器中的易受攻击的端点进行 DDoS 攻击。
  • 运营商错误配置基础设施。
  • 在生产应用程序代码中引入了一个错误。

您可以使用事件管理在出现需要立即关注的关键问题时获取警报。

查看环境的最新警报

引入于 13.4 版本

如果您为 Prometheus 指标设置警报,环境警报将显示在环境页面上。显示具有最高严重性的警报,因此您可以确定哪些环境需要立即关注。

Environment alert

当触发警报的问题得到解决后,它会被删除并且在环境页面上不再可见。

如果警报需要回滚,您可以从环境页面中选择部署选项卡,然后选择要回滚到的部署。

自动回滚

引入于 13.7 版本

在典型的持续部署工作流中,CI 流水线在部署到生产之前测试每个提交。但是,有问题的代码仍然可以投入生产。例如,逻辑上正确的低效代码可以通过测试,即使它会导致严重的性能下降。 运营商和 SRE 监控系统尽快发现这些问题。如果他们发现有问题的部署,他们可以回滚到以前的稳定版本。

系统自动回滚通过在检测到严重警报时,自动触发回滚来简化此工作流程。系统选择并重新部署最近成功的部署。

系统自动回滚的限制:

  • 如果检测到警报时部署正在运行,则会跳过回滚。
  • 回滚只能在三分钟内发生一次。如果一次检测到多个警报,则只执行一次回滚。

系统自动回滚默认是关闭的。要开启:

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 设置 > CI/CD
  3. 展开 自动部署回滚
  4. 选中 启用自动回滚 复选框。
  5. 选择 保存修改

在本地检出部署

每次部署都会在 Git 仓库中保存一个引用,因此只需通过 git fetch 即可了解当前环境的状态。

在您的 Git 配置中,将 [remote "<your-remote>"] 块附加一个额外的提取行:

fetch = +refs/environments/*:refs/remotes/origin/environments/*

存档旧部署

引入于 14.5 版本。 适用于自助管理版于 14.6 版本。

当您的项目中发生新部署时,系统会创建一个特殊的 Git-ref 部署。 由于这些 Git-refs 是从远端 GitLab 仓库填充的,您会发现一些 Git 操作,例如 git-fetchgit-pull,随着项目中部署数量的增加而变慢。

为了保持 Git 操作的效率,系统仅保留最近的部署 refs(最多 50,000 个)并删除其余的旧部署 refs。 存档部署在 UI 中或通过使用 API 仍然可用,用于审计目的。 此外,您仍然可以通过指定提交 SHA(例如,git checkout <deployment-sha>)从仓库中获取部署的提交,即使在存档之后也是如此。

note系统将所有提交保留为 keep-around refs 以便部署的提交不会被垃圾收集,即使它没有被部署 refs 引用。

使用 specs 设置环境范围

  • 群组 CI/CD 变量的环境范围设置添加到专业版于 13.11 版本。

您可以通过定义可用于哪些环境来限制 CI/CD 变量的环境范围。 例如,如果环境范围是 production,那么只有定义了环境 production 的作业才会有这个特定的变量。

默认环境范围是通配符 (*),这意味着任何作业都可以具有此变量,无论是否定义了环境。

如果环境范围是 review/*,那么对于环境名称以 review/ 开头的作业,该变量可用。

某些功能在每个环境中的行为可能不同。 例如,您可以创建一个仅注入生产环境的项目 CI/CD 变量。

在大多数情况下,这些功能使用 environment specs 机制,它提供了一种在每个环境组中实现范围界定的有效方法。

例如,如果有四个环境:

  • production
  • staging
  • review/feature-1
  • review/feature-2

每个环境都可以与以下 environment spec 匹配:

Environment Spec production staging review/feature-1 review/feature-2
* 匹配 匹配 匹配 匹配
production 匹配      
staging   匹配    
review/*     匹配 匹配
review/feature-1     匹配  

您可以使用特定匹配来选择特定环境。 您还可以使用通配符匹配 (*) 来选择特定的环境组,例如 Review Apps。

最具体的 specs 优先于其他通配符匹配。在这种情况下,review/feature-1 spec 优先于 review/** spec。

重命名环境

通过 UI 重命名环境移除于 14.3 版本。 通过 API 重命名环境已废弃并将于 15.0 版本移除。

无法通过 UI 重命名环境。 相反,您需要删除旧环境并创建一个新环境:

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 部署 > 环境
  3. 找到环境并停止。
  4. 删除环境。
  5. 使用您喜欢的名称创建一个新环境。

故障排查

带有 action:stop 的作业没有运行

在某些情况下,分支删除时环境不会停止。

例如,环境可能从一个有失败的作业的阶段开始。 然后后期阶段的作业不会开始。如果环境中带有 action: stop 的作业也处于后期阶段,则它无法启动并且环境不会被删除。

为确保 action: stop 可以在需要时始终运行,您可以:

  • 将两个作业放在同一阶段:

    stages:
      - build
      - test
      - deploy
    
    ...
    
    deploy_review:
      stage: deploy
      environment:
        name: review/$CI_COMMIT_REF_SLUG
        url: https://$CI_ENVIRONMENT_SLUG.example.com
        on_stop: stop_review
    
    stop_review:
      stage: deploy
      environment:
        name: review/$CI_COMMIT_REF_SLUG
        action: stop
      when: manual
    
  • action: stop 作业添加 needs 条目,以便作业可以不按阶段顺序启动:

    stages:
      - build
      - test
      - deploy
      - cleanup
    
    ...
    
    deploy_review:
      stage: deploy
      environment:
        name: review/$CI_COMMIT_REF_SLUG
        url: https://$CI_ENVIRONMENT_SLUG.example.com
        on_stop: stop_review
    
    stop_review:
      stage: cleanup
      needs:
        - deploy_review
      environment:
        name: review/$CI_COMMIT_REF_SLUG
        action: stop
      when: manual
    

部署作业失败,并显示 “This job could not be executed because it would create an environment with an invalid parameter” 错误

引入于 14.4 版本。

如果您的项目配置为创建动态环境,您可能会遇到此错误,因为动态生成的参数不能用于创建环境。

例如,您的项目具有以下 .gitlab-ci.yml

deploy:
  script: echo
  environment: production/$ENVIRONMENT

由于流水线中不存在 $ENVIRONMENT 变量,系统尝试创建一个名为 production/ 的环境,这在环境名称约束中是无效的。

要解决此问题,请使用以下解决方案之一:

  • 从部署作业中删除 environment 关键字。系统已经忽略了 invalid 关键字,因此即使在删除关键字后,您的部署流水线也保持完整。
  • 确保变量存在于流水线中。请注意,支持的变量有限制。

如果您在 Review Apps 上收到此错误

例如,如果您的 .gitlab-ci.yml 中有以下内容:

review:
  script: deploy review app
  environment: review/$CI_COMMIT_REF_NAME

当创建一个分支名称为 bug-fix! 的新合并请求时,review 作业会尝试创建一个带有 review/bug-fix! 的环境。 但是,! 是环境的无效字符,因此部署作业将失败,因为它即将在没有环境的情况下运行。

要解决此问题,请使用以下解决方案之一:

  • 重新创建没有无效字符的功能分支,例如 bug-fix
  • CI_COMMIT_REF_NAME 预定义变量替换为去掉任何无效字符的 CI_COMMIT_REF_SLUG

    review:
      script: deploy review app
      environment: review/$CI_COMMIT_REF_SLUG
    

未找到部署 refs

从 14.5 版本开始,系统删除旧的部署 refs 以保持您的 Git 仓库的性能。

如果您必须恢复存档的 Git-refs,请让自助管理实例的管理员在 Rails 控制台上执行以下命令:

Project.find_by_full_path(<your-project-full-path>).deployments.where(archived: true).each(&:create_ref)

请注意,将来可能会出于性能问题放弃此支持。