GitLab 静默模式

静默模式允许您阻止来自 GitLab 的出站通信，例如电子邮件。静默模式不适用于正在使用的环境。两个用例如下：

• 验证 Geo 站点提升。您拥有一个作为灾难恢复解决方案一部分的辅助 Geo 站点。作为确保灾难恢复计划切实可行的最佳实践，您希望定期测试将其提升为主 Geo 站点。但您不希望实际执行完整的故障转移，因为主站点位于为用户提供最低延迟的区域。而且您不希望在每次定期测试期间都停机。因此，您让主站点保持运行，同时提升辅助站点。您开始对提升后的站点进行冒烟测试。但是，提升后的站点会开始向用户发送电子邮件，推送镜像会将更改推送到外部 Git 仓库等。这时，静默模式就派上用场了。您可以在站点提升过程中启用它，以避免此问题。
• 验证 GitLab 备份。您设置一个测试实例来测试您的备份是否能够成功恢复。作为恢复过程的一部分，您可以启用静默模式，例如，以避免向用户发送无效的电子邮件。

启用静默模式

前提条件：

• 您必须拥有管理员权限。

有多种方法可以启用静默模式：

• Web UI

  1. 在左侧边栏的底部，选择 管理员。
  2. 在左侧边栏中，选择 设置 > 通用。
  3. 展开 静默模式，然后切换 启用静默模式 开关。
  4. 更改会立即保存。

• API:

  curl --request PUT --header "PRIVATE-TOKEN:$ADMIN_TOKEN" "<gitlab-url>/api/v4/application/settings?silent_mode_enabled=true"

• Rails 控制台:

  ::Gitlab::CurrentSettings.update!(silent_mode_enabled: true)

更改可能需要最多一分钟才能生效。议题 405433 提议移除此延迟。

禁用静默模式

前提条件：

• 您必须拥有管理员权限。

有多种方法可以禁用静默模式：

• Web UI

  1. 在左侧边栏的底部，选择 管理员。
  2. 在左侧边栏中，选择 设置 > 通用。
  3. 展开 静默模式，然后切换 启用静默模式 开关。
  4. 更改会立即保存。

• API:

  curl --request PUT --header "PRIVATE-TOKEN:$ADMIN_TOKEN" "<gitlab-url>/api/v4/application/settings?silent_mode_enabled=false"

• Rails 控制台:

  ::Gitlab::CurrentSettings.update!(silent_mode_enabled: false)

更改可能需要最多一分钟才能生效。议题 405433 提议移除此延迟。

静默模式下 GitLab 功能的行为

本节记录了启用静默模式时 GitLab 的当前行为。静默模式首次迭代的工作由 Epic 9826 进行跟踪。

启用静默模式后，所有用户的页面顶部都会显示一个横幅，说明该设置已启用，并且 所有出站通信均被阻止。

被静默的出站通信

以下功能的出站通信会被静默模式静默。

未被静默的出站通信

以下功能的出站通信不会被静默模式静默。