title: 服务升级

在部署服务之后, 您可能想要通过修改服务来升级应用。例如，镜像已经被更新了，您想要部署服务的新版本。由于 Docker 容器是不可变的，为了修改服务，您需要销毁旧的容器并部署新的容器。Rancher 提供了两种升级服务的方法。推荐的方式是服务内升级，这种方式会停掉旧的容器并且在这个服务内启动新的容器。 RancherUI仅支持服务内升级。您也可以通过Rancher Compose 命令行进行服务内升级。 另一种升级方式为替换式升级。这种升级方式会删除旧的服务并创建一个新的服务，只有通过Rancher Compose 命令行才能进行替换式升级。

注意: 如果您是想对您的服务进行扩容，您可以修改服务页面的数量参数，或者也可以用过 Rancher Compose 命令行来进行服务扩容。 rancher-compose scale <服务名>=<新的容器数量>.

服务内升级

通过 UI 进行升级

任何服务都可以通过 UI 来进行升级。和部署服务类似，您之前选择的全部 Docker 参数都会被保留，您可以修改这些参数的值。额外还有一些升级专用的选项:

  • 批量大小:服务中的容器升级会被分成几批，批量大小代表每次您想要停掉的旧容器数量和启动的新容器数量。例如一共有 10 个容器要升级，当批量大小为 2 时，每次会升级 2 个容器，停掉 2 个旧的，启动 2 个新的，分 5 批完成升级。
  • 批量间隔:每次批量升级间隔的时间，例如 10 个容器，每次升级 5 个，批量时间为 5 秒。在完成 5 个容器升级后，在等待 5 秒后，会升级剩下的 5 个容器。
  • 启动行为:默认情况下，旧的容器会先停止，然后再启动新的容器。您可以选择先启动新的容器，再停止旧的容器。

在配置好了新的服务参数和升级专用参数以后，单击升级。

当全部旧的容器被停掉，新的容器启动成功之后，服务将会变成 Upgraded 状态。在这个阶段，您应该去测试您的新服务来确保服务可以正常工作。然后，可以通过单击升级完成来完成升级。如果您的服务出现了异常，您可以单击回滚来回退到之前的服务。

通过 Rancher Compose 命令行进行服务升级

通过 Rancher Compose 命令行进行服务内升级时，现有服务会按照docker-compose.yml中的内容进行升级，服务中旧的容器会被删除。升级相关的参数需要传递给rancher-compose up命令。如果命令加上--upgrade参数，docker-compose.yml内定义的服务如果发生了改变，这个服务会被按照文件中的配置进行升级。和在 UI 上进行升级操作一样，服务内升级分为两个步骤，需要用户确认来完成升级或者执行回滚。

第一步: 进行升级

升级的时候，您可以通过docker-compose.yml文件升级整个应用栈或者升级应用内指定的服务。

  1. # 升级应用栈内的全部有变化的服务
  2. $ rancher-compose up --upgrade
  3. # 升级应用栈内指定的服务 (例如仅升级service1和service2)
  4. $ rancher-compose up --upgrade service1 service2
  5. # 强制触发服务升级，即使在docker-comopse.yml文件中未被改变的服务，也将被升级。
  6. $ rancher-compose up --force-upgrade

升级选项

选项 描述
--pull, -p 升级前，在每台运行该容器的主机上执行 docker pull 操作，尝试获取新镜像
-d 在后台运行升级
--upgrade, -u, --recreate 仅升级在 docker-compose.yml 中配置有变化的服务
--force-upgrade, --force-recreate 不论服务的配置是否有变化，全部进行升级
--confirm-upgrade, -c 升级完成后自动确认升级成功，删除旧的容器
--rollback, -r 回滚到之前的版本
--batch-size “2” 每批升级的容器个数
--interval “1000” 每批升级的时间间隔

拉取镜像

在升级时，您可能需要在部署容器之前执行docker pull，因为主机上可能已经有了该镜像的缓存。您可以通过--pull参数，在部署容器之前拉取最新的镜像。

  1. # 在升级时，强制每台主机在部署容器之前，执行docker pull更新镜像
  2. $ rancher-compose up --upgrade --pull

批量大小

在默认的情况下，每批升级服务的 2 个容器。您可以通过--batch-size参数来设置每批所更新的镜像数量。

  1. # 升级服务时每次会启动3个新的容器
  2. # 直到新的容器达到设置的数量
  3. $ rancher-compose up --upgrade --batch-size 3

批量间隔

在默认的情况下，每次新的容器启动和旧的容器停止之间有 2 秒的时间间隔。您可以通过--interval来覆盖这个时间间隔，参数后面跟着的时间间隔是以毫秒为单位的。

  1. # 将服务的升级间隔设置为30秒。
  2. # service1和service2的新容器启动和他们的旧容器停止之间为30s
  3. $ rancher-compose up --upgrade service1 service2 --interval "30000"

在停止旧的容器前启动新的容器

在默认的情况下，服务内升级会先停掉旧的容器，再启动新的容器。如果想要先启动新的容器，再停止旧的容器，您需要在rancher-compose.yml文件中写入如下内容。

  1. version: '2'
  2. services:
  3.   myservice:
  4.     upgrade_strategy:
  5.       start_first: true
  1. # 通过上面的rancher-compose.yml配置，会先启动myservice服务中的新容器，然后再停掉旧容器。
  2. $ rancher-compose up --upgrade myservice
第二步:确认升级

在您验证该服务升级成了并且可以正常工作了之后，您需要在 Rancher 里确认升级成功。这种设计是因为有时候您可能想要回滚您的服务。当您单击完成升级后，就不能再进行回滚操作了

  1. # 下面的命令可以确认升级成功，不需要在UI上单击完成升级。
  2. $ rancher-compose up --upgrade --confirm-upgrade

回滚

在升级过程完成之后，您的服务可能发生了问题不能正常工作。Rancher 支持回滚功能，可以把服务回滚到升级之前的状态。回滚操作只能在单击完成升级之前进行。

  1. # 回滚到之前的版本
  2. $ rancher-compose up --upgrade --rollback

替换式升级

替换式升级会通过创建一个新的服务来替换旧的服务，而不是在同一个服务内停止旧的容器并启动新的容器。只有 Rancher Compose 命令行才支持这种升级方式，UI 上不可以。替换式升级操作非常简单:

  1. $ rancher-compose upgrade service1 service2

service2是您想要在 Rancher 里启动的新服务的名字。service1是您想要在 Rancher 里停止并替换的服务。当service2被部署之后，service1里面的容器会被删除，但是服务本身并不会从 Rancher 里删除，只是容器的数量会变为 0。

这两个服务名都需要被定义在docker-compose.yml里面。service1只需要把服务名在 yml 文件中定义即可，Rancher Compose 会用这个名字来找到相应的服务。service2则需要在 yml 文件中定义全部需要的配置，Rancher Compose 命令行会根据文件中的配置来部署service2。

示例 docker-compose.yml

  1. version: '2'
  2. services:
  3.   service1:
  4.   # 这里不需要额外的参数，因为service1已经在运行中了。
  5.   service2:
  6.     image: wordpress
  7.     links:
  8.     - db:mysql

默认情况下，全部的指向service1的负载均衡或者是服务连接都会被自动更新并指向service2。如果您不想创建这些连接，您可以通过设置来禁止连接创建。

注意: 升级服务时并不需要rancher-compose.yml文件。 在默认情况下，新服务中的容器数量和旧服务中的容器数量相同。您可以通过传递--scale参数来设置容器的数量。

升级过程中的容器数量

直到新的服务中的容器数量和旧的服务中的容器数量达到您设定的数量时，旧服务中的容器才会被删除。

示例:

  1. $ rancher-compose upgrade service1 service2 --scale 5

service1中有两个容器，您想要把它升级为service2，service2中想要启动 5 个容器。

service1 service2 备注
2 0 service1在运行中，并且有两个容器。
2 2 service2每批启动两个容器(默认批量数量)。
2 4 service2第二批时，再启动两个容器。
1 4 在上一步，新旧容器的数量总和为 6 个，已经超过目标数量的 5 个。这时会停掉service1里的一个容器，使新旧容器数量为 5 个。
1 5 service2再启动一个容器，达到目标的 5 个容器。
0 5 service1删除最后一个容器。

Upgrade命令的参数

upgrade命令，可以接受几个参数来自定义升级行为。

参数 描述
--batch-size “2” 每批升级的容器个数
--scale “-1” 最终要运行的容器数量
--interval “2000” 每批升级的时间间隔
--update-links 更新指定服务的连接
--wait, -w 等待升级完成
--pull, -p 升级前，在每台运行该容器的主机上执行 docker pull 操作，尝试获取新镜像
--cleanup, -c 在升级完毕后，删除旧的服务
批量大小

在默认情况下，升级的时候每次启动 2 个新服务的容器。您可以通过--batch-size参数来设置每批启动的容器个数。

  1. # 升级的过程中，每批将会启动3个service2的容器，直到service2的容器数量达到设定的值。
  2. $ rancher-compose upgrade service1 service2 --batch-size 3
最终数量

在默认情况下，新服务的容器数量和旧服务之前运行的容器数量相同。您可以通过传递--scale参数，来设置新服务所运行容器的数量。

  1. #设置service2升级后的容器数量为8个
  2. $ rancher-compose upgrade service1 service2 --scale 8

注意: 旧服务中的容器并不根据批量大小的数量来删除。当新旧服务中的容器数量和，达到设置的最终数量时，旧服务中的容器将会被停止并删除。

批量间隔

在默认的情况下，每次新的容器启动和旧的容器停止之间有 2 秒的时间间隔。您可以通过--interval来覆盖这个时间间隔，参数后面跟着的时间间隔是以毫秒为单位的。

  1. # 将服务的升级间隔设置为30秒。
  2. # service1和service2的新容器启动和他们的旧容器停止之间为30s
  3. $ rancher-compose upgrade service1 service2 --interval "30000"
更新连接

在默认情况下，全部指向旧服务的连接会被设置到新服务上。如果您不想让那些服务连接到新的服务的话，您可以通过--update-links="false"参数来禁止这些连接的创建。

  1. # 不把指向service1中的连接设置到service2上
  2. $ rancher-compose upgrade service1 service2 --update-links="false"
等待升级完毕

在默认情况下，Rancher Compose 命令行在向 Rancher 发出升级命令后就会立刻退出。退出的时候升级可能还没执行完毕。通过传递--wait或者-w到upgrade命令，Rancher Compose 命令行将在旧的容器被停止且新容器启动后才退出。

  1. # 等待升级完成
  2. $ rancher-compose upgrade service1 service2 --wait
拉取新镜像

在升级时，您可能想在部署容器之前执行docker pull，因为主机上可能已经有了该镜像的缓存。您可以通过--pull或者-p参数，在部署容器之前拉取最新的镜像。

  1. # 在启动容器时，先执行docker pull获取最新镜像
  2. $ rancher-compose upgrade service1 service2 --pull
清除旧的服务

在默认情况下，升级完成后旧的服务不会被删除，只是旧服务中容器的数量为 0。如果您觉得并不需要回滚，也不需要保留旧的服务配置。您可以通过传递--cleanup或者-c参数到upgrade命令。这个参数会同时应用--wait参数，因为 Rancher Compose 命令行需要等待升级完成，然后才能删掉旧的服务。

  1. # 升级完成后删除service1
  2. $ rancher-compose upgrade service1 service2 --cleanup