跳到主要内容
版本:v2.9

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将所有角色(etcdcontrolplaneworker)应用到节点。
--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 检索到的值。