升级GoCD

此页面中的步骤可用于升级GoCD。建议了解任何可能影响您升级的破坏性更改在各个发行版之间查看是否会对您的升级产生任何影响。

注意: 如果从GoCD版本<=20.5.0进行升级，则需要进行一次性的数据库迁移操作。

在开始之前

• 在开始升级之前，建议您在GoCD服务器上启用维护模式（自19.1版本起可用）。可以在管理 > 服务器维护模式

• 转到备份页面下的管理 > 备份并进行备份。这可能需要几分钟时间，具体取决于您的GoCD数据库和配置的大小。

• GoCD服务器充当所有构建产物的存储库。虽然在升级前备份这些产物并非必要，但定期备份此目录是一种良好的实践。

  您可以配置GoCD存储构建产物的位置。如果您未自定义其位置，以下是默认的产物存储位置：

  操作系统	位置
  Linux	/var/lib/go-server/artifacts
  Windows, MacOS	${GOCD_INSTALL_DIR}/artifacts

升级到新版本

执行升级时无需停止代理。GoCD代理将自动更新到软件的正确版本。您无需升级GoCD代理。正在进行的构建将被重新安排，现有的流水线将按预期完成。通常，已安装的服务器将与至少一年前的GoCD代理版本保持兼容。

GoCD在启动时将执行其配置和数据库的升级。对于具有大量历史构建记录的安装，此过程可能需要一些时间（在非常大的安装上大约需要10到15分钟）。如果您怀疑升级过程中存在问题，请检查go-server.log文件以查看是否有报告的错误。此迁移仅在升级时发生，后续重启将快得多。

Windows

运行GoCD安装程序。请确保指定与先前安装版本相同的目录。

如果您已将GoCD服务器Windows服务更改为以其他用户身份运行，则需要重复这一配置更改。

安装程序将自动启动服务。一旦GoCD完成其内部数据更改，您就应该能够看到GoCD网页。任何现有的代理应自动重新连接。正在进行的构建应继续或被重新安排。

Linux

基于Debian的发行版（即Ubuntu）

按照说明运行GoCD安装程序

sudo dpkg -i /path/to/go-server-${version}.deb
# OR
sudo apt-get update
sudo apt-get install --install-recommends go-server

基于RPM的发行版（即RedHat）

按照说明运行GoCD安装程序

sudo rpm -Uvh /path/to/go-server-${version}.rpm
sudo dnf upgrade go-server

MacOS

MacOS版本的GoCD不支持升级。您应简单地将新的GoCD服务器版本解压到新位置，并从旧位置复制配置和产物目录。