已升级

在您开始之前

当前，更新包可能会触发子集或此框架管理的所有组件的更新，这取决于这些新的组件或相关组件是否是新版本的一部分。

更新这些组件意味着 Kubernetes 集群可能会经历某些停机，或者在最坏的情况下，停止正常运行。同时，尽管我们致力于让用户的体验尽可能稳健和顺畅，但事实上，并没有什么防故障软件。

在更新包版本之前，请谨慎操作并始终备份您的数据。

未来，我们将整合灾难恢复功能，这样，您就可以轻松恢复到前一个功能状态。

更新包 vs 更新包选项

当新包可用时，您可以选择更新至新版本。如果您一段时间内未更新包，可能是不允许更新到最新的包版本。如果是这种情况，您将获得如何继续的信息。请注意，DC/OS 开源版本需要额外的步骤来更新包版本。

然而，您可能只需要更新包选项，例如，为了更改分配给一种 Kubernetes 组件的资源。请记住，包选项更新也可能意味着 Kubernetes 集群会经历某些停机，或者在最坏的情况下，停止正常运行。

在更新包选项之前，请谨慎操作并始终备份您的数据。

更新

要更新包，可以使用 dcos kubernetes update 子命令。

$ dcos kubernetes update -h
usage: dcos kubernetes [<flags>] update [<flags>]

Flags:
  -h, --help               Show context-sensitive help.
  -v, --verbose            Enable extra logging of requests/responses
      --name="kubernetes"  Name of the service instance to query
      --options=OPTIONS    Path to a JSON file containing the target package options
      --package-version=PACKAGE-VERSION
                           The target package version
      --yes                Do not ask for confirmation before starting the update process
      --timeout=1200s      Maximum time to wait for the update process to complete

重要信息： 如果您拥有多个 Kubernetes 节点的集群，我们建议将 --timeout 值调整为更大的值。但是，我们不能提前计算该值应为多少，因为考虑到涉及的变量，例如，可用的 DC/OS 集群资源、CPU 和互联网速度等等

更新包版本

在开始更新进程之前，必须将 CLI 更新到新版本：

$ dcos package install kubernetes --cli --package-version=<NEW_VERSION>

DC/OS 企业版

以下是您开始包版本更新的方式：

$ dcos kubernetes update --package-version=<NEW_VERSION>
About to start an update from version <CURRENT_VERSION> to <NEW_VERSION>

Updating these components means the Kubernetes cluster may experience some
downtime or, in the worst-case scenario, cease to function properly.
Before updating proceed cautiously and always backup your data.

This operation is long-running and has to run to completion.
Are you sure you want to continue? [yes/no] yes

2018/03/01 15:40:14 starting update process...
2018/03/01 15:40:15 waiting for update to finish...
2018/03/01 15:41:56 update complete!

DC/OS 开源版本

与企业版本相比，DC/OS 开源包升级需要一些额外的步骤，以实现相同的结果。

首先，将当前包配置导入名为 config.json 的 JSON 文件：

$ dcos kubernetes describe > config.json

要以非破坏性方式进行升级，首先删除 DC/OS Kubernetes 调度器，通过运行：

$ dcos marathon app remove /kubernetes

然后安装包的新版本：

$ dcos package install kubernetes --package-version=<NEW_VERSION> --options=config.json

更新包选项

此包揭示了某些选项，高级用户可根据自己的需要使用这些选项来更新 Kubernetes 集群。例如，您可能想要增加 kube-apiserver 计数或用于 kube-proxy 的资源。举个例子，我们将描述如何实现后者。

假设您已使用默认选项安装包，那么您所要做的只是使用以下内容创建 JSON 文件：

{
  "kube_proxy": {
    "cpus": 0.5,
    "mem": 1024
  }
}

假设文件被保存为 new_options.json，运行：

$ dcos kubernetes update --options=new_options.json

以下为预期输出。请注意，更改以文本 (CHANGED) 进行突出显示：

The following differences were detected between service configurations (CHANGED, CURRENT):
 ==  {
 ==  "kube_proxy": {
 -      "cpus": 0.1,
 +      "cpus": 0.5,
 -      "mem": 512,
 +      "mem": 1024,
 ==  }
 == }

The components of the cluster will be updated according to the changes in the
options file [new_options.json].

Updating these components means the Kubernetes cluster may experience some
downtime or, in the worst-case scenario, cease to function properly.
Before updating proceed cautiously and always backup your data.

This operation is long-running and has to run to completion.
Are you sure you want to continue? [yes/no] yes

2018/03/01 15:40:14 starting update process...
2018/03/01 15:40:15 waiting for update to finish...
2018/03/01 15:41:56 update complete!

值得注意的包选项

某些包选项有着特殊意义，他们必须只在包安装后更新一次，并且仅朝向特定目标值。这些包选项是

kubernetes.cloud_provider：必须只有在选项的初始值是 "" 以及目标值为 "aws" 时进行更新。
kubernetes.high_availability：必须只有在选项的初始值是 false 以及目标值为 true 时进行更新。

此外，一些包选项不得在包被第一次安装后有任何更改。这些包选项是：

etcd.data_disk
etcd.disk_type
etcd.wal_disk
kubernetes.network_provider
kubernetes.service_cidr
service.name
kubernetes.authorization_mode

请确保您理解并尊重这些规则。否则，您可能会使您的集群不可用且面临丢失数据的风险。

更新 `1.2.0-1.10.5` 之前版本中的包选项

如果用户运行 1.2.0-1.10.5 之前的 DC/OS Kubernetes 版本，则强烈建议更新至此版本。如果无法或者不希望进行更新，则强烈建议用户在更新其集群选项（例如，在更新分配给 Kubernetes 节点的 RAM 数量之前）之前，执行一些手动步骤，以避免可能导致更新操作期间集群停机的行为。这些手动步骤包括：重新启动框架调度器，确保其从重新启动中正常恢复，并检测 deploy 计划已达到 COMPLETE 状态。为此，可遵循以下步骤：

强制框架调度器重新启动：
```
$ dcos marathon app kill /<SERVICE_NAME>
```
<SERVICE_NAME> 必须替换为服务名称（如 kubernetes).
确保框架调度器成功恢复，并且 deploy 计划已完成：
```
$ dcos kubernetes --name=<SERVICE_NAME> plan show deploy
deploy (serial strategy) (COMPLETE)
(...)
```
<SERVICE_NAME> 必须替换为服务名称（如 kubernetes)。此命令可能需要几分钟才能开始产生成功结果。

更新和升级 Kubernetes