本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文，但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况，请以原始 英文 版本为准，且原始英文版本为权威文本。

SUSE Rancher Prime Agent 选项

Rancher 在每个节点上部署一个 Agent 来与节点通信。本文描述了可以传递给 Agent 的选项。要使用这些选项，你需要使用自定义节点创建集群，并在添加节点时将选项添加到生成的 docker run 命令。

有关 Rancher 如何使用 Node Agent 与下游集群通信的概述，请参阅产品架构。

通用选项

参数 环境变量 描述

--server

CATTLE_SERVER

已配置的 Rancher server-url，Agent 将通过这个地址连接 Server。

--token

CATTLE_TOKEN

在 Rancher 中注册节点所需的 Token。

--ca-checksum

CATTLE_CA_CHECKSUM

使用已配置的 Rancher cacerts 进行 SHA256 校验和验证。

--node-name

CATTLE_NODE_NAME

覆盖用于注册节点的主机名（默认为 hostname -s）。

--label

CATTLE_NODE_LABEL

向节点添加节点标签。对于多个标签，请传递额外的 --label 选项。(--label key=value)

--taints

CATTLE_NODE_TAINTS

将节点污点添加到节点。对于多个污点，请传递额外的 --taints 选项。(--taints key=value:effect)

角色选项

参数 环境变量 描述

--all-roles

ALL=true

将所有角色（etcd、controlplane、worker）应用到节点。

--etcd

ETCD=true

将角色 etcd 应用到节点。

--controlplane

CONTROL=true

将角色 controlplane 应用到节点。

--worker

WORKER=true

将角色 worker 应用到节点。

IP 地址选项

参数 环境变量 描述

--address

CATTLE_ADDRESS

节点将注册的 IP 地址（默认为用于连接 8.8.8.8的 IP）。

--internal-address

CATTLE_INTERNAL_ADDRESS

私有网络上用于主机间通信的 IP 地址。

动态 IP 地址选项

出于自动化目的，你不能在命令中使用特定的 IP 地址，因为它必须是通用的才能用于每个节点。为此，我们提供了动态 IP 地址的选项。它们用作现有 IP 地址选项的值。支持 --address 和 --internal-address。

值 示例 描述

接口名称

--address eth0

将从给定的接口中检索第一个配置的 IP 地址。

ipify

--address ipify

将使用从 https://api.ipify.org 检索到的值。

awslocal

--address awslocal

将使用从 http://169.254.169.254/latest/meta-data/local-ipv4 检索到的值。

awspublic

--address awspublic

将使用从 http://169.254.169.254/latest/meta-data/public-ipv4 检索到的值。

doprivate

--address doprivate

将使用从 http://169.254.169.254/metadata/v1/interfaces/private/0/ipv4/address 检索到的值。

dopublic

--address dopublic

将使用从 http://169.254.169.254/metadata/v1/interfaces/public/0/ipv4/address 检索到的值。

azprivate

--address azprivate

将使用从 http://169.254.169.254/metadata/instance/network/interface/0/ipv4/ipAddress/0/privateIpAddress?api-version=2017-08-01&format=text 检索到的值。

azpublic

--address azpublic

将使用从 http://169.254.169.254/metadata/instance/network/interface/0/ipv4/ipAddress/0/publicIpAddress?api-version=2017-08-01&format=text 检索到的值。

gceinternal

--address gceinternal

将使用从 http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/0/ip 检索到的值。

gceexternal

--address gceexternal

将使用从 http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/0/access-configs/0/external-ip 检索到的值。

packetlocal

--address packetlocal

将使用从 https://metadata.packet.net/2009-04-04/meta-data/local-ipv4 检索到的值。

packetpublic

--address packetlocal

将使用从 https://metadata.packet.net/2009-04-04/meta-data/public-ipv4 检索到的值。