跳到主要内容
版本：v2.9

升级 Docker 安装的 Rancher

本文介绍如何升级通过 Docker 安装的 Rancher Server。

警告

生产环境不支持 Docker 安装。这些说明仅适用于测试和开发。如果你已经在生产环境中部署了 Docker 安装并且需要升级到新的 Rancher 版本，我们建议你在升级前先迁移到 Helm Chart 安装。

先决条件​

占位符​

在升级过程中，你将输入一系列命令。请按照你环境的实际情况替换占位符。占位符用尖括号和大写字母（如 <EXAMPLE>）表示。

以下是带有占位符的命令示例：

docker stop <RANCHER_CONTAINER_NAME>

在此命令中，<RANCHER_CONTAINER_NAME> 是你的 Rancher 容器的名称。

获取升级命令的数据​

要获取替换占位符的数据，请运行：

docker ps

在开始升级之前记下或复制此信息。

终端 docker ps 命令，显示如何找到 <RANCHER_CONTAINER_TAG> 和 <RANCHER_CONTAINER_NAME>

占位符参考

占位符示例描述
<RANCHER_CONTAINER_TAG>v2.1.3首次安装拉取的 rancher/rancher 镜像。
<RANCHER_CONTAINER_NAME>festive_mestorf你的 Rancher 容器的名称。
<RANCHER_VERSION>v2.1.3你为其创建备份的 Rancher 版本。
<DATE>2018-12-19数据容器或备份的创建日期。

可以通过远程连接登录到 Rancher Server 所在的主机并输入命令 docker ps 以查看正在运行的容器，从而获得 <RANCHER_CONTAINER_TAG> 和 <RANCHER_CONTAINER_NAME>。你还可以运行 docker ps -a 命令查看停止了的容器。在创建备份期间，你随时可以运行这些命令来获得帮助。

升级​

在升级期间，你可以为当前 Rancher 容器创建数据的副本及备份，以确保可以在升级出现问题时可以进行回滚。然后，你可使用现有数据将新版本的 Rancher 部署到新容器中。

1. 创建 Rancher Server 容器的数据副本​

  1. 使用远程终端连接，登录到运行 Rancher Server 的节点。

  2. 停止正在运行 Rancher Server 的容器。将 <RANCHER_CONTAINER_NAME> 替换为你的 Rancher 容器的名称：

    docker stop <RANCHER_CONTAINER_NAME>
  3. 运行以下命令，从刚才停止的 Rancher 容器创建一个数据容器。请替换命令中的占位符：
    docker create --volumes-from <RANCHER_CONTAINER_NAME> --name rancher-data rancher/rancher:<RANCHER_CONTAINER_TAG>

2. 创建备份压缩包​

  1. 从你刚刚创建的数据容器（rancher-data）中，创建一个备份 tar 包（rancher-data-backup-<RANCHER_VERSION>-<DATE>.tar.gz）。

    如果升级期间出现问题，此压缩包可以用作回滚点。替换占位符来运行以下命令。

    docker run --volumes-from rancher-data -v "$PWD:/backup" --rm busybox tar zcvf /backup/rancher-data-backup-<RANCHER_VERSION>-<DATE>.tar.gz /var/lib/rancher

    步骤结果：你输入此命令时，会运行一系列命令。

  2. 输入 ls 命令，确认备份压缩包已创建成功。压缩包的名称格式类似 rancher-data-backup-<RANCHER_VERSION>-<DATE>.tar.gz。

    [rancher@ip-10-0-0-50 ~]$ ls
    rancher-data-backup-v2.1.3-20181219.tar.gz

  3. 将备份压缩包移动到 Rancher Server 外的安全位置。

3. 拉取新的 Docker 镜像​

拉取你需要升级到的 Rancher 版本镜像。

占位符描述
<RANCHER_VERSION_TAG>你想要升级到的 Rancher 版本的版本标签。
docker pull rancher/rancher:<RANCHER_VERSION_TAG>

4. 启动新的 Rancher Server 容器​

使用 rancher-data 容器中的数据启动一个新的 Rancher Server 容器。记住要传入启动原始容器时使用的所有环境变量。

危险

启动升级后，即使升级耗时比预期长，也 不要 停止升级。如果你停止升级，可能会导致之后的升级中出现数据库迁移错误。

如果你使用代理，请参见 HTTP 代理配置。

如果你配置了自定义 CA 根证书来访问服务，请参见自定义 CA 根证书。

如果你要记录所有 Rancher API 的事务，请参见 API 审计。

如需查看启动新 Rancher Server 容器时使用的命令，从以下的选项中进行选择：

  • Docker 升级
  • 离线安装的 Docker 升级

选择你安装 Rancher Server 时用的选项

选项 A：使用 Rancher 默认的自签名证书​

单击展开

如果你使用 Rancher 生成的自签名证书，则将 --volumes-from rancher-data 添加到你启动原始 Rancher Server 容器的命令中。

占位符描述
<RANCHER_VERSION_TAG>你想要升级到的 Rancher 版本的版本标签。
docker run -d --volumes-from rancher-data \
  --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  --privileged \
  rancher/rancher:<RANCHER_VERSION_TAG>

特权访问是必须的。

选项 B：使用你自己的证书 - 自签名​

单击展开

如果你选择使用自己的自签名证书，则在启动原始 Rancher Server 容器的命令中添加 --volumes-from rancher-data。此外，你需要能够访问你原始安装时使用的证书。

证书要求提示：

证书文件的格式必须是 PEM。在你的证书文件中，包括链中的所有中间证书。你需要对你的证书进行排序，把你的证书放在最前面，后面跟着中间证书。

占位符描述
<CERT_DIRECTORY>包含证书文件的目录的路径。
<FULL_CHAIN.pem>完整证书链的路径。
<PRIVATE_KEY.pem>证书私钥的路径。
<CA_CERTS.pem>CA 证书的路径。
<RANCHER_VERSION_TAG>你想要升级到的 Rancher 版本的版本标签。
docker run -d --volumes-from rancher-data \
  --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  -v /<CERT_DIRECTORY>/<FULL_CHAIN.pem>:/etc/rancher/ssl/cert.pem \
  -v /<CERT_DIRECTORY>/<PRIVATE_KEY.pem>:/etc/rancher/ssl/key.pem \
  -v /<CERT_DIRECTORY>/<CA_CERTS.pem>:/etc/rancher/ssl/cacerts.pem \
  --privileged \
  rancher/rancher:<RANCHER_VERSION_TAG>

特权访问是必须的。

选项 C：使用你自己的证书 - 可信 CA 签名的证书​

单击展开

如果你选择使用可信 CA 签名的证书，则在启动原始 Rancher Server 容器的命令中添加 --volumes-from rancher-data。此外，你需要能够访问你原始安装时使用的证书。注意要使用 --no-cacerts 作为容器的参数，以禁用 Rancher 生成的默认 CA 证书。

证书要求提示：

证书文件的格式必须是 PEM。在你的证书文件中，包括可信 CA 提供的所有中间证书。你需要对你的证书进行排序，把你的证书放在最前面，后面跟着中间证书。如需查看示例，请参见证书故障排除。

占位符描述
<CERT_DIRECTORY>包含证书文件的目录的路径。
<FULL_CHAIN.pem>完整证书链的路径。
<PRIVATE_KEY.pem>证书私钥的路径。
<RANCHER_VERSION_TAG>你想要升级到的 Rancher 版本的版本标签。
docker run -d --volumes-from rancher-data \
  --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  -v /<CERT_DIRECTORY>/<FULL_CHAIN.pem>:/etc/rancher/ssl/cert.pem \
  -v /<CERT_DIRECTORY>/<PRIVATE_KEY.pem>:/etc/rancher/ssl/key.pem \
  --privileged \
  rancher/rancher:<RANCHER_VERSION_TAG> \
  --no-cacerts

特权访问是必须的。

选项 D：Let's Encrypt 证书​

单击展开
警告

Let's Encrypt 对新证书请求有频率限制。因此，请限制创建或销毁容器的频率。详情请参见 Let's Encrypt 官方文档 - 频率限制。

如果你选择使用 Let's Encrypt 证书，则在启动原始 Rancher Server 容器的命令中添加 --volumes-from rancher-data，并且提供最初安装 Rancher 时使用的域名。

证书要求提示：
  • 在 DNS 中创建一条记录，将 Linux 主机 IP 地址绑定到要用于访问 Rancher 的主机名（例如，rancher.mydomain.com）。
  • 在 Linux 主机上打开 TCP/80 端口。Let's Encrypt 的 HTTP-01 质询可以来自任何源 IP 地址，因此端口 TCP/80 必须开放开所有 IP 地址。
占位符描述
<RANCHER_VERSION_TAG>你想要升级到的 Rancher 版本的版本标签。
<YOUR.DNS.NAME>你最初使用的域名
docker run -d --volumes-from rancher-data \
  --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  --privileged \
  rancher/rancher:<RANCHER_VERSION_TAG> \
  --acme-domain <YOUR.DNS.NAME>

特权访问是必须的。

结果：你已升级 Rancher。已升级 Server 中的数据将保存在 rancher-data 容器中，用于将来的升级。

5. 验证升级​

登录到 Rancher。通过检查浏览器左下角的版本号，确认升级是否成功。

升级后下游集群出现网络问题？

请参见恢复集群网络。

6. 清理旧的 Rancher Server 容器​

移除旧的 Rancher Server 容器。如果你仅停止了旧的 Rancher Server 容器，但没有移除它，该容器还可能在服务器下次重启后重新启动。

回滚​

如果升级没有成功完成，你可以将 Rancher Server 及其数据回滚到上次的健康状态。详情请参见 Docker 回滚。