跳到主要内容
版本：Latest

Rancher Agent 选项

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

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

通用选项​

参数环境变量描述
--serverCATTLE_SERVER已配置的 Rancher server-url，Agent 将通过这个地址连接 Server。
--tokenCATTLE_TOKEN在 Rancher 中注册节点所需的 Token。
--ca-checksumCATTLE_CA_CHECKSUM使用已配置的 Rancher cacerts 进行 SHA256 校验和验证。
--node-nameCATTLE_NODE_NAME覆盖用于注册节点的主机名（默认为 hostname -s）。
--labelCATTLE_NODE_LABEL向节点添加节点标签。对于多个标签，请传递额外的 --label 选项。(--label key=value)
--taintsCATTLE_NODE_TAINTS将节点污点添加到节点。对于多个污点，请传递额外的 --taints 选项。(--taints key=value:effect)

角色选项​

参数环境变量描述
--all-rolesALL=true将所有角色（etcd、controlplane、worker）应用到节点。
--etcdETCD=true将角色 etcd 应用到节点。
--controlplaneCONTROL=true将角色 controlplane 应用到节点。
--workerWORKER=true将角色 worker 应用到节点。

IP 地址选项​

参数环境变量描述
--addressCATTLE_ADDRESS节点将注册的 IP 地址（默认为用于连接 8.8.8.8的 IP）。
--internal-addressCATTLE_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 检索到的值。