rancher-docs/i18n/zh/docusaurus-plugin-content-docs/version-2.7/reference-guides/cluster-configuration/rancher-server-configuration/use-existing-nodes/rancher-agent-options.md

title

title
Rancher 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 检索到的值。