配置 GoCD 服务器详细信息

工件存储库配置

安装后，GoCD 不需要任何配置。然而，我们建议您在计算机的硬盘上为 GoCD 服务器工件创建一个单独的分区。工件存储库的大小可能会迅速增长。如果位于系统的主要分区上，当磁盘填满时，您可能会遇到数据丢失和不可预测的应用程序行为。

创建新磁盘分区后，您需要告诉 GoCD 它的位置。

点击“管理”选项卡下的“服务器配置”选项卡。点击“工件管理”部分。

指定工件目录位置并点击“保存”。

高级用户还可以通过配置XML管理部分的标签：

<cruise>
  <server>
    <artifacts>
        <artifactsDir>/path/to/artifacts/directory</artifactsDir>
    </artifacts>
  ...
  </server>
</cruise>

在 Windows 中，您可能需要为您的工件存储库分区分配一个独立的驱动器号。在 Windows 中，您的配置可能看起来像这样：

<cruise>
  <server>
    <artifacts>
        <artifactsDir>E:\go-artifacts</artifactsDir>
    </artifacts>
  ...
  </server>
</cruise>

输入此信息后，点击“保存”以保存配置文件。

您可以随时使用上述方法更改工件目录位置，即使 GoCD 正在运行也可以。但是，GoCD 不会自动将现有工件移动到新位置，并且在 GoCD 运行时更改位置不会生效，直到重新启动 GoCD 服务器。

如果您决定移动工件存储库，安全的方法是：

1. 暂停所有管道，并等待代理网格上所有活动作业完成（所有代理处于“空闲”状态）。
2. 关闭 GoCD 服务器
3. 将工件存储库复制到新位置。
4. 根据上述方法手动编辑 GoCD 的配置文件，告诉 GoCD 工件的位置。
5. 重启 GoCD 服务器。

即使代理网格上所有活动作业已停止，用户仍可能正在通过 RESTful URL 上传工件。这就是为什么我们需要完全停止 GoCD 服务器才能确保安全。

配置站点 URL

点击“管理”选项卡下的“服务器配置”选项卡。转到“服务器管理”部分。

GoCD 生成的 URL 是相对于请求的基本 URL 的。然而，在某些情况下，例如发送电子邮件、生成订阅源时，GoCD 无法依赖于相对于请求发布 URL。如果您在 GoCD 前端使用了一个反向代理，这个值应该是代理的基本 URL，而不是内部 GoCD 地址。出于这个原因，有必要指定此配置。如果基本 URL 包含非标准端口，该 URL 应包含端口。

高级用户如果需要，可以直接更新服务器部分。

<cruise>
      <server>
        <siteUrls>
            <siteUrl>http://host:port</siteUrl>
            <secureSiteUrl>https://host:securePort</secureSiteUrl>
        </siteUrls>
        ...
      </server>
</cruise>

GoCD 的某些功能需要 HTTPS(SSL) 终端。如果您希望主站点 URL 为 HTTP，但仍希望为需要 SSL 的功能提供 HTTPS 终端，可以指定 secureSiteUrl 属性，并将其值设置为基本 HTTPS URL。

另请参阅…

• 安装 GoCD 代理
• 配置 GoCD 以与代理配合使用