#安装机器配置

默认情况下，机器配置不是集群的一部分。它以名为 Alauda Container Platform Machine Configuration 的集群插件形式提供（模块名称为 machine-config），其发布节奏独立于 release stream，并且必须在每个需要管理节点配置的集群上安装一次。

在集群上安装插件之前，概述中介绍的对象均不存在：未注册 MachineConfig、MachineConfigPool 和 MachineConfiguration API，master 和 worker 池、空的 00-master 和 00-worker 配置，以及单例 cluster MachineConfiguration 均不存在。Machine Configuration Operator 首次启动时会创建这些对象。

#前提条件

• 目标集群运行在不可变基础设施上。机器配置管理不可变的节点操作系统，不支持运行在非 Alauda OS 上的节点。
• 目标集群的节点为 Ready，控制平面节点带有 node-role.kubernetes.io/control-plane 标签，而工作节点带有 node-role.kubernetes.io/worker 标签。默认池通过这些标签选择节点。
• 具有访问 global 集群的权限，并拥有创建 ModuleInfo 资源的权限。
• 具有访问 customer portal 的权限，以下载插件软件包。

#下载

从 customer portal 下载 Alauda Container Platform Machine Configuration 软件包。

在同一环境中的每个集群上安装相同版本。有关已发布的版本及每个版本的变更，请参阅 release notes。

#上架

使用 violet push 将下载的软件包上传到 。有关详细的上架操作步骤，包括如何获取 violet 工具，请参阅 Upload Packages。

上架完成后，平台需要几分钟时间同步软件包，然后才能选择该版本。

#安装

每个集群安装一次 Machine Configuration：在 global 集群上安装一次，并在要管理其节点的每个业务集群上安装一次。该插件未声明集群亲和性，因此这两种集群范围均可作为目标。

有关通用的集群插件操作步骤，包括从 Web 控制台进行安装，请参阅 Cluster Plugin。

要使用 YAML 安装，请先在 global 集群上确认插件已发布，并记下版本：

kubectl get moduleplugins machine-config
kubectl get moduleconfigs -l cpaas.io/module-name=machine-config

然后创建一个 ModuleInfo。即使目标是业务集群，也要在 global 集群上应用它：

apiVersion: cluster.alauda.io/v1alpha1
kind: ModuleInfo
metadata:
  labels:
    cpaas.io/cluster-name: <target-cluster>
    cpaas.io/module-name: machine-config
    cpaas.io/module-type: plugin
  name: <target-cluster>-temporary-name
spec:
  config: {}
  version: <version>

• Machine Configuration 不接受任何配置参数，因此 spec.config 保持为空。
• spec.version 必须与已发布 ModuleConfig 的 .spec.version 匹配。
• metadata.name 是临时名称；创建对象后，平台会将其重命名为 <cluster-name>-<hash>。

对其余每个目标集群重复安装操作，并更改 cpaas.io/cluster-name 和临时名称。

#验证安装

在 global 集群上，等待插件为安装了插件的每个集群报告 Running：

kubectl get moduleinfo -l cpaas.io/module-name=machine-config

然后，针对目标集群确认两个组件均已正常运行。控制器在控制平面节点上运行；daemon 在每个节点上运行：

kubectl -n cpaas-system get deployment machine-config-controller
kubectl -n cpaas-system get daemonset machine-config-daemon

最后，确认 operator 已创建初始对象：

kubectl get machineconfigpool

NAME     CONFIG                   UPDATED   UPDATING   DEGRADED   MACHINECOUNT   READYMACHINECOUNT   UPDATEDMACHINECOUNT   DEGRADEDMACHINECOUNT   AGE
master   rendered-master-06c9c4   True      False      False      3              3                   3                     0                      3m
worker   rendered-worker-f4b64    True      False      False      3              3                   3                     0                      3m

kubectl get machineconfig

NAME        IGNITIONVERSION   AGE
00-master   3.4.0             3m
00-worker   3.4.0             3m

kubectl get machineconfiguration cluster

如果池或基础配置未出现，请检查控制器日志——它会在启动时创建所有这些对象：

kubectl -n cpaas-system logs deployment/machine-config-controller

#升级

Machine Configuration 独立于 发布，因此它作为独立插件进行升级，而不是通过集群升级进行升级。它会以 Agnostic 生命周期显示在集群插件列表中。

1. 从 customer portal 下载新版本，并按照初始安装的相同方式上传。
2. 等待平台同步新版本。此过程大约需要 10 到 15 分钟。
3. 前往 管理员 > Marketplace > 集群插件，选择目标集群，然后从插件列表页或插件详情页启动升级。
4. 对安装了该插件的每个集群重复上述操作，确保同一环境中的所有集群运行相同版本。

该插件声明升级风险较低，不会影响正在运行的应用程序。operator 仅在初始对象不存在时创建这些对象，因此升级会保留现有池、基础配置以及你创建的每个 MachineConfig。

有关通用插件升级操作步骤以及每种生命周期的含义，请参阅 集群插件。

#后续步骤

• 管理节点配置
• 节点中断策略