ibmcloud ks cluster addon disable

在现有集群中禁用受管附加组件。 对于要禁用的受管附加组件，此命令必须与下列其中一个子命令组合在一起。

ibmcloud ks cluster addon disable alb-oauth-proxy --cluster CLUSTER

ibmcloud ks cluster addon disable alb-oauth-proxy --cluster my_cluster

ibmcloud ks cluster addon disable debug-tool --cluster CLUSTER [-f]

ibmcloud ks cluster addon disable istio --cluster CLUSTER [-f]

ibmcloud ks cluster addon disable istio-extras --cluster CLUSTER [-f]

ibmcloud ks cluster addon disable istio-sample-bookinfo --cluster CLUSTER

ibmcloud ks cluster addon disable kube-terminal --cluster CLUSTER [-f]

ibmcloud ks cluster addon disable static-route --cluster CLUSTER

ibmcloud ks cluster addon disable vpc-block-csi-driver --cluster CLUSTER [-f]

ibmcloud ks cluster addon enable

在现有集群中启用受管附加组件。 对于要启用的受管附加组件，此命令必须与下列其中一个子命令组合在一起。

ibmcloud ks cluster addon enable alb-oauth-proxy --cluster CLUSTER [--version VERSION]

ibmcloud ks cluster addon enable alb-oauth-proxy --cluster my_cluster

ibmcloud ks cluster addon enable debug-tool --cluster CLUSTER [--version VERSION]

ibmcloud ks cluster addon enable debug-tool --cluster my_cluster

ibmcloud ks cluster addon enable istio --cluster CLUSTER [--version VERSION]

ibmcloud ks cluster addon enable static-route --cluster CLUSTER [--version VERSION]

ibmcloud ks cluster addon enable vpc-block-csi-driver --cluster CLUSTER [--version VERSION]

ibmcloud ks cluster addon get

虚拟私有云 经典基础架构

查看已安装插件的详细信息。

ibmcloud ks cluster addon get --addon ADDON --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--addon ADDON

必须填写：addon 的名称。 要列出已安装的附加组件，请运行 ibmcloud ks cluster addon ls。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster addon ls

虚拟私有云 经典基础架构

列出群集中已启用的任何受管附加组件。

ibmcloud ks cluster addon ls --cluster CLUSTER

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

ibmcloud ks cluster addon options

虚拟私有云 经典基础架构

在启用附加组件之前，请查看其安装选项。

ibmcloud ks cluster addon options --addon ADDON [--output OUTPUT] [-q] [--version VERSION]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--addon ADDON

必须填写：addon 的名称。 要列出可用的附加组件，请运行 ibmcloud ks cluster addon versions。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

--version VERSION

可选：指定要显示选项的附加组件版本。 如果未指定版本，那么将显示缺省版本的选项。 要列出可用的附加组件版本，请运行 ibmcloud ks cluster addon versions。

ibmcloud ks cluster addon update

虚拟私有云 经典基础架构

更新已安装的附加组件。

ibmcloud ks cluster addon update ADD-ON_NAME --cluster CLUSTER [-f] [-q] [--version VERSION] [-y]

最低必需许可权

无

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

--version VERSION

可选: 指定要将附加组件更新到的版本。 如果未指定版本，那么该附加组件将更新为缺省版本。 要列出可用的附加组件版本，请运行 ibmcloud ks cluster addon versions。

ibmcloud ks cluster addon versions

虚拟私有云 经典基础架构

查看 IBM Cloud Kubernetes Service 中支持的受管附加组件版本的列表。

ibmcloud ks cluster addon versions [--addon ADD-ON_NAME] [--output json] [-q]

最低必需许可权

无

命令选项：

--addon ADD-ON_NAME

可选：指定插件名称，如 istio，以筛选版本。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster addon versions --addon istio

ibmcloud ks cluster ca create

虚拟私有云 经典基础架构

为群集创建新的证书颁发机构 (CA)。 创建 CA 并为集群中的组件发放新的 CA 证书后，将自动刷新集群的 API 服务器。

运行此命令之后，在运行 ibmcloud ks cluster ca rotate 命令之前，请执行 在集群中旋转 CA 证书 中的步骤，以确保使用旧 CA 签署的证书的任何工具都将更新为使用新证书并更新工作程序节点。

ibmcloud ks cluster ca create --cluster CLUSTER [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster ca create --cluster my_cluster

ibmcloud ks cluster ca get

虚拟私有云 经典基础架构

查看集群的 CA 证书的详细信息。

ibmcloud ks cluster ca get --cluster CLUSTER [ --output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster ca get --cluster my_cluster

ibmcloud ks cluster ca rotate

虚拟私有云 经典基础架构

轮换群集的证书颁发机构 (CA) 证书。 循环使由集群的先前 CA 签署的证书失效，并将由集群的新 CA 签署的证书发放到工作程序节点。

在运行此命令之前，请遵循 在集群中旋转 CA 证书 中的步骤，以确保使用旧 CA 证书的任何工具都已更新为使用新证书并更新工作程序节点。

ibmcloud ks cluster ca rotate --cluster CLUSTER [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster ca rotate --cluster my_cluster

ibmcloud ks cluster ca status

虚拟私有云 经典基础架构

运行 ibmcloud ks cluster ca rotate 后，查看集群的认证中心 (CA) 证书的轮换状态。

ibmcloud ks cluster ca status --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster ca status --cluster my_cluster

ibmcloud ks cluster config

虚拟私有云 经典基础架构

登录到 IBM Cloud后，将 Kubernetes 配置数据和证书作为 kubeconfig 文件下载到本地计算机，以便您可以连接到集群并运行 kubectl 命令。

kubeconfig 文件将合并到 ~/.kube/config 中的现有 kubeconfig 文件 (在 Windows 中为 <user_profile>/.kube/config ) 或由 KUBECONFIG 环境变量在命令行会话中设置的最后一个文件。 运行 ibmcloud ks cluster config 后，可以立即与集群进行交互，并将上下文快速更改为 Kubernetes 上下文中的其他集群。

ibmcloud ks cluster config --cluster CLUSTER [--admin] [--endpoint ENDPOINT_TYPE] [--network] [--skip-rbac] [-q] [-o]

最低必需许可权

查看者 或 读者 IBM Cloud IBM Cloud Kubernetes Service中集群的 IAM 服务访问角色。 此外，如果您只有平台访问角色或只有服务访问角色，还会有其他限制。

• 平台：如果只有平台访问角色，则可以执行此命令，但需要 服务访问角色 才能在群集中执行 Kubernetes 操作。
• 服务：如果您拥有 service 访问角色，则可以执行此命令。 但是，集群管理员必须通过运行 ibmcloud ks cluster ls 命令或使用 IBM Cloud Kubernetes Service 控制台为您收集集群详细信息。 收到集群名称和标识之后，可以通过 CLI 启动 Kubernetes 仪表板，并使用 Kubernetes。

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--admin

可选：使用此选项需要 Administrator 平台角色。 下载超级用户角色的 TLS 证书和许可权文件。 文件下载到 <user_home_directory>/.bluemix/plugins/kubernetes-service/clusters/<cluster_name>-admin。 证书可以撤销或轮换。 如需了解更多信息，请参阅 在群集中旋转 CA 证书。

--endpoint ENDPOINT_TYPE

可选: 指定用于连接到集群的端点的类型。 如果未指定此选项，那么将使用集群的缺省服务端点。

• private: 如果为集群启用了私有云服务端点，请设置为 private 以将私有云服务端点用于集群上下文。 请注意，您必须位于 IBM Cloud 专用网络中，或者通过 VPC VPN 连接 连接到专用网络，或者对于经典基础架构，经典 VPN 连接 或 IBM Cloud Direct Link。

• vpe: 如果是 VPC 集群，请设置为 vpe 以将虚拟专用端点网关用于集群上下文。 请注意，您必须连接到通过 VPC VPN 连接 部署集群的同一 VPC。

--network

可选：下载 Calico 配置文件、TLS 证书以及在群集中运行 calicoctl 命令所需的权限文件。

--skip-rbac

跳过基于 IBM Cloud IAM 服务访问角色向集群配置添加用户 Kubernetes RBAC 角色的操作。 仅当您管理自己的 Kubernetes RBAC 角色时，才包含此选项。 如果使用 IBM Cloud IAM 服务访问角色 来管理所有 RBAC 用户，请不要包含此选项。

-q

可选：不显示当天的消息或更新提示。

-o

可选：以 YAML、JSON 或 .zip 格式。

ibmcloud ks cluster config --cluster my_cluster

ibmcloud ks cluster create classic

经典基础结构

在经典基础架构上创建具有工作程序节点的集群。

ibmcloud ks cluster create classic [--hardware HARDWARE] --zone ZONE --flavor FLAVOR --name NAME  [--operating-system SYSTEM] [--version MAJOR.MINOR.PATCH] [--no-subnet] [--sm-group GROUP] [--sm-instance INSTANCE] [--private-vlan PRIVATE_VLAN] [--public-vlan PUBLIC_VLAN] [--private-only] [--private-service-endpoint] [--public-service-endpoint] [--workers WORKER] [--disable-disk-encrypt] [--pod-subnet SUBNET] [--service-subnet SUBNET] [--skip-advance-permissions-check] [-q]

要创建 VPC 集群，请改为使用 ibmcloud ks cluster create vpc-gen2 命令。

最低必需许可权

IBM Cloud Kubernetes Service 账户级别的管理员平台访问角色

IBM Cloud Container Registry 账户级别的管理员平台访问角色

对 IBM Cloud 基础架构的超级用户角色

命令选项：

--hardware HARDWARE

工作程序节点的硬件隔离级别。 使用 dedicated，以便可用的物理资源仅供您专用，或者使用 shared 以允许物理资源与其他 IBM 客户共享。 缺省值为 shared。 对于裸机类型模板，请指定 dedicated。

--zone ZONE

要在其中创建集群的专区。 此值对于标准集群是必需的。

查看可用的 经典 或 VPC 区域。 选择您所在国家或地区以外的专区时，请记住，您可能需要法律授权才能将数据实际存储在国外。

--flavor FLAVOR

为工作程序节点选择类型模板（或机器类型）。 可以将工作程序节点作为虚拟机部署在共享或专用硬件上，也可以作为物理机器部署在裸机上。 可用的物理和虚拟类型模板随集群的部署专区而变化。 有关更多信息，请参阅 ibmcloud ks flavors (machine-types) 命令的文档。

--name NAME

必须填写：群集名称。 名称必须以字母开头，可包含字母、数字、句点 (.) 和连字符 (-)，且必须少于或等于 35 个字符。 请使用在各区域中唯一的名称。 集群名称和部署集群的区域构成了 Ingress 子域的标准域名。 为了确保 Ingress 子域在区域内是唯一的，可能会截断 Ingress 域名中的集群名称并附加随机值。

--operating-system UBUNTU_20_64|UBUNTU_24_64

可选。 集群中工作程序节点的操作系统。 如需按集群版本查看可用操作系统列表，请参阅 Kubernetes 版本信息。 如果未指定任何选项，那么将使用与集群版本对应的缺省操作系统。

--version MAJOR.MINOR.PATCH

可选：群集主节点的 Kubernetes 版本。 未指定版本时，会使用受支持 Kubernetes 版本的缺省值来创建集群。 要查看可用版本，请运行 ibmcloud ks versions。

--no-subnet

缺省情况下，将在与集群关联的 VLAN 上创建公用和专用可移植子网。 包括 --no-subnet 选项，以避免在集群中创建子网。 您可以日后为集群创建或添加子网。

--sm-group GROUP

保存秘密的 Secrets Manager 实例的秘密组 ID。 要获取私钥组标识，请参阅 Secrets Manager CLI 参考。

--sm-instance INSTANCE

Secrets Manager 实例的 CRN。 要获取实例的 CRN，请运行 ibmcloud ks ingress instance ls --cluster CLUSTER。

--private-vlan PRIVATE_VLAN

如果此标准群集是您在此区域创建的第一个标准群集，则不包括此选项。 创建集群时，将为您创建专用 VLAN。 如果之前在此专区中已创建标准集群，或者之前在 IBM Cloud 基础架构中已创建专用 VLAN，那么必须指定该专用 VLAN。 专用 VLAN 路由器始终以 bcr（后端路由器）开头，而公用 VLAN 路由器始终以 fcr（前端路由器）开头。 创建集群并指定公用和专用 VLAN 时，在这些前缀之后的数字和字母组合必须匹配。

要查找特定区域是否已经有专用 VLAN，或查找现有专用 VLAN 的名称，请运行 ibmcloud ks vlan ls --zone ZONE。

--public-vlan PUBLIC_VLAN

如果此标准群集是您在此区域创建的第一个标准群集，请勿使用此选项。 创建集群时，将为您创建公用 VLAN。 如果之前在此专区中已创建标准集群，或者之前在 IBM Cloud 基础架构中已创建公用 VLAN，请指定该公用 VLAN。 如果只想将工作节点连接到专用 VLAN，请不要指定此选项。 专用 VLAN 路由器始终以 bcr（后端路由器）开头，而公用 VLAN 路由器始终以 fcr（前端路由器）开头。 创建集群并指定公用和专用 VLAN 时，在这些前缀之后的数字和字母组合必须匹配。

要了解特定区域是否已有公用 VLAN，或查找现有公用 VLAN 的名称，请运行 ibmcloud ks vlan ls --zone ZONE。

--private-only

使用此选项可阻止创建公用 VLAN。 仅当指定 --private-vlan 选项且不包含 --public-vlan 选项时才需要。 如果工人节点只设置了私有 VLAN，则必须启用私有云服务端点或配置网关设备。 有关更多信息，请参阅工作程序与主节点的通信以及用户与主节点的通信。

--private-service-endpoint

通过 VRF 和服务端点启用的 帐户中的标准集群: 启用 私有云服务端点，以便 Kubernetes 主节点和工作程序节点通过专用 VLAN 进行通信。 此外，您还可以选择启用公共云服务端点，使用 --public-service-endpoint 选项通过互联网访问群集。 如果只启用私有云服务端点，则必须连接到私有 VLAN 才能与 Kubernetes 主站通信。 启用私有云服务端点后，就不能再禁用它了。 创建群集后，可通过运行 ibmcloud ks cluster get --cluster <cluster_name_or_ID>.

--public-service-endpoint

启用 公有云服务端点，以便可以通过公有网络访问您的 Kubernetes 主服务器，例如运行 kubectl 来自命令行的命令。 只能在未启用 VRF 的帐户中创建仅公用集群。 如果您具有 使用 VRF 和服务端点启用的帐户 并且还包含 --private-service-endpoint 选项，那么主工作程序节点通信将通过专用网络和公用网络进行。 之后，如果您想要一个纯私有群集，可以禁用公共云服务端点。 创建群集后，可通过运行 ibmcloud ks cluster get --cluster <cluster_name_or_ID>.

--workers WORKERS

可选：指定要包含在群集中的工作节点数量。 缺省值为 1。 如果创建每个专区仅有一个工作程序节点的集群，那么可能会遇到 Ingress 问题。 为实现高可用性，请创建一个群集，每个区域至少有两个工作者。 系统会为每个工作程序节点分配唯一的工作程序节点标识和域名，在创建集群后，不得手动更改该标识和域名。 更改标识或域名会阻止 Kubernetes 主节点管理集群。

--disable-disk-encrypt

工作程序节点缺省情况下具有 AES 256 位磁盘加密功能；了解更多。 要禁用加密，请包括此选项。

--pod-subnet SUBNET

所有部署到 Worker 节点的 pod 默认都会分配一个 172.17.0.0/18 范围内的私有 IP 地址。 如果计划通过 IBM Cloud® Direct Link 或 VPN 服务将集群连接到内部网络，则可以指定一个自定义子网 CIDR，为 pod 提供私有 IP 地址，从而避免子网冲突。

选择子网大小时，请考虑计划创建的集群的大小以及未来可能添加的工作程序节点数。 子网的 CIDR 必须至少为 /23，这样才能为集群中最多四个工作节点提供足够的 pod IP。 对于较大的集群，请使用 /22 为 8 个工作程序节点提供足够的 pod IP 地址，使用 /21 为 16 个工作程序节点提供足够的 pod IP 地址，以此类推。

您选择的子网必须在下列其中一个范围内:

• 172.17.0.0 - 172.17.255.255

• 172.21.0.0 - 172.31.255.255

• 192.168.0.0 - 192.168.255.255

• 198.18.0.0 - 198.19.255.255

请注意，pod 和服务子网不能重叠。 缺省情况下，服务子网在 172.21.0.0/16 范围内。

--service-subnet *SUBNET

缺省情况下，部署到集群的所有服务都会分配有 172.21.0.0/16 范围内的专用 IP 地址。 如果计划通过 IBM Cloud Direct Link 或 VPN 服务将群集连接到内部网络，则可指定一个自定义子网 CIDR，为服务提供私有 IP 地址，从而避免子网冲突。

子网必须以 CIDR 格式指定，大小至少为 /24，这允许集群中最多 255 个服务或更大的服务。 您选择的子网必须在下列其中一个范围内:

• 172.17.0.0 - 172.17.255.255

• 172.21.0.0 - 172.31.255.255

• 192.168.0.0 - 192.168.255.255

• 198.18.0.0 - 198.19.255.255

请注意，pod 和服务子网不能重叠。 缺省情况下，pod 子网在 172.30.0.0/16 范围内。

--skip-advance-permissions-check

可选: 在创建集群之前，跳过 基础架构许可权检查。 请注意，如果您没有正确的基础架构许可权，那么集群创建可能仅会部分成功，例如主供应，但工作程序节点无法供应。 您可以跳过许可权检查，以确定是否要继续以其他方式阻止的操作，例如，当您使用多个基础架构帐户时，如果稍后需要，可以单独处理基础架构资源。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster create classic --zone dal10 --private-vlan my_private_VLAN_ID --flavor b3c.4x16 --name my_cluster --hardware shared --workers 2 --operating-system UBUNTU_20_64

ibmcloud ks cluster create classic --zone dal10 --public-vlan my_public_VLAN_ID --private-vlan my_private_VLAN_ID --flavor b3c.4x16 --name my_cluster --hardware shared --workers 2 --operating-system UBUNTU_20_64

ibmcloud ks cluster create vpc-gen2

虚拟私有云

在第 2 代基础结构上创建具有工作程序节点的虚拟私有云 (VPC) 集群。 登录到 IBM Cloud 帐户时，请将要在其中创建 VPC 集群的 IBM Cloud 区域和资源组设定为目标。 有关支持的区域，请参阅在其他区域中创建 VPC。 集群的资源组可以不同于 VPC 资源组。

具有实例存储器的 VPC Gen 2 集群虚拟硬件样板可用于列入允许列表的帐户。 要添加到允许列表，请在支持下 打开案例。

ibmcloud ks cluster create vpc-gen2 --name NAME --zone ZONE --vpc-id VPC_ID --subnet-id VPC_SUBNET_ID --flavor WORKER_FLAVOR [--cluster-security-group GROUP_ID] [--operating-system SYSTEM] [--version VERSION] [--workers NUMBER_WORKERS_PER_ZONE] [--dedicated-host-pool POOL] [--disable-outbound-traffic-protection] [--disable-public-service-endpoint] [--pod-subnet SUBNET] [--service-subnet SUBNET] [--kms-account-id ID] [--kms-instance KMS_INSTANCE_ID] [--crk ROOT_KEY_ID][--skip-advance-permissions-check] [--sm-group GROUP] [--sm-instance INSTANCE] [-q] [--secondary-storage STORAGE]

最低必需许可权

VPC 基础架构的管理员 平台访问角色。

针对帐户级别的 IBM Cloud Kubernetes Service 的 管理员 平台访问角色。

Writer 或 Manager 服务访问角色，用于 IBM Cloud Kubernetes Service。

针对帐户级别的 IBM Cloud Container Registry 的 管理员 平台访问角色。

命令选项：

--name NAME

必须填写：群集名称。 名称必须以字母开头，可包含字母、数字、句点 (.) 和连字符 (-)，且必须少于或等于 35 个字符。 请使用在各区域中唯一的名称。 集群名称和部署集群的区域构成了 Ingress 子域的标准域名。 为了确保 Ingress 子域在区域内是唯一的，可能会截断 Ingress 域名中的集群名称并附加随机值。

--zone ZONE

需要：选择一个区域来部署初始群集 Worker 池。 如果在多专区大城市中创建集群，那么日后可以向工作程序池添加专区。 要列出可用的 VPC 区域，请运行 ibmcloud ks zone ls --provider vpc-gen2。

选择您所在国家或地区以外的专区时，请记住，您可能需要法律授权才能将数据实际存储在国外。

--vpc-id VPC_ID

必填：要在其中创建群集和工作节点的 VPC 的 ID。 要列出可用的 ID，请运行 ibmcloud ks vpcs。

--subnet-id VPC_SUBNET_ID

必填：分配群集的 VPC 子网。 要列出可用的 VPC 子网，请运行 ibmcloud ks subnets --provider vpc-gen2。

--version VERSION

集群主节点的 Kubernetes 版本。 要查看可用版本，请运行 ibmcloud ks versions。

--flavor FLAVOR

选择工作程序节点的类型模板。 可以将多个工作程序节点作为虚拟机部署在共享或专用硬件上。 要查看某一区域可用的调味品，请运行 ibmcloud ks flavors --zone <vpc_zone> --provider vpc-gen2。

--cluster-security-group GROUP_ID

可选。 指定适用于群集上所有工作者的附加安全组 ID。 对于要添加的每个单独的安全组，必须包含单独的 --cluster-security-group 选项。 要应用 IBM 创建的 kube-clusterID，请使用 --cluster-security-group cluster。 如果未指定值，那么将仅应用 kube-clusterID 和缺省 VPC 安全组。 最多可以将 5 个安全组应用于工作程序，包括缺省安全组。 请注意，仅当未指定其他安全组时，才会应用 VPC 安全组。 有关更多信息，请参阅 在创建期间向集群和工作程序池添加 VPC 安全组。 一旦创建了集群，就无法更改应用于集群的安全组。 您可以更改应用于集群的安全组的规则，但不能在集群级别添加或除去安全组。 如果在集群创建时应用了不正确的安全组，那么必须删除该集群并创建新的安全组。 有关更多信息，请参阅 在创建期间向集群和工作程序池添加 VPC 安全组。

--operating-system UBUNTU_20_64|UBUNTU_24_64

可选。 集群中工作程序节点的操作系统。 如需按集群版本查看可用操作系统列表，请参阅 Kubernetes 版本信息。 如果未指定任何选项，那么将使用与集群版本对应的缺省操作系统。

--preview PREVIEW

可选: 指定一个或多个集群级别预览功能，例如 fips。

--dedicated-host-pool POOL

可选: 要在其中运行工作程序的专用主机池的标识。

--workers NUMBER_WORKERS_PER_ZONE

可选：指定要包含在群集中的工作节点数量。 缺省值为 1。

--disable-outbound-traffic-protection

包含此选项以允许来自集群工作程序的公共出站访问。 缺省情况下，将在 OpenShift 版本 4.15 和更高版本以及 Kubernetes 版本 1.30 和更高版本中阻止公共出站访问。

--disable-public-service-endpoint

要确保工作节点和授权群集用户仅通过私有云服务端点与主控端通信，请加入此选项以创建不含公共云服务端点的群集。

--pod-subnet SUBNET

在 VPC 中创建的第一个集群中，缺省 pod 子网为 172.17.0.0/18。 在该 VPC 中创建的第二个集群中，缺省 pod 子网为 172.17.64.0/18。 在每个后续集群中，pod 子网范围是下一个可用的非重叠 /18 子网。 如果计划通过 IBM Cloud® Direct Link 或 VPN 服务将集群连接到内部网络，则可以指定一个自定义子网 CIDR，为 pod 提供私有 IP 地址，从而避免子网冲突。

选择子网大小时，请考虑计划创建的集群的大小以及未来可能添加的工作程序节点数。 子网的 CIDR 必须至少为 /23，这样才能为集群中最多四个工作节点提供足够的 pod IP。 对于较大的集群，请使用 /22 为 8 个工作程序节点提供足够的 pod IP 地址，使用 /21 为 16 个工作程序节点提供足够的 pod IP 地址，以此类推。

: 所有部署到 Worker 节点的 pod 默认都会分配一个 172.17.0.0/18 范围内的私有 IP 地址。 如果计划通过 IBM Cloud® Direct Link 或 VPN 服务将集群连接到内部网络，则可以指定一个自定义子网 CIDR，为 pod 提供私有 IP 地址，从而避免子网冲突。

对于 VPC 集群，可以通过在 --pod-subnet 选项中包含子网大小来指定子网大小。 例如: --pod-subnet 0.0.0.0/X，其中 X 是必需的 pod 子网大小。 然后，将自动选择 pod 子网。 自动分配 pod 子网时，分配将从 172.17.0.0 开始，最大子网限制为 13，最小子网大小限制为 23。 有关更多信息，请参阅 配置 VPC 子网。 您选择的子网必须在下列其中一个范围内。

• 172.17.0.0 - 172.17.255.255

• 172.21.0.0 - 172.31.255.255

• 192.168.0.0 - 192.168.255.255

• 198.18.0.0 - 198.19.255.255

请注意，pod 和服务子网不能重叠。 如果对工作程序节点使用定制范围子网，那么必须 确保工作程序节点子网与集群的 pod 子网不重叠。

--service-subnet SUBNET

缺省情况下，部署到集群的所有服务都会分配有 172.21.0.0/16 范围内的专用 IP 地址。 如果计划通过 IBM Cloud Direct Link 或 VPN 服务将群集连接到内部网络，则可指定一个自定义子网 CIDR，为服务提供私有 IP 地址，从而避免子网冲突。 子网必须以 CIDR 格式指定，大小至少为 /24，这允许集群中最多 255 个服务或更大的服务。 您选择的子网必须在下列其中一个范围内。

• 172.17.0.0 - 172.17.255.255
• 172.21.0.0 - 172.31.255.255
• 192.168.0.0 - 192.168.255.255
• 198.18.0.0 - 198.19.255.255

请注意，pod 和服务子网不能重叠。

--skip-advance-permissions-check

可选: 在创建集群之前，跳过 基础架构许可权检查。 请注意，如果您没有正确的基础架构许可权，那么集群创建可能仅会部分成功，例如主供应，但工作程序节点无法供应。 您可以跳过许可权检查，以确定是否要继续以其他方式阻止的操作，例如，当您使用多个基础架构帐户时，如果稍后需要，可以单独处理基础架构资源。

--kms-account-id ID

可选项：包含要用于本地磁盘或秘密加密的 KMS 实例的账户 ID。

--kms-instance KMS_INSTANCE_ID

可选: 包含用于对 default 工作程序池中工作程序节点上的本地磁盘进行加密的密钥管理服务 (KMS) 实例的标识。 要列出可用的 KMS 实例，请运行 ibmcloud ks kms instance ls。 如果包含该选项，还必须包含 --crk 选项。 必须先创建 KMS 实例并在 IAM 中设置所需的服务授权，然后才能使用 KMS 加密。 请参阅 管理集群中工作程序节点的加密。

--crk ROOT_KEY

可选: 在 KMS 实例中包含用于对 default 工作程序池中工作程序节点上的本地磁盘进行加密的根密钥的标识。 要列出可用的根密钥，请运行 ibmcloud ks kms crk ls --instance-id。 如果包含该选项，还必须包含 --kms-instance 选项。 必须先创建 KMS 实例并在 IAM 中设置所需的服务授权，然后才能使用 KMS 加密。 请参阅 管理集群中工作程序节点的加密。

--sm-group GROUP

保存秘密的 Secrets Manager 实例的秘密组 ID。 要获取私钥组标识，请参阅 Secrets Manager CLI 参考。

--sm-instance INSTANCE

Secrets Manager 实例的 CRN。 要查找实例的 CRN，请运行 ibmcloud ks ingress instance ls --cluster CLUSTER。

--secondary-storage STORAGE

可选: 类型模板的存储选项。 例如，900gb.5iops-tier。 添加辅助磁盘时，该磁盘用于容器运行时，而主磁盘用于操作系统。 要查看类型模板的存储选项，请运行 **ibmcloud ks flavor get --flavor FLAVOR --zone ZONE --provider vpc-gen2 命令。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster create vpc-gen2 --name mycluster --version 1.32 --zone us-south-1 --vpc-id a0123456-78b9-0c1d-23d4-567890123ef4 --subnet-id 1ab23c45-6789-0123-456d-789ef01gh234 --flavor bx2.4x16 --workers 3

ibmcloud ks cluster get

虚拟私有云 经典基础架构

查看集群的详细信息。

ibmcloud ks cluster get --cluster CLUSTER [--show-resources] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--show-resources

显示更多集群资源，例如附加组件、VLAN、子网和存储器。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster get --cluster my_cluster --show-resources

ibmcloud ks cluster image-security disable

虚拟私有云 经典基础架构

禁用 映像安全性实施。 禁用该功能时，将除去底层 ClusterImagePolicy CRD，这将除去所有缺省映像策略以及您创建的任何定制映像策略。

ibmcloud ks cluster image-security disable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster image-security disable --cluster my_cluster

ibmcloud ks cluster image-security enable

虚拟私有云 经典基础架构

通过在集群中安装 Portieris Kubernetes 许可控制器和关联的缺省映像策略来启用 映像安全实施。

ibmcloud ks cluster image-security enable --cluster CLUSTER [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster image-security enable --cluster my_cluster

ibmcloud ks cluster ls

虚拟私有云 经典基础架构 Satellite

列出 IBM Cloud 帐户中的所有集群。

这将返回所有位置中的集群。 要按特定位置过滤群集，请加入 --location 选项。 例如，如果是按 dal 大城市过滤集群，那么会返回该大城市中的多专区集群以及该大城市内数据中心（专区）中的单专区集群。 如果是按 dal10 数据中心（专区）过滤集群，那么将返回在该专区中具有工作程序节点的多专区集群以及该专区中的单专区集群。 可以传递一个位置，也可以传递以逗号分隔的位置列表。

ibmcloud ks cluster ls [--provider (classic | vpc-gen2)] [--location LOCATION] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--provider (classic | vpc-gen2)

可选：根据基础设施提供商类型过滤输出。

-l, --location LOCATION

按特定位置过滤输出。 要查看支持的位置，请运行 ibmcloud ks locations。 要指定多个位置，每个位置使用一个选项，如 -l dal -l seo。

--output json

可选：以 JSON 格式打印命令输出。 注: 如果不包含 --provider 选项，那么仅返回经典集群。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster ls -l ams03 -l wdc -l ap

ibmcloud ks cluster master audit-webhook

修改用于将 API 服务器审计日志转发到远程服务器的 Webhook 后端。

不推荐使用这些命令的 apiserver-config-get|set|unset audit-webhook 别名。

ibmcloud ks cluster master audit-webhook get --cluster CLUSTER [-q]

ibmcloud ks cluster master audit-webhook get --cluster mycluster

ibmcloud ks cluster master audit-webhook set --cluster CLUSTER [--remote-server SERVER_URL_OR_IP] [--ca-cert CA_CERT_PATH] [--client-cert CLIENT_CERT_PATH] [--client-key CLIENT_KEY_PATH] [--policy POLICY] [-q]

ibmcloud ks cluster master audit-webhook set --cluster my_cluster --remote-server https://audit.example.com/audit --ca-cert /mnt/etc/kubernetes/apiserver audit/ca.pem --client-cert /mnt/etc/kubernetes/apiserver audit/cert.pem --client-key /mnt/etc/kubernetes/apiserver audit/key.pem

ibmcloud ks cluster master audit-webhook unset --cluster CLUSTER [-q]

命令选项

--cluster CLUSTER, -c CLUSTER

指定集群名称或标识。

--output OUTPUT

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

命令选项

--cluster CLUSTER, -c CLUSTER

指定集群名称或标识。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

--type TYPE

指定 OpenShift Web 控制台和 OAuth 服务器访问类型。 接受的值: vpe-gateway，legacy

ibmcloud ks cluster master pod-security get

虚拟私有云 经典基础架构

查看群集 Kubernetes API 服务器的 pod 安全许可配置。

ibmcloud ks cluster master pod-security get --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master pod-security get --cluster mycluster

ibmcloud ks cluster master pod-security policy disable

虚拟私有云 经典基础架构

禁用集群的 Kubernetes API 服务器的 pod 安全策略。

ibmcloud ks cluster master pod-security policy disable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master pod-security policy disable --cluster mycluster

ibmcloud ks cluster master pod-security policy enable

虚拟私有云 经典基础架构

为集群的 Kubernetes API 服务器启用 pod 安全策略。 请注意，pod 安全策略在运行 1.25 或更高版本的集群中不可用。

ibmcloud ks cluster master pod-security policy enable --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master pod-security policy enable --cluster mycluster

ibmcloud ks cluster master pod-security policy get

虚拟私有云 经典基础架构

查看群集 Kubernetes API 服务器的 pod 安全策略配置。 请注意，pod 安全策略在运行 1.25 或更高版本的集群中不可用。

ibmcloud ks cluster master pod-security policy get --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master pod-security policy get --cluster mycluster

ibmcloud ks cluster master pod-security set

虚拟私有云 经典基础架构

设置并启用集群的 Kubernetes API 服务器的 pod 安全许可。

ibmcloud ks cluster master pod-security set --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master pod-security set --cluster mycluster

ibmcloud ks cluster master pod-security unset

虚拟私有云 经典基础架构

除去集群的 Kubernetes API 服务器的 pod 安全许可 配置。

ibmcloud ks cluster master pod-security unset --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master pod-security unset --cluster mycluster

ibmcloud ks cluster master private-service-endpoint allowlist

不再支持专用服务端点允许列表。 尽快从允许列表迁移到基于上下文的限制。 有关更多信息，请参阅 从专用服务端点允许列表迁移到基于上下文的限制(CBR)。

管理私有云服务端点允许列表，以便授权用户只能从允许列表中指定的子网访问私有云服务端点。

ibmcloud ks cluster master private-service-endpoint allowlist add --cluster CLUSTER --subnet SUBNET [--subnet SUBNET ...] [-q]

ibmcloud ks cluster master private-service-endpoint allowlist add --cluster mycluster --subnet 1.1.1.1/16

ibmcloud ks cluster master private-service-endpoint allowlist disable --cluster CLUSTER [-f] [-q]

ibmcloud ks cluster master private-service-endpoint allowlist disable --cluster mycluster

ibmcloud ks cluster master private-service-endpoint allowlist enable --cluster CLUSTER [-f] [-q]

ibmcloud ks cluster master private-service-endpoint allowlist enable --cluster mycluster

ibmcloud ks cluster master private-service-endpoint allowlist get --cluster CLUSTER [-q]

ibmcloud ks cluster master private-service-endpoint allowlist get --cluster mycluster

ibmcloud ks cluster master private-service-endpoint allowlist rm --cluster CLUSTER --subnet SUBNET [--subnet SUBNET ...] [-q]

ibmcloud ks cluster master private-service-endpoint allowlist rm --cluster mycluster
 --subnet 1.1.1.1/16

ibmcloud ks cluster master private-service-endpoint disable

经典基础结构

禁用 私有云服务端点 以除去集群主节点的私有辅助功能选项。

重要：在禁用私有端点之前，必须先完成以下步骤以启用公共云服务端点：

1. 通过运行 ibmcloud ks cluster master public-service-endpoint enable --cluster <cluster_name> 来启用公共云服务端点。
2. 遵循 CLI 中的提示来刷新 Kubernetes 主节点 API 服务器。
3. 重新加载群集中的所有工作节点，以获取公共端点配置。

ibmcloud ks cluster master private-service-endpoint disable --cluster CLUSTER [-f] [-q] [-y]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

-y

可选：刷新集群主节点并重新装入工作程序节点，而不显示用户提示。

ibmcloud ks cluster master private-service-endpoint disable --cluster my_cluster

ibmcloud ks cluster master private-service-endpoint enable

经典基础结构

启用 私有云服务端点，使您的群集主控以私有方式访问。

要运行此命令，请执行以下操作：

1. 在您的 IBM Cloud 基础架构帐户中启用 VRF。 要检查是否已启用 VRF，请使用 ibmcloud account show 命令。
2. 启用 IBM Cloud 帐户以使用服务端点。
3. 运行 ibmcloud ks cluster master private-service-endpoint enable --cluster <cluster_name>。
4. 遵循 CLI 中的提示来刷新 Kubernetes 主节点 API 服务器。
5. 重新装入集群中的所有工作程序节点以选取专用端点配置。

ibmcloud ks cluster master private-service-endpoint enable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

-y

可选：刷新集群主节点并重新装入工作程序节点，而不显示用户提示。

ibmcloud ks cluster master private-service-endpoint enable --cluster my_cluster

ibmcloud ks cluster master public-service-endpoint disable

虚拟私有云 经典基础架构

禁用群集的公共云服务端点。

重要：在禁用公共端点之前，必须先完成以下步骤以启用私有云服务端点：

1. 通过运行 ibmcloud ks cluster master private-service-endpoint enable --cluster <cluster_name> 启用私有云服务端点。
2. 遵循 CLI 中的提示来刷新 Kubernetes 主节点 API 服务器。
3. 重新加载群集中的所有工作节点，以获取私有端点配置。

ibmcloud ks cluster master public-service-endpoint disable --cluster CLUSTER [-q] [-f]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-y

可选：刷新集群主节点并重新装入工作程序节点，而不显示用户提示。

ibmcloud ks cluster master public-service-endpoint disable --cluster my_cluster

ibmcloud ks cluster master public-service-endpoint enable

虚拟私有云 经典基础架构

启用 公共云服务端点，以公开访问群集主控程序。

运行此命令后，必须通过遵循 CLI 中的提示来刷新 API 服务器，才能使用服务端点。

ibmcloud ks cluster master public-service-endpoint enable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

-y

可选：刷新集群主节点，而不显示用户提示。

ibmcloud ks cluster master public-service-endpoint enable --cluster my_cluster

ibmcloud ks cluster master refresh

虚拟私有云 经典基础架构

应用 ibmcloud ks cluster master 命令所要求的 Kubernetes 主站配置更改。 高可用性 Kubernetes 主节点组件以滚动重新启动方式重新启动。 但是，工作程序节点、应用程序和资源不会修改，并且会继续运行。

不推荐使用此命令的 apiserver-refresh 和 cluster-refresh 别名。

ibmcloud ks cluster master refresh --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master update

虚拟私有云 经典基础架构 Satellite

更新 Kubernetes 主服务器和 API 服务器。 更新期间，您无法访问或更改群集。 已部署的工作节点、应用程序和资源不会被修改并继续运行。

您可能需要更改 YAML 文件以供未来部署。 请查看此发行说明以了解详细信息。

不推荐使用此命令的 cluster-update 别名。

ibmcloud ks cluster master update --cluster CLUSTER [--version MAJOR.MINOR.PATCH] [--force-update] [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--version MAJOR.MINOR.PATCH

可选：群集的 Kubernetes 版本。 如果不指定版本，Kubernetes 主站将更新为默认的 API 版本。 要查看可用版本，请运行 ibmcloud ks versions。

--force-update

可选：即使更改与工作节点版本相差两个次版本以上，也要尝试更新。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster master update --cluster my_cluster

ibmcloud ks cluster pull-secret apply

虚拟私有云 经典基础架构

为集群创建 IBM Cloud IAM 服务标识，为该服务标识创建策略，以用于在 IBM Cloud Container Registry 中分配读者服务访问角色，然后为该服务标识创建 API 密钥。 然后，API 密钥会存储在 Kubernetes 镜像拉取密钥中，这样您就可以从 IBM Cloud Container Registry 命名空间为 default Kubernetes 命名空间中的容器拉取镜像。 创建集群时会自动执行此过程。 如果在集群创建过程中遇到错误或具有现有集群，那么可以使用此命令再次应用该过程。

通过使用 IAM API 密钥访问 IBM Cloud Container Registry，您可以为服务 ID 定制 IAM 策略，以限制对命名空间或特定图像的访问。 例如，可以更改集群的映像拉取私钥中的服务标识策略，以仅从特定注册表区域或名称空间中拉取映像。 必须为 IBM Cloud 启用 IBM Cloud Container Registry IAM 策略后，才能定制 IAM 策略。 有关更多信息，请参阅 了解如何授权集群从 IBM Cloud Container Registry 拉取映像。

运行此命令时，IAM 凭证和映像拉取私钥的创建操作将启动，并且可能需要一些时间才能完成。 在创建映像拉取机密之前，无法部署从 IBM Cloud Container Registry icr.io 域拉取映像的容器。 要检查图像提取秘密，请运行 kubectl get secrets | grep icr-io。 如果向现有服务标识添加了 IAM 策略，例如用于限制对区域注册表的访问，那么此命令将重置映像拉取私钥的服务标识、IAM 策略和 API 密钥。

ibmcloud ks cluster pull-secret apply --cluster CLUSTER

最低必需许可权：

• 中群集的操作员或管理员平台访问角色 IBM Cloud Kubernetes Service
• 在 IBM Cloud Container Registry 中跨所有区域和资源组的管理员平台访问角色。 该策略不能作用于特定区域或资源组。

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

ibmcloud ks cluster rm

虚拟私有云 经典基础架构

删除集群。 所有工作程序节点、应用程序和容器都将永久删除。 此操作无法撤销。

ibmcloud ks cluster rm --cluster CLUSTER [--force-delete-storage] [--skip-advance-permissions-check] [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--force-delete-storage

可选：删除群集和群集使用的任何持久存储。 注意：如果包含此选项，则无法恢复群集或其相关存储实例中存储的数据。

--skip-advance-permissions-check

可选: 在删除集群之前，跳过 基础架构许可权检查。 请注意，如果您没有正确的基础架构许可权，那么集群删除可能只会部分成功，例如要除去的 IBM管理的主节点，但无法从基础架构帐户中除去工作程序节点。 您可以跳过许可权检查，以确定是否要继续以其他方式阻止的操作，例如，当您使用多个基础架构帐户时，如果稍后需要，可以单独处理基础架构资源。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster rm --cluster my_cluster

ibmcloud ks cluster service bind

虚拟私有云 经典基础架构

通过将 IBM Cloud 服务实例绑定到 Kubernetes 名称空间，将该服务添加到集群。 此命令将创建 IBM Cloud 服务的服务凭证，并将这些凭证存储在集群的 Kubernetes 私钥中。

要查看 IBM Cloud 目录中的可用 IBM Cloud 服务，请运行 ibmcloud service offerings。 注：只能添加支持服务密钥的 IBM Cloud 服务。 有关服务绑定以及可以将哪些服务添加到集群的更多信息，请参阅使用 IBM Cloud 服务绑定来添加服务。

ibmcloud ks cluster service bind --cluster CLUSTER --namespace KUBERNETES_NAMESPACE [--key SERVICE_INSTANCE_KEY] [--role IAM_SERVICE_ROLE] --service SERVICE_INSTANCE [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-n, --namespace KUBERNETES_NAMESPACE

必须填写：Kubernetes 命名空间的名称，您要在此为服务凭据创建 Kubernetes 秘密。

--key SERVICE_INSTANCE_KEY

可选：现有服务密钥的名称或 GUID。 使用 service-binding 命令时，会自动为服务实例创建新的服务凭证，并为启用 IAM 的服务分配 IAM 写入者服务访问角色。 如果要使用先前创建的现有服务密钥，请使用此选项。 如果定义了服务密钥，就不能同时设置 --role 选项，因为服务密钥已经用特定的 IAM 服务访问角色创建。

--role IAM_SERVICE_ROLE

您希望服务密钥具有的 IBM Cloud IAM 角色。 此值是可选的，并且只能用于启用 IAM 的服务。 如果不设置该选项，则会自动创建服务凭证并分配 IAM Writer 服务访问角色。 如果希望通过指定 --key 选项来使用现有的服务密钥，请不要包含此选项。 要列出服务的可用角色，请运行 ibmcloud iam roles --service <service_name>。 服务名称是服务在目录中的名称，可以通过运行 ibmcloud catalog search 来获取。

--service SERVICE_INSTANCE

必须填写：要绑定的 IBM Cloud 服务实例的名称。 要查找名称，请运行 ibmcloud resource service-instances。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster service bind --cluster my_cluster --namespace my_namespace --service my_service_instance

ibmcloud ks cluster service ls

虚拟私有云 经典基础架构

列出绑定到群集中一个或所有 Kubernetes 命名空间的服务。 如果未指定任何选项，那么将显示缺省名称空间的服务。

ibmcloud ks cluster service ls --cluster CLUSTER [--namespace KUBERNETES_NAMESPACE] [--all-namespaces] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-n, --namespace KUBERNETES_NAMESPACE

可选：包括绑定到群集中特定命名空间的服务。

--all-namespaces

可选：包括绑定到群集中所有命名空间的服务。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster service ls --cluster my_cluster --namespace my_namespace

ibmcloud ks cluster service unbind

虚拟私有云 经典基础架构

通过将 IBM Cloud 服务与 Kubernetes 名称空间取消绑定，从集群中除去该服务。

除去 IBM Cloud 服务时，会从集群中除去服务凭证。 如果 pod 仍在使用服务，则会因找不到服务凭据而失败。

ibmcloud ks cluster service unbind --cluster CLUSTER --namespace KUBERNETES_NAMESPACE --service SERVICE_INSTANCE [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-n, --namespace KUBERNETES_NAMESPACE

必须填写：Kubernetes 命名空间的名称。

--service SERVICE_INSTANCE

必须填写：要删除的 IBM Cloud 服务实例的名称。 要查找服务实例的名称，请运行 ibmcloud ks cluster service ls --cluster <cluster_name_or_ID>。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster service unbind --cluster my_cluster --namespace my_namespace --service 8567221

ibmcloud ks cluster subnet add

经典基础结构

使 IBM Cloud 基础架构帐户中的现有可移植公用或专用经典子网可供集群使用，或者复用已删除集群中的子网，而不使用自动供应的子网。

使子网可供集群使用时，此子网的 IP 地址会用于集群联网。 为了避免 IP 地址冲突，请确保一个子网只用于一个集群。 不要同时将一个子网用于多个集群或用于 IBM Cloud Kubernetes Service 外部的其他用途。 如果在多个集群中使用同一子网，那么缺省 Ingress TLS 证书可能会失效。 要在非 VRF 账户中同一 VLAN 不同子网的工作人员之间进行通信，必须 启用同一 VLAN 子网之间的路由。

ibmcloud ks cluster subnet add --cluster CLUSTER --subnet-id SUBNET [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--subnet-id SUBNET

必填：子网 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster subnet add --cluster my_cluster --subnet-id 1643389

ibmcloud ks cluster subnet create

经典基础结构

在公用或专用 VLAN 上 IBM Cloud 基础架构帐户中创建可移植经典子网，并使其可供集群使用。

可移植公共 IP 地址按月收费。 如果在供应集群后除去可移植公共 IP 地址，那么即使只使用了很短的时间，您也仍然必须支付一个月的费用。 使子网可供集群使用时，此子网的 IP 地址会用于集群联网。 为了避免 IP 地址冲突，请确保一个子网只用于一个集群。 不要同时将一个子网用于多个集群或用于 IBM Cloud Kubernetes Service 外部的其他用途。 如果在多个集群中使用同一子网，那么缺省 Ingress TLS 证书可能会失效。 在经典集群中，如果有多个 VLAN 用于集群，有多个子网位于同一 VLAN 上，或有一个多专区经典集群，那么必须针对 IBM Cloud 基础架构帐户启用虚拟路由器功能 (VRF)，从而使工作程序节点可以在专用网络上相互通信。 要启用 VRF，请参阅 启用 VRF。 要检查是否已启用 VRF，请使用 ibmcloud account show 命令。 如果无法或不想启用 VRF，请启用 VLAN 生成。 要执行此操作，需要有“网络”>“管理网络 VLAN 跨基础架构”权限，或者可以要求账户所有者启用该权限。 要检查 VLAN spanning 是否已启用，请使用 ibmcloud ks vlan spanning get --region <region> 命令。

ibmcloud ks cluster subnet create --cluster CLUSTER --size SIZE --vlan VLAN_ID [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。 要列出集群，请使用 ibmcloud ks cluster ls 命令。

--size SIZE

要在可移植子网中创建的 IP 地址数。 接受的值为 8、16、32 或 64。 添加子网的可移植 IP 地址时，会使用 3 个 IP 地址来建立集群内部联网。 您不能将这三个 IP 地址用于 Ingress 应用程序负载平衡器 (ALB) 或创建网络负载平衡器 (NLB) 服务。 例如，如果请求 8 个可移植公共 IP 地址，那么可以使用其中 5 个地址向公众公开应用程序。

--vlan VLAN_ID

要在其中创建子网的公用或专用 VLAN 的标识。 必须选择现有工作程序节点连接到的公用或专用 VLAN。 要查看工人节点连接的公用或专用 VLAN，请运行 ibmcloud ks cluster get --cluster <cluster> --show-resources 并在输出中查找子网 VLAN 部分。 子网会在 VLAN 所在的区域中进行供应。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster subnet create --cluster my_cluster --size 8 --vlan 1764905

ibmcloud ks cluster subnet detach

经典基础结构

将 IBM Cloud 基础设施账户中的公共或私有便携式经典子网从群集中分离出来。 子网在 IBM Cloud 基础架构帐户中仍然可用。 注：除去子网后，部署到该子网中 IP 地址的任何服务仍将保持活动状态。

ibmcloud ks cluster subnet detach --cluster CLUSTER --subnet-id SUBNET_ID [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。 要列出集群，请使用 ibmcloud ks cluster ls 命令。

--vlan VLAN_ID

要拆离的公用或专用子网的标识。 要查找子网 ID，首先运行 ibmcloud ks cluster get --cluster <cluster> --show-resources，然后在输出的子网 VLAN 部分查找子网 CIDR。 然后，使用子网 CIDR，运行 ibmcloud ks subnets --provider classic 并查找子网 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks cluster subnet detach --cluster my_cluster --subnet-id 1602829

不推荐：ibmcloud ks cluster user-subnet add

经典基础结构

将您自己的专用子网置于 IBM Cloud Kubernetes Service 集群中。 此专用子网不是 IBM Cloud 基础架构提供的子网。 因此，您必须为子网配置任何入站和出站网络流量路由。

不推荐使用该命令。 通过运行 ibmcloud ks cluster subnet add 将现有 IBM Cloud 基础架构子网添加到集群。

使子网可供集群使用时，此子网的 IP 地址会用于集群联网。 为了避免 IP 地址冲突，请确保一个子网只用于一个集群。 不要同时将一个子网用于多个集群或用于 IBM Cloud Kubernetes Service 外部的其他用途。 如果在多个集群中使用同一子网，那么缺省 Ingress TLS 证书可能会失效。 在经典集群中，如果有多个 VLAN 用于集群，有多个子网位于同一 VLAN 上，或有一个多专区经典集群，那么必须针对 IBM Cloud 基础架构帐户启用虚拟路由器功能 (VRF)，从而使工作程序节点可以在专用网络上相互通信。 要启用 VRF，请参阅 启用 VRF。 要检查是否已启用 VRF，请使用 ibmcloud account show 命令。 如果无法或不想启用 VRF，请启用 VLAN 生成。 要执行此操作，需要有“网络”>“管理网络 VLAN 跨基础架构”权限，或者可以要求账户所有者启用该权限。 要检查 VLAN spanning 是否已启用，请使用 ibmcloud ks vlan spanning get --region <region> 命令。

ibmcloud ks cluster user-subnet add --cluster CLUSTER --subnet-cidr SUBNET_CIDR --private-vlan PRIVATE_VLAN

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--subnet-cidr SUBNET_CIDR

子网无类域间路由 (CIDR)。 此值是必需的，且不得与 IBM Cloud 基础架构使用的任何子网相冲突。 支持的前缀范围从 /30（1 个 IP 地址）到 /24（253 个 IP 地址）。 如果将 CIDR 设置为一个前缀长度，而稍后需要对其进行更改，请先添加新的 CIDR，然后除去旧 CIDR。

--private-vlan PRIVATE_VLAN

必填：专用 VLAN 的 ID。 该标识必须用于一个或多个工作程序节点所在的集群中的专用 VLAN。 要查看群集中的专用 VLAN，请运行 ibmcloud ks cluster get --cluster <cluster_name_or_ID> --show-resources。 在输出的 Subnet VLANs 部分中，查找 Public 值为 false 的 VLAN。

ibmcloud ks cluster user-subnet add --cluster my_cluster --subnet-cidr 169.xx.xxx.xxx/29 --private-vlan 1502175

不推荐：ibmcloud ks cluster user-subnet rm

经典基础结构

从指定集群除去您自己的专用子网。 除去子网后，部署到您自己专用子网的 IP 地址的任何服务都仍将保持活动状态。

不推荐使用该命令。 要改为从集群中除去 IBM Cloud 基础架构子网，请运行 ibmcloud ks cluster subnet detach。

ibmcloud ks cluster user-subnet rm --cluster CLUSTER --subnet-cidr SUBNET_CIDR --private-vlan PRIVATE_VLAN

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--subnet-cidr SUBNET_CIDR

子网无类域间路由 (CIDR)。 此值是必需的，并且必须与 ibmcloud ks cluster user-subnet add 命令设置的 CIDR 匹配。

--private-vlan PRIVATE_VLAN

专用 VLAN 的标识。 此值是必需的，并且必须与 ibmcloud ks cluster user-subnet add 命令设置的 VLAN 标识匹配。

ibmcloud ks cluster user-subnet rm --cluster my_cluster --subnet-cidr 169.xx.xxx.xxx/29 --private-vlan 1502175

Beta： ibmcloud ks dedicated flavors

虚拟私有云

查看专用主机特色。

ibmcloud ks dedicated flavors --zone ZONE --provider PROVIDER

最低必需许可权

IBM Cloud Kubernetes Service中集群的 操作员 平台访问角色。

命令选项：

--zone ZONE

用于搜索专用主机特色的区域。

--provider PROVIDER

用于搜索专用主机特色的提供程序。

--output json

可选：以 JSON 格式打印命令输出。

示例：

ibmcloud ks dedicated flavors --zone us-south-1 --provider myprovider1

Beta： ibmcloud ks dedicated host create

虚拟私有云

创建专用主机。

ibmcloud ks dedicated host create --flavor FLAVOR --pool POOL --zone ZONE [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 操作员 平台访问角色。

命令选项：

-- flavor FLAVOR

专用主机的特色。

-- pool POOL

在其中添加专用主机的专用主机池的名称。

--zone ZONE

用于创建专用主机的区域。

--output json

可选：以 JSON 格式打印命令输出。

示例：

ibmcloud ks dedicated host create --flavor b3c.4x16 --pool mypool --zone wdc

Beta： ibmcloud ks dedicated host get

虚拟私有云

获取专用主机的详细信息。

ibmcloud ks dedicated host get --host HOST --pool POOL [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 查看者 平台访问角色。

命令选项：

--host HOST

专用主机的标识。

--pool POOL

专用主机所在的专用主机池的标识。 要列出专用主机池，请运行 ibmcloud ks dedicated pool ls。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated host get --host myhost  --pool mypool

Beta： ibmcloud ks dedicated host ls

虚拟私有云

列出专用主机池中的所有专用主机。

ibmcloud ks dedicated host ls --pool POOL [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 查看者 平台访问角色。

命令选项：

--pool POOL

专用主机池的标识。 要列出专用主机池，请运行 ibmcloud ks dedicated pool ls。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated host ls --pool mypool

Beta： ibmcloud ks dedicated host placement disable

虚拟私有云

禁用专用主机放置。

ibmcloud ks dedicated host placement disable --host HOST --pool POOL

最低必需许可权

IBM Cloud Kubernetes Service中集群的 管理员 平台访问角色。

命令选项：

--host HOST

要禁用放置的专用主机的标识。

--pool POOL

专用主机所在的专用主机池的标识。 要列出专用主机池，请运行 ibmcloud ks dedicated pool ls。

--q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated host placement disable --host myhost --pool mypool

Beta： ibmcloud ks dedicated host placement enable

虚拟私有云

启用专用主机放置。

ibmcloud ks dedicated host placement enable --host HOST --pool POOL

最低必需许可权

IBM Cloud Kubernetes Service中集群的 管理员 平台访问角色。

命令选项：

--host HOST

要为其启用放置的专用主机的标识。

--pool POOL

专用主机所在的专用主机池的标识。 要列出专用主机池，请运行 ibmcloud ks dedicated pool ls。

--q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated host placement enable --host myhost --pool mypool

Beta： ibmcloud ks dedicated host rm

虚拟私有云

删除专用主机。 此操作无法撤销。

ibmcloud ks dedicated host rm --host HOST --pool POOL [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 管理员 平台访问角色。

命令选项：

--pool POOL

包含要删除的专用主机的专用主机池 ID。 要列出专用主机池，请运行 ibmcloud ks dedicated pool ls。

--output json

可选：以 JSON 格式打印命令输出。

--q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated host rm --host myhost --pool mypool

Beta： ibmcloud ks dedicated pool create

虚拟私有云

创建专用主机池。

ibmcloud ks dedicated pool create --flavor-class CLASS --metro METRO --name NAME [--output OUTPUT]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 管理员 平台访问角色。

命令选项：

--flavor-class CLASS

专用主机池的 flavor-class。 要查看可用选项，请运行 ibmcloud ks flavors。

--metro METRO

创建专用主机池的都会，如 dal 或 wdc。

--name NAME

专用主机池的名称。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated pool --flavor-class mb4c.20x64 --metro dal --name mypool

Beta： ibmcloud ks dedicated pool get

虚拟私有云

获取专用主机池的详细信息。

ibmcloud ks dedicated pool get --pool POOL [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 查看者 平台访问角色。

命令选项：

--pool POOL

专用主机池的标识。 要列出专用主机池，请运行 ibmcloud ks dedicated pool ls。

--output OUTPUT

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated pool get --pool mypool

Beta： ibmcloud ks dedicated pool ls

虚拟私有云

列出所有专用主机池。

ibmcloud ks dedicated pool ls [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 查看者 平台访问角色。

命令选项：

--output json

可选：以 JSON 格式打印命令输出。

--q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated pool ls

Beta： ibmcloud ks dedicated pool rm

虚拟私有云

删除专用主机池。 此操作无法撤销。

ibmcloud ks dedicated pool rm --pool POOL [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 管理员 平台访问角色。

命令选项：

--pool POOL

要删除的专用主机池的 ID。 要列出专用主机池，请运行 ibmcloud ks dedicated pool ls。

--q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks dedicated pool rm --pool mypool

不推荐：ibmcloud ks worker add

虚拟私有云 经典基础架构

向集群添加独立工作程序节点。

不推荐使用该命令。 运行 ibmcloud ks worker-pool create classic 或 ibmcloud ks worker-pool create vpc-gen2 来创建工人池，或通过运行 ibmcloud ks worker-pool resize.

ibmcloud ks worker add --cluster CLUSTER [--hardware HARDWARE] --flavor FLAVOR --workers NUMBER --private-vlan PRIVATE_VLAN --public-vlan PUBLIC_VLAN [--disable-disk-encrypt] [--operating-system SYSTEM] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--hardware HARDWARE

可选：工作节点的硬件隔离级别。 使用 dedicated，以便可用的物理资源仅供您专用，或者使用 shared 以允许物理资源与其他 IBM 客户共享。 缺省值为 shared。 对于裸机类型模板，请指定 dedicated。

--flavor FLAVOR

为工作程序节点选择机器类型（或类型模板）。 可以将工作程序节点作为虚拟机部署在共享或专用硬件上，也可以作为物理机器部署在裸机上。 可用的物理和虚拟机类型随集群的部署专区而变化。 有关更多信息，请参阅 ibmcloud ks flavors (machine-types) 命令的文档。

--workers NUMBER

整数，表示要在集群中创建的工作程序节点数。

--private-vlan PRIVATE_VLAN

必须填写：创建群集时指定的专用 VLAN。 专用 VLAN 路由器始终以 bcr（后端路由器）开头，而公用 VLAN 路由器始终以 fcr（前端路由器）开头。 创建集群并指定公用和专用 VLAN 时，在这些前缀之后的数字和字母组合必须匹配。

--public-vlan PUBLIC_VLAN

可选：创建群集时指定的公共 VLAN。 如果您希望工作节点只存在于专用 VLAN 上，请不要提供公用 VLAN ID。 专用 VLAN 路由器始终以 bcr（后端路由器）开头，而公用 VLAN 路由器始终以 fcr（前端路由器）开头。 创建集群并指定公用和专用 VLAN 时，在这些前缀之后的数字和字母组合必须匹配。 如果工人节点只设置了私有 VLAN，则必须通过 启用私有云服务端点 或 配置网关设备，允许工人节点和群集主控进行通信。

--disable-disk-encrypt

工作程序节点缺省情况下具有 AES 256 位磁盘加密功能；了解更多。 要禁用加密，请包括此选项。

--operating-system UBUNTU_20_64|UBUNTU_24_64

可选。 集群中工作程序节点的操作系统。 如需按集群版本查看可用操作系统列表，请参阅 Kubernetes 版本信息。 如果未指定任何选项，那么将使用与集群版本对应的缺省操作系统。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker add --cluster my_cluster --workers 3 --public-vlan my_public_VLAN_ID --private-vlan my_private_VLAN_ID --flavor b3c.4x16 --hardware shared

ibmcloud ks worker get

虚拟私有云 经典基础架构

查看工作程序节点的详细信息。

ibmcloud ks worker get --cluster CLUSTER_NAME_OR_ID --worker WORKER_NODE_ID [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER_NAME_OR_ID

可选：工作节点群集的名称或 ID。

--worker WORKER_NODE_ID

必须填写：工作节点的名称。 运行 ibmcloud ks worker ls --cluster CLUSTER 查看群集中工作节点的 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker get --cluster my_cluster --worker kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w1

ibmcloud ks worker ls

虚拟私有云 经典基础架构

列出一个集群中的所有工作程序节点。

ibmcloud ks worker ls --cluster CLUSTER [--worker-pool POOL] [--show-pools] [--show-deleted] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：可用工作节点的群集名称或 ID。

-p, --worker-pool POOL

可选：只查看属于工人池的工人节点。 要列出可用的工人池，请运行 ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>。

--show-pools

可选：列出每个工作节点所属的工作池。

--show-deleted

可选：查看从群集中删除的工作节点，包括删除原因。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker ls --cluster my_cluster

ibmcloud ks worker reboot

虚拟私有云 经典基础架构

重新引导集群中的工作程序节点。

在重新引导期间，工作程序节点的状态不会更改。 例如，如果经典 IBM Cloud 基础架构中的工作节点状态为 Powered Off，而您需要打开工作节点，您可能会使用重启。 重新引导将清除临时目录，但不会清除整个文件系统或重新格式化磁盘。 在执行重新引导操作后，工作程序节点 IP 地址保持不变。

重新引导工作程序节点可能导致工作程序节点上发生数据损坏。 请谨慎使用此命令，仅在确信重新引导可以帮助恢复工作程序节点时使用。 在其他所有情况下，请改为重新装入工作程序节点。

在重新引导工作程序节点之前，请确保其他工作程序节点中有足够的容量来重新调度工作程序节点上的 pod。 重新安排 pod 可避免应用程序宕机或工作节点上的数据损坏。

1. 列出集群中的所有工作程序节点，并记下要除去的工作程序节点的 name。

   kubectl get nodes
   

   此命令中返回的 name 是分配给工作程序节点的专用 IP 地址。 在运行 ibmcloud ks worker ls --cluster <cluster_name_or_ID> 命令并查找具有相同私有 IP 地址的工作节点时，您可以找到有关工作节点的更多信息。

2. 强制从工作程序节点中除去 pod，并将其重新安排到集群中的剩余工作程序节点上。 工作程序节点也会被封锁，或者标记为不可用于将来的 pod 调度。 将 <worker_name> 替换为先前检索的工作程序节点的专用 IP 地址。

   kubectl drain <worker_name>
   

   此过程可能需要几分钟时间。

3. 重新引导工作程序节点。 使用 ibmcloud ks worker ls --cluster <cluster_name_or_ID> 命令返回的工人 ID。

   ibmcloud ks worker reboot --cluster <cluster_name_or_ID> --worker <worker_name_or_ID>
   

4. 等待大约 5 分钟后，才能使工作程序节点可用于 pod 安排，以确保重新引导完成。 在重新引导期间，工作程序节点的状态不会更改。 工作程序节点的重新引导通常在几秒后完成。

5. 使工作程序节点可用于 pod 安排。 请使用从 ** 命令返回的工作程序节点的 **namekubectl get nodes。

   kubectl uncordon <worker_name>
   

ibmcloud ks worker reboot [--hard] --cluster CLUSTER --worker WORKER_ID [--skip-master-healthcheck] [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--hard

可选：使用此选项可切断工作节点的电源，强制重新启动工作节点。 如果工作程序节点无响应或工作程序节点的容器运行时无响应，请使用此选项。

-w, --worker WORKER

指定工作程序节点标识。 要重载多个工作节点，请使用多个选项，如 -w worker1_id -w worker2_id。

--skip-master-healthcheck

在重新装入或重新引导工作程序节点之前，跳过对主节点的运行状况检查。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker reboot --cluster my_cluster -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w1 -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w2

ibmcloud ks worker reload

经典基础结构

重新加载经典工作节点的配置。 要重新加载 VPC 集群中的工作节点，请使用 ibmcloud ks worker replace 命令。

如果工作程序节点遇到问题（例如，性能降低），或者如果工作程序节点卡在非正常运行状态，那么重新装入会非常有用。 在重新装入期间，工作程序节点机器将使用最新映像进行更新，并且如果数据未存储在工作程序节点外部，那么将删除数据。 在执行重新装入操作后，工作程序节点公共和专用 IP 地址保持不变。

重新装入工作程序节点会将补丁版本更新应用于工作程序节点，但不会应用主要或次要更新。 要查看从一个补丁版本到下一个补丁版本的更改，请查看 版本更改日志 文档。

在重新装入工作程序节点之前，请确保其他工作程序节点中有足够的容量来重新调度工作程序节点上的 pod。 重新安排 pod 可避免应用程序宕机或工作节点上的数据损坏。

1. 列出集群中的所有工作程序节点，并记下要重新装入的工作程序节点的 name。

   kubectl get nodes
   

   此命令中返回的 name 是分配给工作程序节点的专用 IP 地址。 在运行 ibmcloud ks worker ls --cluster <cluster_name_or_ID> 命令并查找具有相同私有 IP 地址的工作节点时，您可以找到有关工作节点的更多信息。

2. 重新装入工作程序节点。 在重新装入过程中，会将在工作程序节点上运行的 pod 排出并重新调度到集群中的其余工作程序节点上。 工作程序节点也会被封锁，或者标记为不可用于将来的 pod 调度。 使用 ibmcloud ks worker ls --cluster <cluster_name_or_ID> 命令返回的工作节点 ID。

   ibmcloud ks worker reload --cluster <cluster_name_or_ID> --worker <worker_name_or_ID>
   

3. 等待重新装入完成。 当工作程序节点处于“正常”状态时，该工作程序节点将再次可用于 pod 调度。

ibmcloud ks worker reload --cluster CLUSTER --worker WORKER_ID [--skip-master-healthcheck] [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-w, --worker WORKER

指定工作程序节点标识。 要重载多个工作节点，请使用多个选项，如 -w worker1_id -w worker2_id。

--skip-master-healthcheck

在重新装入或重新引导工作程序节点之前，跳过对主节点的运行状况检查。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker reload --cluster my_cluster -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w1 -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w2

ibmcloud ks worker replace

虚拟私有云 经典基础架构

删除工作程序节点，并将其替换为同一工作程序池中的新工作程序节点。

替换的工作节点在同一区域创建，与旧的工作节点具有相同的功能，但可能会分配新的公共或私有 IP 地址。 如果无法重新加载或更新工作节点，例如工作节点进入故障状态，则可能需要替换工作节点。

您也可以使用该命令更新工作节点的 Kubernetes 版本，使其与 Kubernetes 主节点的主次版本相匹配，方法是加入 --update 选项。 如果不包含 --update 选项，补丁版本更新会应用到工作节点，但不会应用到主要或次要更新。 要查看从一个主要版本、次要版本或补丁版本到下一个版本的更改，请查看 版本更改日志 文档。 请记住，工作程序节点最多只能比主版本 (n-2) 落后两个版本。

更换工作程序节点时，请记住以下注意事项。

要更新 Satellite 工作程序节点，请参阅 更新分配为支持 Satellite的服务的工作程序节点的主机。

• 同时更换多个工作程序节点: 如果同时更换多个工作程序节点，那么将同时删除并更换这些节点，而不是逐个更换。 在更换工作程序节点之前，请确保集群中有足够的容量来重新调度工作负载。
• 不会保留Node级别定制: 不会将您在个别工作程序节点级别应用的任何定制标签或污点应用于替换工作程序节点。 而是在工作程序池级别应用 labels 或 taints，以便替换工作程序节点获取这些属性。
• 自动重新平衡: 如果工作程序池未启用 自动重新平衡，那么不会创建替换工作程序节点。

开始之前，请确保集群具有足够的其他工作程序节点，以便可以重新调度 pod 并继续运行。

1. 列出集群中的所有工作程序节点，并记下要替换的工作程序节点的 name。

   kubectl get nodes
   

   此命令中返回的 name 是分配给工作程序节点的专用 IP 地址。 在运行 ibmcloud ks worker ls --cluster <cluster_name_or_ID> 命令并查找具有相同私有 IP 地址的工作节点时，您可以找到有关工作节点的更多信息。

2. 替换工作程序节点。 在替换过程中，会将在工作程序节点上运行的 pod 排出并重新调度到集群中的其余工作程序节点上。 工作程序节点也会被封锁，或者标记为不可用于将来的 pod 调度。 使用 ibmcloud ks worker ls --cluster <cluster_name_or_ID> 命令返回的工作节点 ID。

   ibmcloud ks worker replace --cluster <cluster_name_or_ID> --worker <worker_node_ID>
   

3. 验证工作程序节点是否已替换。

   ibmcloud ks worker ls --cluster <cluster_name_or_ID>
   

ibmcloud ks worker replace --cluster CLUSTER_NAME_OR_ID --worker WORKER_ID [--update] [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 操作员 平台访问角色。

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--worker WORKER

必须填写：工作节点的名称或 ID。

--update

包含此选项可将工作节点更新为与主节点和最新补丁相同的主次版本。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker replace --cluster my_cluster --worker kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w1

ibmcloud ks worker rm

虚拟私有云 经典基础架构

从集群中除去一个或多个工作程序节点。 如果除去工作程序节点，那么集群将变得不平衡，并且 更换工作程序节点 将不再创建更换工作程序节点。 在除去工作程序节点后，可以通过运行 ibmcloud ks worker-pool rebalance 命令 来自动重新平衡工作程序池。

ibmcloud ks worker rm --cluster CLUSTER --worker WORKER [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-w, --worker WORKER

指定工作程序节点标识。 要重载多个工作节点，请使用多个选项，如 -w worker1_id -w worker2_id。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker rm --cluster my_cluster -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w1 -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w2

ibmcloud ks worker update

经典基础结构

更新工作程序节点以将最新的安全性更新和补丁应用于操作系统，并更新 Kubernetes 版本以与 Kubernetes 主节点的版本相匹配。 可以使用 ibmcloud ks cluster master update 命令来更新主节点的 Kubernetes 版本。 请记住，工作程序节点最多只能比主版本 (n-2) 落后两个版本。更新操作后，工作程序节点 IP 地址保持不变。

要更新 VPC 集群中的工作节点，请使用 ibmcloud ks worker replace 命令。

运行 ibmcloud ks worker update 可能会导致应用程序和服务发生中断。 更新期间，所有 pod 都将重新安排到其他工作程序节点，对该工作程序节点重新应用映像，如果数据未存储在 pod 外部，那么将删除数据。 为避免发生中断，请确保在所选工作程序节点更新时有足够的工作程序节点来处理工作负载。

要更新 Satellite 工作程序节点，请参阅 更新分配为支持 Satellite的服务的工作程序节点的主机。

在更新前，您可能需要更改 YAML 文件以进行部署。 请查看此发行说明以了解详细信息。

ibmcloud ks worker update --cluster CLUSTER --worker WORKER_ID [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必填：列出可用工作节点的群集名称或 ID。

-w, --worker WORKER

指定工作程序节点标识。 要重载多个工作节点，请使用多个选项，如 -w worker1_id -w worker2_id。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker update --cluster my_cluster -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w1 -w kube-dal10-cr18a61a63a6a94b658596aa93d087aaa9-w2

ibmcloud ks worker-pool create classic

经典基础结构

可以在集群中创建工作程序池。 添加工作程序池时，缺省情况下不会为其分配专区。 您可以指定每个专区中需要的工作程序数以及工作程序的类型模板。 将为工作程序池提供缺省 Kubernetes 版本。 要完成创建工作程序，请向池添加专区。

要在 VPC 集群中创建工作池，请使用 ibmcloud ks worker-pool create vpc-gen2 命令。

ibmcloud ks worker-pool create classic --name POOL_NAME --cluster CLUSTER --flavor FLAVOR --size-per-zone WORKERS_PER_ZONE --hardware ISOLATION [--disable-disk-encrypt] [--label KEY1=VALUE1] [--operating-system SYSTEM]  [-q] [--output json]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

--name POOL_NAME

要为工作程序池提供的名称。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--flavor FLAVOR

选择机器类型（或类型模板）。 可以将工作程序节点作为虚拟机部署在共享或专用硬件上，也可以作为物理机器部署在裸机上。 可用的物理和虚拟机类型随集群的部署专区而变化。 有关更多信息，请参阅 ibmcloud ks flavors (machine-types) 命令的文档。

--size-per-zone WORKERS_PER_ZONE

要在每个专区中创建的工作程序数。

--hardware ISOLATION

需要：工作节点的硬件隔离级别。 使用 dedicated，以使可用的物理资源仅供您专用，或者使用 shared 以允许物理资源与其他 IBM 客户共享。 缺省值为 shared。 对于裸机类型模板，请指定 dedicated。

--disable-disk-encrypt

指定不对磁盘进行加密。 缺省值为 false。

-l, --label KEY1=VALUE1

可选：为工人池中的每个工人节点应用键值标签。 要指定多个标签，请使用多个选项，如 -l key1=value1 -l key2=value2。

--operating-system UBUNTU_20_64|UBUNTU_24_64

可选。 集群中工作程序节点的操作系统。 如需按集群版本查看可用操作系统列表，请参阅 Kubernetes 版本信息。 如果未指定任何选项，那么将使用与集群版本对应的缺省操作系统。

-q

可选：不显示当天的消息或更新提示。

--output json

可选：以 JSON 格式打印命令输出。

ibmcloud ks worker-pool create classic --name my_pool --cluster my_cluster --flavor b3c.4x16 --size-per-zone 6

ibmcloud ks worker-pool create vpc-gen2

虚拟私有云

向 VPC 集群添加工作池。 在向工作程序池添加专区之前，不会创建任何工作程序节点。

ibmcloud ks worker-pool create vpc-gen2 --name <worker_pool_name> --cluster <cluster_name_or_ID> --flavor <flavor> --size-per-zone <number_of_workers_per_zone> [--operating-system SYSTEM][--dedicated-host-pool POOL][--vpc-id <VPC ID>] [--label KEY1=VALUE1] [--kms-account-id ID] [--kms-instance KMS_INSTANCE_ID] [--crk ROOT_KEY_ID] [--operating-system SYSTEM] [-q] [--secondary-storage STORAGE] [--security-group GROUP ...] [--output json]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 操作员 平台访问角色。

命令选项：

--name NAME

必填：设置工人池的名称。

-c, --cluster CLUSTER

必填：指定群集的名称或 ID。 要列出 VPC 群集，请运行 ibmcloud ks cluster ls --provider vpc-gen2。

--size-per-zone NUMBER_WORKERS_PER_ZONE

指定此工作程序池中每个专区要创建的工作程序节点数。 在向工作程序池添加专区之前，不会创建任何工作程序节点。

--operating-system UBUNTU_20_64|UBUNTU_24_64

可选。 集群中工作程序节点的操作系统。 如需按集群版本查看可用操作系统列表，请参阅 Kubernetes 版本信息。 如果未指定任何选项，那么将使用与集群版本对应的缺省操作系统。

--flavor FLAVOR

选择工作程序节点的类型模板。 可以将多个工作程序节点作为虚拟机部署在共享或专用硬件上。 要查看 VPC 区域中可用的风味，请运行 ibmcloud ks flavors --zone <vpc_zone> --provider vpc-gen2。

--dedicated-host-pool POOL

可选。 您要在其中运行工作者的专用主机池的 ID。

--vpc-id VPC_ID

可选：指定要在其中创建 Worker 池 Worker 节点的 VPC 的 ID。 该值必须与集群的 VPC 标识相匹配。 要列出群集的 VPC ID，请运行 ibmcloud ks cluster get -c <cluster_name_or_ID>。 如果未提供此选项，则工人池默认使用群集中现有工人池的 VPC ID。

-l, --label KEY1=VALUE1

可选：为工人池中的每个工人节点应用键值标签。 要指定多个标签，请使用多个选项，如 -l key1=value1 -l key2=value2。

--kms-account-id ID

可选项：包含要用于本地磁盘或秘密加密的 KMS 实例的账户 ID。

--kms-instance KMS_INSTANCE_ID

可选: 包含用于对 default 工作程序池中工作程序节点上的本地磁盘进行加密的密钥管理服务 (KMS) 实例的标识。 要列出可用的 KMS 实例，请运行 ibmcloud ks kms instance ls。 如果包含该选项，还必须包含 --crk 选项。 有关更多信息 (包括要创建的步骤)，请参阅 管理集群中工作程序节点的加密。

--crk ROOT_KEY

可选: 在 KMS 实例中包含用于加密此工作程序池中工作程序节点上的本地磁盘的根密钥的标识。 要列出可用的根密钥，请运行 ibmcloud ks kms crk ls --instance-id。 如果包含该选项，还必须包含 --kms-instance 选项。 必须先创建 KMS 实例并在 IAM 中设置所需的服务授权，然后才能使用 KMS 加密。 请参阅 管理集群中工作程序节点的加密。

-q

可选：不显示当天的消息或更新提示。

--secondary-storage STORAGE

可选: 类型模板的存储选项。 例如，900gb.5iops-tier。 添加辅助磁盘时，该磁盘用于容器运行时，而主磁盘用于操作系统。 要查看类型模板的存储选项，请运行 **ibmcloud ks flavor get --flavor FLAVOR --zone ZONE --provider vpc-gen2 命令。

--security-group GROUP

可选。 请指定一个或多个安全组标识，以应用于集群上所有工作程序。 对于 OpenShift V 4.15 和 Kubernetes V 1.30 及更高版本，除了 IBM管理的 kube-clusterID 安全组外，还会应用这些安全组。 对于较早的集群版本，请指定 --cluster-security-group cluster 选项以应用 kube-clusterID 安全组。 如果未指定任何值，那么将应用包括 kube-clusterID 在内的一组缺省安全组。

--output json

可选：以 JSON 格式打印命令输出。

ibmcloud ks worker-pool create vpc-gen2 --name my_pool --cluster my_cluster --flavor bx2.4x16 --size-per-zone 3

ibmcloud ks worker-pool get

虚拟私有云 经典基础架构

查看工作程序池的详细信息。

ibmcloud ks worker-pool get --worker-pool WORKER_POOL --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-p, --worker-pool WORKER_POOL

必须填写：要查看详细信息的工作节点池名称。 要列出可用的工人池，请运行 ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>。

-c, --cluster CLUSTER

必须填写：工人池所在群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker-pool get --worker-pool pool1 --cluster my_cluster

ibmcloud ks worker-pool label rm

虚拟私有云 经典基础架构

从工作程序池的所有工作程序节点中移除所有定制 Kubernetes 标签。

无法从工作池中除去单个污点。 而是使用 kubectl taint node <worker_privateIP> key:effect- 命令从单个工作程序节点中除去污点。

ibmcloud ks worker-pool label rm --cluster CLUSTER --worker-pool POOL [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：工人池所在群集的名称或 ID。

-p, --worker-pool WORKER_POOL

必须填写：要查看详细信息的工作节点池名称。 要列出可用的工人池，请运行 ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker-pool label rm --worker-pool pool1 --cluster my_cluster

ibmcloud ks worker-pool label set

虚拟私有云 经典基础架构

为工人池中的所有工人节点设置格式为 key=value 的自定义 Kubernetes 标签。 要保留工人池上现有的自定义标签，必须在此命令中包含这些标签。

ibmcloud ks worker-pool label set --cluster CLUSTER --label LABEL [--label LABEL ...] --worker-pool POOL [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：工人池所在群集的名称或 ID。

--label LABEL

必需: 要为工作程序池中的所有工作程序节点设置的格式为 key=value 的定制标签。 如需多个标签，请重复此选项。 要在工人池上保留任何现有的自定义标签，请使用此选项包含这些标签。 您可以通过运行 ibmcloud ks worker-pool get -c <cluster_name_or_ID> --worker-pool <pool> 来列出工作程序池中工作程序节点上的现有定制标签。

-p, --worker-pool WORKER_POOL

必须填写：要查看详细信息的工作节点池名称。 要列出可用的工人池，请运行 ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker-pool label set --worker-pool pool1 --cluster my_cluster --label app=dev

ibmcloud ks worker-pool ls

虚拟私有云 经典基础架构

列出一个集群中的所有工作程序池。

ibmcloud ks worker-pool ls --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER_NAME_OR_ID

必填：您要列出工作者池的群集名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker-pool ls --cluster my_cluster

ibmcloud ks worker-pool operating-system set

设置操作系统。 设置操作系统后，您必须运行 ibmcloud ks worker update 或 ibmcloud ks worker replace 来更新工人。

ibmcloud ks worker-pool operating-system set --cluster CLUSTER --operating-system SYSTEM --worker-pool POOL [-q]

ibmcloud ks worker-pool rebalance

虚拟私有云 经典基础架构

删除工作程序节点后，重新均衡集群中的工作程序池。 运行此命令后，会向工作程序池添加新的工作程序，以便工作程序池的每个专区的节点数与指定值相符。

ibmcloud ks worker-pool rebalance --cluster CLUSTER --worker-pool WORKER_POOL [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-p, --worker-pool WORKER_POOL

需要：要重新平衡的工人池。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker-pool rebalance --cluster my_cluster --worker-pool my_pool

ibmcloud ks worker-pool resize

虚拟私有云 经典基础架构

调整工作程序池的大小，以增大或减小集群的每个专区中的工作程序节点数。

ibmcloud ks worker-pool resize --cluster CLUSTER --worker-pool WORKER_POOL --size-per-zone WORKERS_PER_ZONE [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：您要调整工作池大小的群集名称或 ID。

--worker-pool WORKER_POOL

必须填写：要更新的工作节点池名称。

--size-per-zone WORKERS_PER_ZONE

要在每个专区中拥有的工作程序数。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker-pool resize --cluster my_cluster --worker-pool my_pool --size-per-zone 3

ibmcloud ks worker-pool rm

虚拟私有云 经典基础架构

从集群中除去工作程序池。 这将删除池中的所有工作程序节点。 执行删除时，会重新安排 pod。 为了避免产生停机时间，请确保您有足够的工作程序来运行工作负载。

ibmcloud ks worker-pool rm --worker-pool WORKER_POOL --cluster CLUSTER [-q] [-f]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-p, --worker-pool WORKER_POOL

必须填写：要删除的工作节点池名称。

-c, --cluster CLUSTER

必填：您要从中删除 Worker 池的群集名称或 ID。

-q

可选：不显示当天的消息或更新提示。

-f

可选：强制命令在没有用户提示的情况下运行。

ibmcloud ks worker-pool rm --cluster my_cluster --worker-pool pool1

ibmcloud ks worker-pool taint

设置或删除工人池中所有工人节点的 Kubernetes 污点。 设置污点后，没有匹配容错的 pod 无法在工作程序池上运行。 您可以使用污点将工作程序池专用于特定类型的工作负载，例如用于联网边缘节点或集群自动缩放器。 有关污点和容错如何工作的更多信息，请参阅 Kubernetes 文档。

ibmcloud ks worker-pool taint set --worker-pool WORKER_POOL --cluster CLUSTER --taint KEY=VALUE:EFFECT [--taint KEY=VALUE2:EFFECT] [-f]

ibmcloud ks worker-pool taint set --cluster my_cluster --worker-pool pool1 --taint env=prod:NoSchedule

ibmcloud ks worker-pool taint rm --worker-pool WORKER_POOL --cluster CLUSTER [-f]

ibmcloud ks worker-pool taint rm --cluster my_cluster --worker-pool pool1

ibmcloud ks worker-pool zones

虚拟私有云 经典基础架构

查看附加到工人池的区段。

ibmcloud ks worker-pool zones --worker-pool WORKER_POOL --cluster CLUSTER [-q] [-f]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：工人池所在群集的名称或 ID。

-p, --worker-pool WORKER_POOL

必填：您要查看区域的工作节点池名称。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks worker-pool zones --cluster my_cluster --worker-pool pool1

ibmcloud ks zone add classic

经典基础结构

创建经典群集或工作者池后，就可以添加区域了。 添加专区后，会向新专区添加工作程序节点，以匹配为工作程序池指定的每个专区的工作程序数。 仅当集群位于多专区大城市中时，才能添加多个专区。

要将区域添加到 VPC 集群中的工作池，请使用 ibmcloud ks zone add vpc-gen2 命令。

ibmcloud ks zone add classic --zone ZONE --cluster CLUSTER --worker-pool WORKER_POOL [--private-vlan PRIVATE_VLAN] [--public-vlan PUBLIC_VLAN] [--private-only] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

--zone ZONE

需要：要添加的区段。 该区域必须是集群区域中的 支持多专区的专区。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-p, --worker-pool WORKER_POOL

要将专区添加到的工作程序池的名称。 要指定多个工人池，请使用多个选项，如 -p pool1 -p pool2。

--private-vlan PRIVATE_VLAN

专用 VLAN 的标识。 此值是有条件的。 如果专区中有专用 VLAN，那么此值必须与集群中一个或多个工作程序节点的专用 VLAN 标识相匹配。 要查看可用的 VLAN，请运行 ibmcloud ks cluster get --cluster <cluster> --show-resources。 新的工作程序节点会添加到指定的 VLAN，但不会更改任何现有工作程序节点的 VLAN。 如果该区域中没有专用或公用 VLAN，则不要指定此选项。 初始向工作程序池添加专区后，会自动创建专用和公用 VLAN。 在经典集群中，如果有多个 VLAN 用于集群，有多个子网位于同一 VLAN 上，或有一个多专区经典集群，那么必须针对 IBM Cloud 基础架构帐户启用虚拟路由器功能 (VRF)，从而使工作程序节点可以在专用网络上相互通信。 要启用 VRF，请参阅 启用 VRF。 要检查是否已启用 VRF，请使用 ibmcloud account show 命令。 如果无法或不想启用 VRF，请启用 VLAN 生成。 要执行此操作，需要有“网络”>“管理网络 VLAN 跨基础架构”权限，或者可以要求账户所有者启用该权限。 要检查 VLAN spanning 是否已启用，请使用 ibmcloud ks vlan spanning get --region <region> 命令。

--public-vlan PUBLIC_VLAN

公用 VLAN 的标识。 如果要在创建集群之后向公众公开节点上的工作负载，那么此值是必需的。 此值必须与集群中该专区的一个或多个工作程序节点的公用 VLAN 标识相匹配。 要查看可用的 VLAN，请运行 ibmcloud ks cluster get --cluster <cluster> --show-resources。 新的工作程序节点会添加到指定的 VLAN，但不会更改任何现有工作程序节点的 VLAN。 如果该区域中没有专用或公用 VLAN，则不要指定此选项。 初始向工作程序池添加专区后，会自动创建专用和公用 VLAN。 在经典集群中，如果有多个 VLAN 用于集群，有多个子网位于同一 VLAN 上，或有一个多专区经典集群，那么必须针对 IBM Cloud 基础架构帐户启用虚拟路由器功能 (VRF)，从而使工作程序节点可以在专用网络上相互通信。 要启用 VRF，请参阅 启用 VRF。 要检查是否已启用 VRF，请使用 ibmcloud account show 命令。 如果无法或不想启用 VRF，请启用 VLAN 生成。 要执行此操作，需要有“网络”>“管理网络 VLAN 跨基础架构”权限，或者可以要求账户所有者启用该权限。 要检查 VLAN spanning 是否已启用，请使用 ibmcloud ks vlan spanning get --region <region> 命令。

--private-only

使用此选项可阻止创建公用 VLAN。 仅当指定 --private-vlan 选项且不包含 --public-vlan 选项时才需要。 如果工人节点只设置了私有 VLAN，则必须启用私有云服务端点或配置网关设备。 有关更多信息，请参阅规划专用集群和工作程序节点设置。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks zone add classic --zone dal10 --cluster my_cluster -p pool1 -w pool2 --private-vlan 2294021

ibmcloud ks zone add vpc-gen2

虚拟私有云

创建第 2 代 VPC 群集或工作池后，可以添加区域。 添加专区后，会向新专区添加工作程序节点，以匹配为工作程序池指定的每个专区的工作程序数。 仅当集群位于多专区大城市中时，才能添加多个专区。

ibmcloud ks zone add vpc-gen2 --zone ZONE --subnet-id VPC_SUBNET_ID --cluster CLUSTER --worker-pool WORKER_POOL [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

--zone ZONE

需要：要添加的区段。 这必须是集群区域内的 VPC 专区。 要查看可用的 VPC 区域，请运行 ibmcloud ks zone ls --provider vpc-gen2。

--subnet-id SUBNET_ID

必填：要添加的子网 ID。 VPC 子网必须在指定的 zone 内。 要查看可用的 VPC 子网，请运行 ibmcloud ks subnets --provider vpc-gen2 --vpc-id <vpc> --zone <vpc_zone>。 VPC 子网为集群中的工作节点和负载均衡器服务提供 IP 地址，因此请使用 具有足够 IP 地址的 VPC 子网 （例如 256 个）。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。 要列出 VPC 群集，请运行 ibmcloud ks cluster ls --provider vpc-gen2。

-p, --worker-pool WORKER_POOL

要将专区添加到的工作程序池的名称。 要指定多个工人池，请使用多个选项，如 -p pool1 -p pool2。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks zone add vpc-gen2 --zone us-south-3 --cluster my_cluster -p pool1 -w pool2

ibmcloud ks zone ls

虚拟私有云 经典基础架构 Satellite

查看可在其中创建集群的可用专区的列表。

不推荐使用此命令的 locations 别名。

ibmcloud ks zone ls --provider (classic | satellite | vpc-gen2) [--location LOCATION] [--region-only] [--output json] [-q]

最低许可权：无

命令选项：

--provider (classic | satellite | vpc-gen2)

要列出区域的基础设施提供商类型。 此选项是必需的。

-l, --location LOCATION

按特定位置过滤输出。 要查看支持的位置，请运行 ibmcloud ks locations。 要指定多个位置，每个位置使用一个选项，如 -l dal -l seo。

--region-only

可选：仅列出登录区域内的多区。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks zone ls -l ap

ibmcloud ks zone network-set

经典基础结构

仅限多专区经典集群：为工作程序池设置网络元数据，以将与先前所用不同的公用或专用 VLAN 用于专区。 池中已创建的工作程序节点会继续使用先前的公用或专用 VLAN，但池中的新工作程序节点将使用新的网络数据。

ibmcloud ks zone network-set --zone ZONE --cluster CLUSTER  --private-vlan PRIVATE_VLAN --worker-pool WORKER_POOL [--public-vlan PUBLIC_VLAN] [--private-only] [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

--zone ZONE

需要：要添加的区段。 该区域必须是集群区域中的 支持多专区的专区。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-p, --worker-pool WORKER_POOL

要将专区添加到的工作程序池的名称。 要指定多个工人池，请使用多个选项，如 -p pool1 -p pool2。

--private-vlan PRIVATE_VLAN

专用 VLAN 的标识。 此值是必需的，无论要使用的专用 VLAN 与用于其他工作程序节点的专用 VLAN 相同还是不同。 新的工作程序节点会添加到指定的 VLAN，但不会更改任何现有工作程序节点的 VLAN。 专用 VLAN 和公用 VLAN 必须兼容，这可通过 Router 标识前缀进行确定。

--public-vlan PUBLIC_VLAN

公用 VLAN 的标识。 仅当要更改专区的公用 VLAN 时，此值才是必需的。 要更改公用 VLAN，必须始终提供兼容的专用 VLAN。 新的工作程序节点会添加到指定的 VLAN，但不会更改任何现有工作程序节点的 VLAN。 专用 VLAN 和公用 VLAN 必须兼容，这可通过 Router 标识前缀进行确定。

--private-only

可选：取消设置公用 VLAN，以便此专区中的工作程序仅连接到专用 VLAN。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

用法：

1. 检查集群中可用的 VLAN。

   ibmcloud ks cluster get --cluster <cluster_name_or_ID> --show-resources
   

   示例输出

   Subnet VLANs
   VLAN ID   Subnet CIDR         Public   User-managed
   229xxxx   169.xx.xxx.xxx/29   true     false
   229xxxx   10.xxx.xx.x/29      false    false
   

2. 检查要使用的公用和专用 VLAN 标识是否兼容。 要使两者兼容，Router 必须具有相同的 pod 标识。 专用 VLAN 路由器始终以 bcr（后端路由器）开头，而公用 VLAN 路由器始终以 fcr（前端路由器）开头。 创建集群并指定公用和专用 VLAN 时，在这些前缀之后的数字和字母组合必须匹配。

   ibmcloud ks vlan ls --zone <zone>
   

   在示例输出中，请注意路由器 pod ID 匹配：01a 和 01a。 如果一个 pod ID 是 01a，另一个是 02a，则无法为工人池设置这些公用和专用 VLAN ID。

   ID        Name   Number   Type      Router         Supports Virtual Workers
   229xxxx          1234     private   bcr01a.dal12   true
   229xxxx          5678     public    fcr01a.dal12   true
   

3. 如果没有任何可用的 VLAN，那么可以 订购新的 VLAN。

ibmcloud ks zone network-set --zone dal10 -c my_cluster -p pool1 -p pool2 --private-vlan 2294021

ibmcloud ks zone rm

虚拟私有云 经典基础架构

仅限多区群集：从群集的一个或多个工作池中删除一个区域。 这将删除工作程序池中此专区的所有工作程序节点。

在除去专区之前，请确保集群的其他专区中有足够的工作程序节点，以便可以重新安排 pod。 重新安排 pod 可避免因工作程序节点上的应用程序或数据损坏而产生的停机时间。

ibmcloud ks zone rm --cluster CLUSTER --zone ZONE --worker-pool WORKER_POOL [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--zone ZONE

需要：要删除的区段。

-p, --worker-pool WORKER_POOL

要移除区域的工作池名称。 要指定多个工人池，请使用多个选项，如 -p pool1 -p pool2。 要从集群中的所有工作程序池中除去专区，请勿包含此选项。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks zone rm --zone dal10 --cluster my_cluster

ibmcloud ks ingress alb autoscale get

虚拟私有云 经典基础架构

获取 Ingress ALB 自动缩放配置的详细信息和状态。

ibmcloud ks ingress alb autoscale get --alb ALB --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

--alb ALB

必需: 要配置自动缩放的 ALB 的名称或标识。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

--output json

可选：以 JSON 格式打印命令输出。

ibmcloud ks ingress alb autoscale get --alb myalb123 --cluster mycluster

ibmcloud ks ingress alb autoscale set

虚拟私有云 经典基础架构

配置自动缩放以根据当前负载自动增加或减少 Ingress ALB pod 数。 您可以选择根据 CPU 利用率来缩放 pod，也可以使用指定的定制度量。 如果基于 CPU 利用率的自动缩放配置，请指定平均 CPU 利用率以及在任何给定时间要部署的最大和最小 pod 数。 如果选择指定用于自动缩放的定制度量值，请传入定制度量值文件的路径。

ibmcloud ks ingress alb autoscale set --alb ALB --cluster CLUSTER --max-replicas REPLICAS --min-replicas REPLICAS [--output OUTPUT] [-q] (--cpu-average-utilization PERCENT | --custom-metrics-file FILE)

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

--alb ALB

必需: 要配置自动缩放的 ALB 的名称或标识。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--max-replicas REPLICAS

要随时部署的最大副本数。 如果包含 ---cpu-average-utilization 选项，那么此值是必需的。

--min-replicas REPLICAS

要随时部署的最小副本数。 如果包含 ---cpu-average-utilization 选项，那么此值是必需的。

--cpu-average-utilization PERCENTAGE

用于动态计算副本数的平均利用率阈值。

--custom-metrics-file

定制度量文件的路径。

-q

可选：不显示当天的消息或更新提示。

--output json

可选：以 JSON 格式打印命令输出。

ibmcloud ks ingress alb autoscale set --alb myalb123 --cluster mycluster --max-replicas 5 --min-replicas 2 --cpu-average-utilization 5

ibmcloud ks ingress alb autoscale unset

虚拟私有云 经典基础架构

通过删除自动缩放配置从 Ingress ALB 中除去自动缩放。

ibmcloud ks ingress alb autoscale unset --alb ALB --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

--alb ALB

必需: 要配置自动缩放的 ALB 的名称或标识。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb autoscale unset --alb myalb123 --cluster mycluster

ibmcloud ks ingress alb autoupdate disable

虚拟私有云 经典基础架构

禁用集群中所有 Ingress ALB pod 的自动更新。

缺省情况下，将启用 Ingress 应用程序负载均衡器 (ALB) 的自动更新。 当有新的镜像版本时，ALB pod 会自动更新。 要改为手动更新该附加组件，请使用此命令来禁用自动更新。 然后，您可以运行 ibmcloud ks ingress alb update 命令 更新 ALB pod。

当您更新群集的主要或次要 Kubernetes 版本时，IBM 会自动对 Ingress 部署进行必要的更改，但不会更改 Ingress ALB 附加组件的映像版本。 您应负责检查最新的 Kubernetes 版本和 Ingress ALB 附加组件映像的兼容性。

ibmcloud ks ingress alb autoupdate disable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb autoupdate disable --cluster mycluster

ibmcloud ks ingress alb autoupdate enable

虚拟私有云 经典基础架构

启用集群中所有 Ingress ALB pod 的自动更新。

如果禁用了 Ingress ALB 附加组件的自动更新，那么您可以重新启用自动更新。 每当下一个映像版本可用时，ALB 就会自动更新到最新版本。

ibmcloud ks ingress alb autoupdate enable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb autoupdate get

虚拟私有云 经典基础架构

检查是否启用了 Ingress ALB 插件的自动更新，以及 ALB 是否更新到了最新的映像版本。

ibmcloud ks ingress alb autoupdate get --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb create classic

经典基础结构

在经典集群中创建公共或专用 ALB。 缺省情况下，已启用您创建的 ALB。

ibmcloud ks ingress alb create classic --cluster CLUSTER --type (PUBLIC|PRIVATE) --vlan VLAN_ID --zone ZONE [--ip IP] [--version IMAGE_VERSION] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

集群的名称或标识。

--type (PUBLIC|PRIVATE)

ALB 的类型：public 或 private。 此类型必须与 vlan 匹配。

--vlan VLAN_ID

要在其中创建 ALB 的 VLAN 的标识。 该 VLAN 必须与 ALB type 匹配，并且必须与要创建的 ALB 位于同一 zone。

--zone ZONE

创建 ALB 的区域。

--ip IP

可选: 要分配给 ALB 的 IP 地址。 此 IP 必须位于您指定的 vlan 上，并且必须与要创建的 ALB 位于同一 zone 中。 该 IP 地址不得被群集中的其他负载平衡器或 ALB 使用。 要查看当前正在使用的 IP 地址，请运行 kubectl get svc --all-namespaces。

--version IMAGE_VERSION

可选: 您希望 ALB 运行的映像版本。 要列出可用版本，请运行 ibmcloud ks ingress alb versions。 要指定非缺省版本，必须首先通过运行 ibmcloud ks ingress alb autoupdate disable 命令来禁用自动更新。 如果省略此选项，那么 ALB 将运行缺省版本的 Kubernetes Ingress 映像类型。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb create classic --cluster mycluster --type public --vlan 2234945 --zone dal10 --ip 1.1.1.1 --version 1.1.2_2507_iks

ibmcloud ks ingress alb create vpc-gen2

虚拟私有云

在 VPC 集群中创建公共或专用 ALB。 缺省情况下，已启用您创建的 ALB。

ibmcloud ks ingress alb create vpc-gen2 --cluster CLUSTER --type PUBLIC|PRIVATE --zone ZONE [--version IMAGE_VERSION] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

集群的名称或标识。 要查看 VPC 群集，请运行 ibmcloud ks cluster ls --provider vpc-gen2。

--type PUBLIC|PRIVATE

ALB 的类型：public 或 private。

--zone ZONE

要将 ALB 部署到的 VPC 区域。

--version IMAGE_VERSION

可选: 您希望 ALB 运行的映像版本。 要列出可用版本，请运行 ibmcloud ks ingress alb versions。 要指定非缺省版本，必须首先通过运行 ibmcloud ks ingress alb autoupdate disable 命令来禁用自动更新。 如果省略此选项，那么 ALB 将运行缺省版本的 Kubernetes Ingress 映像类型。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb create vpc-gen2 --cluster mycluster --type public --zone us-south-1 --version 1.1.2_2507_iks

ibmcloud ks ingress alb disable

虚拟私有云 经典基础架构

在集群中禁用 ALB。 ALB 及其 pod 仍然存在，但停止将流量路由到应用程序。

不推荐使用此命令的先前别名 ibmcloud ks ingress alb configure。

ibmcloud ks ingress alb disable --alb ALB_ID --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

--alb ALB_ID

必须填写：ALB 的 ID。 要查看群集中 ALB 的 ID，请运行 ibmcloud ks ingress alb ls --cluster CLUSTER。

-c, --cluster CLUSTER

集群的名称或标识。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb disable --alb public-cr18a61a63a6a94b658596aa93a087aaa9-alb1 --cluster mycluster

ibmcloud ks ingress alb enable classic

经典基础结构

在经典群集中启用 ALB。

不推荐使用此命令的先前别名 ibmcloud ks ingress alb configure classic。

可以使用此命令来执行以下操作：

• 启用缺省专用 ALB。 创建集群时，会在具有工作程序和可用专用子网的每个专区中创建缺省专用 ALB，但未启用缺省专用 ALB。 但是，将自动启用所有缺省公共 ALB，并且缺省情况下也会启用使用 ibmcloud ks ingress alb create classic 命令创建的任何公共或专用 ALB。
• 启用先前禁用的 ALB。

ibmcloud ks ingress alb enable classic --alb ALB_ID --cluster CLUSTER [--ip IP_ADDRESS] [--version IMAGE_VERSION] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

--alb ALB_ID

必须填写：ALB 的 ID。 要查看群集中 ALB 的 ID，请运行 ibmcloud ks ingress alb ls --cluster CLUSTER。

-c, --cluster CLUSTER

集群的名称或标识。

--ip IP_ADDRESS

可选: 指定在其中创建 ALB 的区域中 VLAN 上的 IP 地址。 ALB 已启用并使用此公共或专用 IP 地址。 该 IP 地址不得被群集中的其他负载平衡器或 ALB 使用。 如果未提供 IP 地址，ALB 将使用创建群集时自动配置的可移植公网或私有子网中的公网或私有 IP 地址进行部署；如果重新启用以前启用的 ALB，则使用以前分配给 ALB 的公网或私有 IP 地址进行部署。

--version IMAGE_VERSION

可选: 您希望 ALB 运行的映像版本。 要列出可用版本，请运行 ibmcloud ks ingress alb versions。 要指定非缺省版本，必须首先通过运行 ibmcloud ks ingress alb autoupdate disable 命令来禁用自动更新。 如果省略此选项，那么 ALB 将运行 ALB 先前运行的相同映像的缺省版本: Kubernetes Ingress 映像或 IBM Cloud Kubernetes Service Ingress 映像。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb enable classic --alb private-cr18a61a63a6a94b658596aa93a087aaa9-alb1 --cluster mycluster --ip 169.XX.XXX.XX --version 1.1.2_2507_iks

ibmcloud ks ingress alb enable vpc-gen2

虚拟私有云

在 VPC 集群中启用 ALB。

不推荐使用此命令的先前别名 ibmcloud ks ingress alb configure vpc-gen2。

可以使用此命令来执行以下操作：

• 启用缺省专用 ALB。 创建集群时，会在您有工作程序节点的每个专区中创建缺省专用 ALB，但不会启用这些缺省专用 ALB。 但是，将自动启用所有缺省公共 ALB，并且缺省情况下也会启用使用 ibmcloud ks ingress alb create vpc-gen2 命令创建的任何公共或专用 ALB。
• 启用先前禁用的 ALB。

ibmcloud ks ingress alb enable vpc-gen2 --alb ALB_ID --cluster CLUSTER [--version IMAGE_VERSION] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

--alb ALB_ID

必须填写：ALB 的 ID。 要查看群集中 ALB 的 ID，请运行 ibmcloud ks ingress alb ls --cluster CLUSTER。

-c, --cluster CLUSTER

集群的名称或标识。

--version IMAGE_VERSION

可选: 您希望 ALB 运行的映像版本。 要列出可用版本，请运行 ibmcloud ks ingress alb versions。 要指定非缺省版本，必须首先通过运行 ibmcloud ks ingress alb autoupdate disable 命令来禁用自动更新。 如果省略此选项，那么 ALB 将运行 ALB 先前运行的相同映像的缺省版本: Kubernetes Ingress 映像或 IBM Cloud Kubernetes Service Ingress 映像。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb enable vpc-gen2 --alb private-cr18a61a63a6a94b658596aa93a087aaa9-alb1 --cluster mycluster --version 1.1.2_2507_iks

ibmcloud ks ingress alb get

虚拟私有云 经典基础架构

查看集群中 Ingress ALB 的详细信息。

ibmcloud ks ingress alb get --alb ALB_ID --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--alb ALB_ID

必须填写：ALB 的 ID。 要查看群集中 ALB 的 ID，请运行 ibmcloud ks ingress alb ls --cluster CLUSTER。

-c, --cluster CLUSTER

集群的名称或标识。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb get --alb public-cr18a61a63a6a94b658596aa93a087aaa9-alb1 --cluster mycluster

ibmcloud ks ingress alb health-checker disable

虚拟私有云 经典基础架构

禁用集群中 Ingress ALB 的运行状况检查程序。

ibmcloud ks ingress alb health-checker disable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

集群的名称或标识。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb health-checker disable --cluster mycluster

ibmcloud ks ingress alb health-checker enable

虚拟私有云 经典基础架构

对集群中的 Ingress ALB 启用运行状况检查程序。

ibmcloud ks ingress alb health-checker enable --cluster CLUSTER [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

集群的名称或标识。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb health-checker enable --cluster mycluster

ibmcloud ks ingress alb health-checker get

虚拟私有云 经典基础架构

查看集群中 Ingress ALB 的运行状况检查程序的详细信息。

ibmcloud ks ingress alb health-checker get --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

集群的名称或标识。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb health-checker get --cluster mycluster

ibmcloud ks ingress alb ls

虚拟私有云 经典基础架构

列出集群中的所有 Ingress ALB 标识，并查看 ALB pod 的更新是否可用。

如果未返回任何 ALB 标识，说明集群没有可移植子网。 您可以为集群创建或添加子网。 之后，将自动为您创建 ALB。

ibmcloud ks ingress alb ls --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

*-c, --cluster *CLUSTER

必填：您列出可用 ALB 的群集名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress alb ls --cluster my_cluster

ibmcloud ks ingress alb update

虚拟私有云 经典基础架构

强制将集群中各个或所有 Ingress ALB 的 pod 更新到最新或特定版本。

如果禁用了 Ingress ALB 附加组件的自动更新，而您希望更新该附加组件，那么可以强制一次性更新 ALB pod。 如果最近更新了 ALB pod，但 ALB 的定制配置受最新构建影响，那么您还可以使用此命令将 ALB pod 回滚到受支持的较早版本。 请注意，您可以使用此命令将 ALB 映像更新为其他版本，但不能使用此命令将 ALB 从一种类型的映像更改为另一种类型的映像。 强制一次性更新后，自动更新仍处于禁用状态，但可以使用 ibmcloud ks ingress alb autoupdate enable 命令重新启用。

ibmcloud ks ingress alb update --cluster CLUSTER [--alb ALB1_ID --alb ALB2_ID ...] [--version IMAGE_VERSION] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必需: 要更新 ALB 的集群的名称或标识。

--alb CLUSTER

可选: 要更新的各个 ALB 的标识。 要列出 ALB ID，请运行 ibmcloud ks ingress alb ls -c <cluster>。 要更新多个 ALB，请使用多个选项，例如 --alb ALB1_ID --alb ALB2_ID。 如果省略此选项，那么将更新集群中的所有 ALB。

--version IMAGE_VERSION

可选: 要将 ALB 更新为的映像版本。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

• 要更新集群中的所有 ALB pod:

  ibmcloud ks ingress alb update -c mycluster --version 1.1.2_2507_iks
  

• 要更新一个或多个特定 ALB 的 ALB pod:

  ibmcloud ks ingress alb update -c mycluster --version 1.1.2_2507_iks --alb public-crdf253b6025d64944ab99ed63bb4567b6-alb1
  

ibmcloud ks ingress alb versions

虚拟私有云 经典基础架构

查看可用的 Ingress ALB 版本。

ibmcloud ks ingress alb versions [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 的 查看者 平台访问角色

命令选项：

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain create

为集群创建 Ingress 域。

ibmcloud ks ingress domain create --cluster CLUSTER [--crn CRN] [--default] [--domain DOMAIN] [--hostname HOSTNAME] [--ip IP] [--output OUTPUT] [--domain-provider PROVIDER] [-q] [--secret-namespace NAMESPACE] [--domain-zone ZONE]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必需: 要在其中创建域的集群的名称或标识。

--crn CRN

对于 IBM Cloud Internet Services 域是必需的。 IBM Cloud Internet Services 实例的 CRN。

--is-default

可选。 包含此选项可将相关域设置为群集的默认域。

--domain DOMAIN

Ingress 域。 您可以指定一个现有域，也可以创建一个新域。 有关指定域的特定于提供者的信息，请参阅 创建您自己的 Ingress 域。

--hostname HOSTNAME

可选。 对于 VPC 集群。 要为域注册的主机名。

--ip IP

可选。 要为域注册的 IP 地址。

--output OUTPUT

可选：以 JSON 格式打印命令输出。

--domain-provider PROVIDER

可选。 外部 DNS 提供程序类型。 可用选项是 cis-ext。 如果没有指定提供商，则IBM内部提供商创建域。

--secret-namespace NAMESPACE

可选。 要在其中创建 TLS 私钥的名称空间。 如果未指定命名空间，则在 default 命名空间中创建秘密。

--domain-zone ZONE

可选。 IBM Cloud Internet Services 实例的域标识。 这是一个 GUID 值。

ibmcloud ks ingress domain create --cluster my-cluster --domain exampledomain

ibmcloud ks ingress domain default replace

更改集群的缺省 Ingress 域。

ibmcloud ks ingress domain default replace --cluster CLUSTER --domain DOMAIN [-q]

最低必需许可权

IBM Cloud Kubernetes Service中集群的 操作员 平台访问角色。

命令选项：

-c, --cluster CLUSTER

必须填写：应用域的群集名称或 ID。

--domain DOMAIN

必需。 要指定为集群的新缺省域的域。 您必须指定一个现有域。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain default replace --cluster CLUSTER --domain DOMAIN [-q]

ibmcloud ks ingress domain get

查看 Ingress 域的详细信息。

ibmcloud ks ingress domain get --cluster CLUSTER --domain DOMAIN [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：应用域的群集名称或 ID。

--domain DOMAIN

必需。 要查看其详细信息的域。

--output OUTPUT

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain get --cluster CLUSTER --domain DOMAIN [--output OUTPUT] [-q]

ibmcloud ks ingress domain ls

列出集群的所有 Ingress 域。

ibmcloud ks ingress domain ls --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output OUTPUT

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain ls --cluster CLUSTER [--output OUTPUT] [-q]

ibmcloud ks ingress domain rm

从集群中移除 Ingress 域。

ibmcloud ks ingress domain rm --cluster CLUSTER --domain DOMAIN [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：应用域的群集名称或 ID。

--domain DOMAIN

必需。 要从集群中除去的域。 不能指定缺省域。 如果要除去当前设置为集群缺省值的域，那么必须首先将缺省值 替换 为另一个域。

-f

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain rm --cluster CLUSTER --domain DOMAIN [-f] [-q]

ibmcloud ks ingress domain secret regenerate

为 Ingress 域重新生成证书。 运行此命令以在 DNS 提供程序中生成新令牌并将其应用于集群

ibmcloud ks ingress domain secret regenerate --cluster CLUSTER --domain DOMAIN [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：应用域的群集名称或 ID。

--domain DOMAIN

必需。 要重新生成的域。

--output OUTPUT

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain secret regenerate --cluster mycluster --domain exampledomain [--output OUTPUT] [-q]

ibmcloud ks ingress domain secret rm

删除输入域的密文，并阻止证书续期。

ibmcloud ks ingress domain secret rm --cluster CLUSTER --domain DOMAIN [-f] [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：应用域的群集名称或 ID。

--domain DOMAIN

必需。 要从中除去私钥的域。

-f

--output OUTPUT

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain secret rm --cluster CLUSTER --domain DOMAIN [-f] [--output OUTPUT] [-q]

ibmcloud ks ingress domain update

更新集群的 Ingress 域以更改与该域关联的主机名或 IP 地址。 此命令使用指定的 IP 地址或主机名更新集群中的所有资源，并更改应用程序 URL。

ibmcloud ks ingress domain update --cluster CLUSTER --domain DOMAIN [--hostname HOSTNAME] [--ip IP] [--ip IP] [-q]

请注意，添加 IP 地址或主机名时，必须包含当前已向域注册的任何 IP 或主机名。 域将使用指定的精确值进行更新，因此如果不包含任何当前 IP 地址或主机名，那么将覆盖这些地址或主机名。 例如，如果 52.137.182.166 当前已注册到您的域，并且您要添加 52.137.182.270，那么必须在命令中指定 --ip 52.137.182.166 --ip 52.137.182.270。

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：应用域的群集名称或 ID。

--domain DOMAIN

必需。 要更新的域。

--hostname HOSTNAME

对于 VPC 集群。 要为域注册的主机名。

--ip IP

要为域注册的 IP 地址。 传入的 IP 地址将完全替换当前与域关联的 IP 地址。 如果要保留当前 IP 地址，那么必须包含这些地址。 如果指定此标志而不指定任何值，那么将从域中注销当前 IP 地址。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress domain update --cluster CLUSTER --domain DOMAIN [--hostname HOSTNAME] [--ip IP] [-q]

ibmcloud ks ingress instance default set

虚拟私有云 经典基础架构

将已注册的 IBM Cloud Secrets Manager 实例设置为缺省值。 如果存在现有缺省实例，那么将从缺省实例取消设置该实例。

当您设置新的缺省 Secrets Manager 实例时，任何不受 IBM Cloud 管理的现有密钥都必须手动更新其证书 CRN 以与新的缺省实例的 CRN 相匹配。 要更新 CRN，请使用 ibmcloud ks ingress secret update 命令。 如果不更新 CRN，那么这些私钥不会在下一次调度的证书更新时更新。

ibmcloud ks ingress instance default set --cluster CLUSTER --crn CRN --name NAME [-q] [--secret-group GROUP]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--crn

必需。 IBM Cloud Secret Manager 实例的 CRN。

--name NAME

必需。 秘密管理器实例的名称。

-q

可选：不显示当天的消息或更新提示。

--secret-group GROUP

用于持久存储私钥的 IBM Cloud Secret Manager 实例的私钥组标识。 要获取私钥组标识，请参阅 Secrets Manager CLI 参考。

示例：

ibmcloud ks ingress instance default set --cluster --cluster a111aaa11a1aaaaaaa1 --crn crn:v1:staging:public:secrets-manager:eu-gb:a/1a11a1a111aa11aa111aa1a1111aa1a1:1aaa1a1a-aaaa-11aa-1a11-a11aaa1a11a1:secret:a1a11a11-111a-11a1-aa11-11aaa1a11a11 --name my-secret-manager --namespace default --secret-group 90e059dd-d04e-a32b-010f-4d303b9050b8

ibmcloud ks ingress instance default unset

虚拟私有云 经典基础架构

除去 Secrets Manager 实例作为缺省实例。

如果未设置缺省实例，那么您的私钥仅直接写入集群，而不会写入任何 Secrets Manager 实例。

ibmcloud ks ingress instance default unset --cluster CLUSTER --crn CRN --name NAME [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--crn

必需。 IBM Cloud Secret Manager 实例的 CRN。

--name NAME

必需。 秘密管理器实例的名称。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks ingress instance default unset --cluster --cluster a111aaa11a1aaaaaaa1 --crn crn:v1:staging:public:secrets-manager:eu-gb:a/1a11a1a111aa11aa111aa1a1111aa1a1:1aaa1a1a-aaaa-11aa-1a11-a11aaa1a11a1:secret:a1a11a11-111a-11a1-aa11-11aaa1a11a11 --name my-secret-manager --namespace default

ibmcloud ks ingress instance get

虚拟私有云 经典基础架构

查看 Secrets Manager 实例的详细信息。

ibmcloud ks ingress instance get --cluster CLUSTER --name NAME [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--name NAME

必需。 秘密管理器实例的名称。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks ingress instance get --cluster my-cluster --name my-secrets-manager

ibmcloud ks ingress instance ls

虚拟私有云 经典基础架构

列出向集群注册的所有 Secrets Manager 实例。

ibmcloud ks ingress instance ls --cluster CLUSTER [--output OUTPUT] [-q] [--show-deleted]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

--show-deleted

可选。 添加此选项以包含从集群注销的实例。

示例：

ibmcloud ks ingress instance ls --cluster my-cluster --show-deleted

ibmcloud ks ingress instance register

虚拟私有云 经典基础架构

向集群注册 Secrets Manager 实例。

ibmcloud ks ingress instance register --cluster CLUSTER --crn CRN [--is-default] [--secret-group GROUP] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--crn

必需。 IBM Cloud Secret Manager 实例的 CRN。

--is-default

可选。 包含此选项还可将已注册的实例设置为存储所有 Ingress 子域证书的缺省 Secrets Manager 实例。 如果另一个实例已设置为缺省值，那么将除去该实例。 请注意，您必须手动更新任何证书或私钥以将其上载到新的缺省实例。 否则，将在下一次调度的私钥更新时间上载这些私钥。

-q

可选：不显示当天的消息或更新提示。

--secret-group GROUP

用于持久存储私钥的 IBM Cloud Secret Manager 实例的私钥组标识。 要获取私钥组标识，请参阅 Secrets Manager CLI 参考。

示例：

ibmcloud ks ingress instance register --cluster my-cluster --crn crn:v1:staging:public:secrets-manager:eu-gb:a/1a11a1a111aa11aa111aa1a1111aa1a1:1aaa1a1a-aaaa-11aa-1a11-a11aaa1a11a1:secret:a1a11a11-111a-11a1-aa11-11aaa1a11a11 --secret-group 90e059dd-d04e-a32b-010f-4d303b9050b8

ibmcloud ks ingress instance unregister

虚拟私有云 经典基础架构

从集群中除去 Secrets Manager 实例。

ibmcloud ks ingress instance unregister --cluster CLUSTER --name NAME [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--name

必需。 要删除的 Secrets Manager 实例的名称。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks ingress instance unregister --cluster my-cluster --name my-secrets-manager-instance

ibmcloud ks ingress lb get

虚拟私有云 经典基础架构

获取在集群中公开 Ingress ALB 的负载均衡器的配置。

例如，如果先前运行了诸如 ibmcloud ks ingress lb proxy-protocol enable 之类的命令，那么可以使用此命令来查看配置更改。

ibmcloud ks ingress lb get --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress lb get --cluster mycluster

ibmcloud ks ingress lb proxy-protocol disable

虚拟私有云

禁用集群中所有 Ingress ALB 前面的负载均衡器的 NGINX PROXY 协议，以便不再将请求头中的客户机连接信息传递到 ALB。

运行此命令后，现有负载平衡器将被删除并重新创建，这可能会导致服务中断。 在重新创建负载均衡器期间，两个未使用的 IP 地址必须在每个子网中可用。

ibmcloud ks ingress lb proxy-protocol disable --cluster CLUSTER [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress lb proxy-protocol disable --cluster mycluster

ibmcloud ks ingress lb proxy-protocol enable

虚拟私有云

对所有在集群中公开 Ingress ALB 的负载均衡器启用 NGINX PROXY 协议，以便在请求头中将客户机连接信息传递到 ALB。

PROXY 协议使负载均衡器能够将客户机请求的头中包含的客户机连接信息传递到 ALB。 此客户机信息可以包含客户机 IP 地址，代理服务器 IP 地址以及两个端口号。

运行此命令后，现有负载平衡器将被删除并重新创建，这可能会导致服务中断。 在重新创建负载均衡器期间，两个未使用的 IP 地址必须在每个子网中可用。

ibmcloud ks ingress lb proxy-protocol enable --cluster CLUSTER [--cidr CIDR ...] [--header-timeout TIMEOUT] [-f] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 操作员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--cidr CIDR

可选: 负载均衡器 CIDR，ALB 从中处理 PROXY 协议头中的信息。 如果包含 PROXY 头的请求源自其他 IP 范围内的负载均衡器，那么 ALB 不会处理头中的信息。 只有运行社区 Kubernetes Ingress 映像的 ALB 才支持该选项。 缺省值： 0.0.0.0/0

--header-timeout TIMEOUT

可选: 负载均衡器接收包含客户机连接信息的 PROXY 协议头的超时值 (以秒计)。 只有运行社区 Kubernetes Ingress 映像的 ALB 才支持该选项。 缺省值： 5

-f

可选：强制命令在没有用户提示的情况下运行。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress lb proxy-protocol enable --cluster mycluster --cidr 1.1.1.1/16

ibmcloud ks ingress secret create

虚拟私有云 经典基础架构

在集群中为存储在 IBM Cloud® Secrets Manager中的证书创建 Ingress 私钥。 此命令可用于创建 TLS 或非 TLS 私钥。

不推荐使用此命令的先前别名 ibmcloud ks ingress alb cert deploy。 在 CLI V 1.0.157 和更高版本中，不推荐使用 ibmcloud ks ingress alb cert 类别，这些命令现在列示在 ibmcloud ks ingress secret 子类别中。 有关更多信息，请参阅 CLI 更改日志。

要使用 ibmcloud ks ingress secret create 命令，必须向集群注册缺省 Secrets Manager 实例。 如果没有 Secrets Manager 实例，而是将私钥直接写入集群，那么私钥没有必需的 CRN 值，您必须使用 kubectl 命令对其进行管理。

ibmcloud ks ingress secret create --cert-crn CERTIFICATE_CRN --cluster CLUSTER --name SECRET_NAME  [--namespace NAMESPACE] [--field CRN] [--persist] [--type] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--cert-crn CERTIFICATE_CRN

必需: 证书 CRN。

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--name SECRET_NAME

必需: 指定私钥的名称。 确保不创建与 IBM提供的 Ingress 私钥同名的私钥，您可以通过运行 ibmcloud ks cluster get --cluster <cluster_name_or_ID> | grep Ingress 来找到该私钥。

--field CRN

对于非 TLS 私钥是必需的。 为秘密添加一个字段。 您可以同时指定多个字段。 有关更多信息，请参阅 管理非 TLS 私钥字段。 TLS 保密不支持该选项。

• 要使用私钥类型的缺省字段名称来拉入私钥，请使用缺省字段选项: --field <crn>。 此选项可用于所有非 TLS 密钥类型。
• 要指定字段名称，请使用指定的字段选项: --field name=<crn>。 此选项可用于任意和 IAM 凭证密钥类型。
• 要使用 IBM Cloud Secrets Manager 私钥作为前缀，请使用前缀字段选项: --field prefix=<crn>。 此选项可用于 IAM 凭证，用户名和密码以及密钥值私钥类型。

--namespace NAMESPACE

可选: 指定 Ingress 资源要部署到的名称空间。 如果 ALB 运行 Kubernetes Ingress 映像，那么需要此值，因为 ALB 只能在与 Ingress 资源相同的名称空间中识别私钥。 如果 ALB 运行 IBM Cloud Kubernetes Service Ingress 映像，并且未指定名称空间，那么将在名为 ibm-cert-store 的名称空间中创建证书私钥。 然后，将在 default 名称空间中创建对此私钥的引用，任何名称空间中的任何 Ingress 资源都可以对其进行访问。 处理请求时，ALB 遵循引用以从 ibm-cert-store 名称空间获取并使用证书私钥。

--persist

可选: 在集群中持久存储私钥数据。 如果稍后从 CLI 或 Red Hat OpenShift Web 控制台中删除私钥，那么将在集群中自动重新创建私钥。 要永久删除私钥，必须使用 /ingress/v2/secret/deleteSecret API。

--type

可选。 私钥的类型。 从 tls (对于证书 CRN) 或 opaque (对于非证书 CRN) 中进行选择。 对于 tls，最多指定一个 CRN。 对于 opaque，可以指定多个 CRN。 如果未指定密文类型，则默认应用 tls。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress secret create --cert-crn crn:v1:staging:public:cloudcerts:us-south:a/06580c923e40314421d3b6cb40c01c68:0db4351b-0ee1-479d-af37-56a4da9ef30f:certificate:4bc35b7e0badb304e60aef00947ae7ff --cluster my_cluster --type tls --name my_alb_secret --namespace demo_ns

ibmcloud ks ingress secret field add

虚拟私有云 经典基础架构

将非 TLS CRN 字段添加到不透明密钥。 有三种方法可指定字段类型。 您选择的选项取决于私钥类型以及您希望如何在非 TLS 私钥中命名该字段。 有关更多信息，请参阅 管理非 TLS 私钥字段。

ibmcloud ks ingress secret field add --cluster CLUSTER --name SECRET_NAME --field CRN --namespace NAMESPACE [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--name NAME

必需。 要向其添加字段的私钥的名称。

--field CRN

必需。 要添加到字段的私钥 CRN。 您可以同时指定多个字段。 有关更多信息，请参阅 管理非 TLS 私钥字段。

• 要使用私钥类型的缺省字段名称来拉入私钥，请使用缺省字段选项: --field <crn>。 此选项可用于所有非 TLS 密钥类型。
• 要指定字段名称，请使用指定的字段选项: --field name=<crn>。 此选项可用于任意和 IAM 凭证密钥类型。
• 要使用 IBM Cloud Secrets Manager 私钥作为前缀，请使用前缀字段选项: --field prefix=<crn>。 此选项可用于 IAM 凭证，用户名和密码以及密钥值私钥类型。

--namespace NAMESPACE

必需。 私钥部署到的名称空间。

-q

可选：不显示当天的消息或更新提示。

用于将缺省字段，指定字段和前缀字段添加到一组 IAM 凭证的示例:

ibmcloud ks ingress secret field add --cluster example-cluster --name example-iam-secret --namespace default  --field crn:v1:bluemix:public:secrets-manager:us-south:a/1aa111aa1a11111aaa1a1111aa1aa111:111a1111-11a1 --field unique_iam_name=crn:v1:bluemix:public:secrets-manager:us-south:a/1aa111aa1a11111aaa1a1111aa1aa111:111a1111-11a1 --field prefix=crn:v1:bluemix:public:secrets-manager:us-south:a/1aa111aa1a11111aaa1a1111aa1aa111:111a1111-11a1

ibmcloud ks ingress secret field ls

虚拟私有云 经典基础架构

查看输入密文的 CRN 字段。 此命令仅适用于不透明密钥。

ibmcloud ks ingress secret field ls --cluster CLUSTER --name SECRET_NAME --namespace NAMESPACE [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--name NAME

必需。 要向其添加字段的私钥的名称。

--namespace NAMESPACE

必需。 私钥部署到的名称空间。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress secret field ls --cluster a11a11a11a111a1a111a --name my-secret --namespace default

ibmcloud ks ingress secret field rm

虚拟私有云 经典基础架构

ibmcloud ks ingress secret field rm --cluster CLUSTER --name NAME --namespace NAMESPACE [--field-name NAME]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--c, --cluster CLUSTER

必需。 集群的名称或标识。

--name NAME

必需。 要从中除去字段的私钥的名称。

--namespace NAMESPACE

必需。 私钥部署到的名称空间。

--field-name NAME

要删除的字段名称。 要查看字段列表，请运行 ibmcloud ks ingress secret field ls。

ibmcloud ks ingress secret field rm --cluster a11a11a11a111a1a111a --name my-secret --namespace default --field-name test-field-name

ibmcloud ks ingress secret get

虚拟私有云 经典基础架构

查看有关集群中 Ingress 私钥的信息，包括存储在 IBM Cloud® Secrets Manager中的私钥。

不推荐使用此命令的先前别名 ibmcloud ks ingress alb cert get。 在 CLI V 1.0.157 和更高版本中，不推荐使用 ibmcloud ks ingress alb cert 类别，这些命令现在列示在 ibmcloud ks ingress secret 子类别中。 有关更多信息，请参阅 CLI 更改日志。

ibmcloud ks ingress secret get --cluster CLUSTER --name SECRET_NAME --namespace NAMESPACE [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--name SECRET_NAME

必须填写：密文名称。

--namespace NAMESPACE

必需: 私钥要部署到的名称空间。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress secret get --cluster my_cluster --name my_alb_secret --namespace demo_ns

ibmcloud ks ingress secret ls

虚拟私有云 经典基础架构

列出集群中的 Ingress 私钥，包括存储在 IBM Cloud® Secrets Manager中的私钥。

不推荐使用此命令的先前别名 ibmcloud ks ingress alb cert ls。

ibmcloud ks ingress secret ls --cluster CLUSTER [--show-deleted] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--show-deleted

可选：查看从群集中删除的机密。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress secret ls --cluster my_cluster

ibmcloud ks ingress secret rm

虚拟私有云 经典基础架构

从集群中删除 Ingress 私钥。 如果为来自 Secrets Manager的证书创建了私钥，那么将仅删除集群中的私钥，并且该证书将保留在 Secrets Manager 实例中。

不推荐使用此命令的先前别名 ibmcloud ks ingress alb cert rm。 在 CLI V 1.0.157 和更高版本中，不推荐使用 ibmcloud ks ingress alb cert 类别，这些命令现在列示在 ibmcloud ks ingress secret 子类别中。 有关更多信息，请参阅 CLI 更改日志。

ibmcloud ks ingress secret rm --cluster CLUSTER --name SECRET_NAME --namespace NAMESPACE [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--name SECRET_NAME

必须填写：密文名称。

--namespace NAMESPACE

必需: 私钥要部署到的名称空间。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress secret rm --cluster my_cluster --name my_alb_secret --namespace demo_ns

ibmcloud ks ingress secret update

虚拟私有云 经典基础架构

更新未在为集群创建的缺省 Secrets Manager 实例中托管的证书的 Ingress 私钥。

您对集群中缺省 Secrets Manager 实例中的证书进行的任何更改都会自动反映在集群中的私钥中。 如果您对集群 Secrets Manager 实例中未托管的证书进行更改，那么必须使用此命令更新集群中的私钥，以获取证书更改。

ibmcloud ks ingress secret update --cluster CLUSTER --name SECRET_NAME --namespace NAMESPACE [--cert-crn CRN] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--name SECRET_NAME

必须填写：密文名称。 要查看可用私钥，请运行 ibmcloud ks ingress secret ls。

--namespace NAMESPACE

必需: 私钥要部署到的名称空间。 要查看私钥名称空间，请运行 ibmcloud ks ingress secret get --cluster cluster_name_or_ID <--name secret_name> --namespace <namespace>。

--cert-crn CERTIFICATE_CRN

可选: 证书 CRN。 要查看私钥 CRN，请运行 ibmcloud ks ingress secret get --cluster <cluster_name_or_ID> --name secret_name> --namespace <namespace>。 此选项需要集群中的缺省 Secrets Manager 实例。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress secret update --cluster my_cluster --name my_alb_secret --namespace demo_ns

ibmcloud ks ingress status-report disable

虚拟私有云 经典基础架构

禁用集群中的 Ingress 组件状态报告。

ibmcloud ks ingress status-report disable --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress status-report disable --cluster mycluster

ibmcloud ks ingress status-report enable

虚拟私有云 经典基础架构

在集群中启用 Ingress 组件的状态报告。

ibmcloud ks ingress status-report enable --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress status-report enable --cluster mycluster

ibmcloud ks ingress status-report get

虚拟私有云 经典基础架构

获取集群中的 Ingress 组件状态报告。

ibmcloud ks ingress status-report get --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress status-report get --cluster mycluster

ibmcloud ks ingress status-report ignored-errors add

虚拟私有云 经典基础架构

添加集群的 Ingress 状态要忽略的警告。

ibmcloud ks ingress status-report ignored-errors add --cluster CLUSTER --code CODE [--code CODE ...] [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-code, --code CODE

必填：要忽略的警告代码。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress status-report ignored-errors add --cluster mycluster --code CODE

ibmcloud ks ingress status-report ignored-errors ls

虚拟私有云 经典基础架构

列出集群的 Ingress 状态当前忽略的警告。

ibmcloud ks ingress status-report ignored-errors ls --cluster CLUSTER [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress status-report ignored-errors ls --cluster mycluster

ibmcloud ks ingress status-report ignored-errors rm

虚拟私有云 经典基础架构

除去集群的 Ingress 状态当前忽略的警告。 除去后，将不再忽略这些警告。

ibmcloud ks ingress status-report ignored-errors rm --cluster CLUSTER --code CODE [--code CODE ...] [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-code, --code CODE

必需: 要从忽略列表中除去的警告的代码。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks ingress status-report ignored-errors rm --cluster mycluster

ibmcloud ks logging autoupdate disable

虚拟私有云 经典基础架构

禁用集群中所有 Fluentd pod 的自动更新。

在特定集群中禁用 Fluentd pod 的自动更新。 当您更新群集的主要或次要 Kubernetes 版本时，IBM 会自动对 Fluentd ConfigMap, 进行必要的更改，但不会更改 Fluentd 用于日志记录附加组件的映像版本。 您应负责检查最新的 Kubernetes 版本和附加组件映像的兼容性。

ibmcloud ks logging autoupdate disable --cluster CLUSTER [-q]

命令选项：

-c, --cluster CLUSTER

必填：要禁用 Fluentd 附加组件自动更新的群集名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging autoupdate enable

虚拟私有云 经典基础架构

在特定集群中启用 Fluentd pod 的自动更新。 Fluentd 当有新的图像版本时，pod 会自动更新。

ibmcloud ks logging autoupdate enable --cluster CLUSTER [-q]

命令选项：

-c, --cluster CLUSTER

必填：您要为 Fluentd 附加组件启用自动更新的群集名称或 ID。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging autoupdate get

虚拟私有云 经典基础架构

查看 Fluentd pod 是否设置为在集群中自动更新。

ibmcloud ks logging autoupdate get --cluster CLUSTER [--output json] [-q]

命令选项：

-c, --cluster CLUSTER

必填：要检查 Fluentd 附加组件是否启用自动更新的群集名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging config create

虚拟私有云 经典基础架构

创建日志记录配置。 您可以使用此命令将容器、应用程序、工作程序节点、Kubernetes 集群以及 Ingress 应用程序负载均衡器的日志转发到外部 syslog 服务器。

ibmcloud ks logging config create --cluster CLUSTER --logsource LOG_SOURCE --type syslog [--namespace KUBERNETES_NAMESPACE] [--hostname LOG_SERVER_HOSTNAME_OR_IP] [--port LOG_SERVER_PORT] [--app-containers CONTAINERS] [--app-paths PATHS_TO_LOGS] [--syslog-protocol PROTOCOL] [--skip-validation] [--force-update] [--output json] [-q]

最低必需许可权

集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

集群的名称或标识。

--logsource LOG_SOURCE

要对其启用日志转发的日志源。 该选项支持以逗号分隔的日志源列表，用于配置。 接受的值为 container, application, worker, kubernetes, storage 和 ingress。 如果不提供日志源，则会为 container 和 ingress 创建配置。

--type syslog

输入 syslog 可将日志转发到外部服务器。

-n, --namespace KUBERNETES_NAMESPACE

要从中转发日志的 Kubernetes 名称空间。 ibm-system 和 kube-system Kubernetes 命名空间不支持日志转发。 此值仅对容器日志源有效，并且是可选的。 如果不指定名称空间，群集中的所有名称空间都会使用此配置。

--hostname LOG_SERVER_HOSTNAME

日志收集器服务器的主机名或 IP 地址。

--port LOG_SERVER_PORT

可选：日志收集器服务器的端口。 如果未指定端口，则 syslog 使用标准端口 514，ibm 使用标准端口 9091。

-p, --app-path

容器上应用程序要将日志记录到的路径。 要转发源类型为 application 的日志，必须提供一个路径。 可以使用通配符，如 /var/log/*.log，但不能使用递归球，如 /var/log/**/test.log。 要指定多个路径，请使用多个选项，如 -p /var/log/myApp1/* -p /var/log/myApp2/*. 日志源 application 需要此值。

--syslog-protocol

日志类型为 syslog 时使用的传输层协议。 支持的值有 tcp、tls 和默认值 udp。 使用 udp 协议转发到 rsyslog 服务器时，超过 1 KB 的日志会被截断。

-C, --app-container

要转发来自应用程序的日志，可以指定包含应用程序的容器的名称。 要指定多个容器，请使用多个选项，如 -C /var/log/myApp1/* -C /var/log/myApp2/*。 如果没有指定容器，日志将从包含所提供路径的所有容器中转发。 该选项仅对日志源 application 有效。

--skip-validation

可选：当指定 org 和空格名称时，跳过对它们的验证。 跳过验证可减少处理时间，但无效的日志记录配置将无法正确转发日志。

--force-update

强制 Fluentd pod 更新到最新版本。 Fluentd 必须是最新版本才能更改日志配置。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

缺省端口 514 上从 syslog 日志源转发的日志类型 container 的示例：

ibmcloud ks logging config create my_cluster --logsource container --namespace my_namespace  --hostname 169.xx.xxx.xxx --type syslog

非缺省端口上从 syslog 源转发日志的日志类型 ingress 的实例：

ibmcloud ks logging config create --cluster my_cluster --logsource container --hostname 169.xx.xxx.xxx --port 5514 --type syslog

ibmcloud ks logging config get

虚拟私有云 经典基础架构

查看集群的所有日志转发配置，或基于日志源过滤日志记录配置。

ibmcloud ks logging config get --cluster CLUSTER [--logsource LOG_SOURCE] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--logsource LOG_SOURCE

可选项：要过滤的日志源类型。 仅会返回集群中此日志源的日志记录配置。 接受的值为 container, storage, application, worker, kubernetes 和 ingress。

--show-covering-filters

显示导致先前过滤器过时的日志记录过滤器。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging config get --cluster my_cluster --logsource worker

ibmcloud ks logging config rm

虚拟私有云 经典基础架构

删除集群的一个日志转发配置或所有日志记录配置。 删除日志配置会阻止将日志转发到远程 syslog 服务器。

ibmcloud ks logging config rm --cluster CLUSTER (--namespace NAMESPACE --id LOG_CONFIG_ID] [--all] [--force-update] [-q]

最低必需许可权

集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

-n, --namespace NAMESPACE

要从中除去日志转发配置的名称空间。 如果同一命名空间有多个配置，请使用 --id <logging_configuration_ID> 选项。

--id LOG_CONFIG_ID

如果要除去单个日志记录配置，此值为日志记录配置标识。

--all

移除群集中所有日志记录配置的选项。

--force-update

强制 Fluentd pod 更新到最新版本。 Fluentd 必须是最新版本才能更改日志配置。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging config rm --cluster my_cluster --id f4bc77c0-ee7d-422d-aabf-a4e6b977264e

ibmcloud ks logging config update

虚拟私有云 经典基础架构

更新日志转发配置的详细信息。

ibmcloud ks logging config update --cluster CLUSTER --id LOG_CONFIG_ID --type LOG_TYPE  [--namespace NAMESPACE] [--hostname LOG_SERVER_HOSTNAME_OR_IP] [--port LOG_SERVER_PORT] [--app-paths PATH] [--app-containers PATH] [--output json] [--skipValidation] [--force-update] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--id LOG_CONFIG_ID

必须填写：要更新的日志配置 ID。

--type LOG_TYPE

必填：要使用的日志转发协议。 目前支持 syslog 和 ibm。

-n, --namespace NAMESPACE

要从中转发日志的 Kubernetes 名称空间。 ibm-system 和 kube-system Kubernetes 命名空间不支持日志转发。 此值仅对 container 日志源有效。 如果不指定名称空间，群集中的所有名称空间都会使用此配置。

--hostname LOG_SERVER_HOSTNAME

日志收集器服务器的主机名或 IP 地址。

--port LOG_SERVER_PORT

日志收集器服务器的端口。 日志类型为 syslog 时，此值为可选项。 如果未指定端口，则 syslog 使用标准端口 514，ibm 使用标准端口 9091。

-p, --app-path

容器上应用程序要将日志记录到的路径。 要转发源类型为 application 的日志，必须提供一个路径。 可以使用通配符，如 /var/log/*.log，但不能使用递归球，如 /var/log/**/test.log。 要指定多个路径，请使用多个选项，如 -p /var/log/myApp1/* -p /var/log/myApp2/*. 日志源 application 需要此值。

-C, --app-container

要转发来自应用程序的日志，可以指定包含应用程序的容器的名称。 要指定多个容器，请使用多个选项，如 -C /var/log/myApp1/* -C /var/log/myApp2/*。 如果没有指定容器，日志将从包含所提供路径的所有容器中转发。 该选项仅对日志源 application 有效。

--output json

可选：以 JSON 格式打印命令输出。

--skipValidation

可选：当指定 org 和空格名称时，跳过对它们的验证。 跳过验证可减少处理时间，但无效的日志记录配置将无法正确转发日志。

--force-update

强制 Fluentd pod 更新到最新版本。 Fluentd 必须是最新版本才能更改日志配置。

-q

可选：不显示当天的消息或更新提示。

日志类型 ibm 的示例：

ibmcloud ks logging config update --cluster my_cluster --id f4bc77c0-ee7d-422d-aabf-a4e6b977264e --type ibm

日志类型 syslog 的示例：

ibmcloud ks logging config update --cluster my_cluster --id f4bc77c0-ee7d-422d-aabf-a4e6b977264e --hostname localhost --port 5514 --type syslog

ibmcloud ks logging filter create

虚拟私有云 经典基础架构

过滤掉根据日志记录配置转发的日志。

ibmcloud ks logging filter create --cluster CLUSTER --type LOG_TYPE [--logging-config CONFIG] [--namespace KUBERNETES_NAMESPACE] [--container CONTAINER_NAME] [--level LOGGING_LEVEL] [--message MESSAGE] [--regex-message MESSAGE] [--force-update] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必填：要为其创建日志过滤器的群集名称或 ID。

--type LOG_TYPE

要应用过滤器的日志的类型。 目前支持 all、container 和 host。

-lc, --logging-config CONFIG

可选：日志配置 ID。 如果未提供，过滤器将应用于传递给过滤器的所有群集日志记录配置。 使用 --show-matching-configs 命令选项，可以查看与过滤器匹配的日志配置。 要指定多个 ID，请使用多个选项，如 -lc id1 -lc id2。

-n, --namespace KUBERNETES_NAMESPACE

可选：想要从其中过滤日志的 Kubernetes 名称空间。

--container CONTAINER_NAME

可选：想要从其中过滤掉日志的容器的名称。 该选项仅适用于使用日志类型 container 时。

--level LOGGING_LEVEL

可选：过滤掉处于指定级别及更低级别的日志。 可接受的值按其规范顺序排列为 fatal, error, warn/warning, info, debug 和 trace。 例如，如果您过滤了 info 级别的日志，那么 debug，和 trace 也会被过滤。 注意：只有当日志信息是 JSON 格式且包含级别字段时，才能使用此选项。 示例输出 {"log": "hello", "level": "info"}

--message MESSAGE

可选：过滤掉日志中的任何地方包含了指定消息的任何日志。 例如信息 "Hello"、"!"和 "Hello, World!"适用于日志 "Hello, World!"。

--regex-message MESSAGE

可选：过滤掉任何包含指定信息的日志，该信息以正则表达式的形式写在日志的任何位置。 例如模式 "hello [0-9] "适用于 "hello 1"、"hello 2 "和 "hello 9"。

--force-update

强制 Fluentd pod 更新到最新版本。 Fluentd 必须是最新版本才能更改日志配置。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

此示例过滤掉满足以下条件的所有日志：从缺省名称空间中名称为 test-container 的容器转发，处于 debug 级别或更低级别，并且具有包含“GET request”的日志消息。

ibmcloud ks logging filter create --cluster example-cluster --type container --namespace default --container test-container --level debug --message "GET request"

此示例可过滤掉从特定群集转发的所有日志，级别为 info 或更低。 输出会作为 JSON 返回。

ibmcloud ks logging filter create --cluster example-cluster --type all --level info --output json

ibmcloud ks logging filter get

虚拟私有云 经典基础架构

查看日志记录过滤器配置。

ibmcloud ks logging filter get --cluster CLUSTER [--id FILTER_ID] [--show-matching-configs] [--show-covering-filters] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必填：要查看筛选器的群集名称或 ID。

--id FILTER_ID

要查看的日志过滤器的标识。

--show-matching-configs

可选：显示与您正在查看的配置匹配的日志配置。

--show-covering-filters

可选：显示使先前过滤器呈现为已废弃的日志记录过滤器。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging filter get --cluster mycluster --id 885732 --show-matching-configs

ibmcloud ks logging filter rm

虚拟私有云 经典基础架构

删除日志记录过滤器。

ibmcloud ks logging filter rm --cluster CLUSTER [--id FILTER_ID] [--all] [--force-update] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

要删除其中过滤器的集群的名称或标识。

--id FILTER_ID

要删除的日志过滤器的标识。

--all

可选：删除所有日志转发过滤器。

--force-update

强制 Fluentd pod 更新到最新版本。 Fluentd 必须是最新版本才能更改日志配置。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging filter rm --cluster mycluster --id 885732

ibmcloud ks logging filter update

虚拟私有云 经典基础架构

更新日志记录过滤器。

ibmcloud ks logging filter update --cluster CLUSTER --id FILTER_ID --type LOG_TYPE [--logging-config CONFIG] [--namespace KUBERNETES_NAMESPACE] [--container CONTAINER_NAME] [--level LOGGING_LEVEL] [--message MESSAGE] [--regex-message MESSAGE] [--force-update] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：您要更新日志过滤器的群集名称或 ID。

--id FILTER_ID

要更新的日志过滤器的标识。

--type LOG_TYPE

要应用过滤器的日志的类型。 目前支持 all、container 和 host。

-lc, --logging-config CONFIG

可选：日志配置 ID。 如果未提供，过滤器将应用于传递给过滤器的所有群集日志记录配置。 使用 --show-matching-configs 命令选项，可以查看与过滤器匹配的日志配置。 要指定多个 ID，请使用多个选项，如 -lc id1 -lc id2。

-n, --namespace KUBERNETES_NAMESPACE

可选：想要从其中过滤日志的 Kubernetes 名称空间。

--container CONTAINER_NAME

可选：想要从其中过滤掉日志的容器的名称。 该选项仅适用于使用日志类型 container 时。

--level LOGGING_LEVEL

可选：过滤掉处于指定级别及更低级别的日志。 可接受的值按其规范顺序排列为 fatal, error, warn/warning, info, debug 和 trace。 例如，如果您过滤了 info 级别的日志，那么 debug，和 trace 也会被过滤。 注意：只有当日志信息是 JSON 格式且包含级别字段时，才能使用此选项。 示例输出 {"log": "hello", "level": "info"}

--message MESSAGE

可选：过滤掉日志中的任何地方包含了指定消息的任何日志。 例如信息 "Hello"、"!"和 "Hello, World!"适用于日志 "Hello, World!"。

--regex-message MESSAGE

可选：过滤掉任何包含指定信息的日志，该信息以正则表达式的形式写在日志的任何位置。 例如模式 "hello [0-9] "适用于 "hello 1"、"hello 2 "和 "hello 9"

--force-update

强制 Fluentd pod 更新到最新版本。 Fluentd 必须是最新版本才能更改日志配置。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

此示例过滤掉满足以下条件的所有日志：从缺省名称空间中名称为 test-container 的容器转发，处于 debug 级别或更低级别，并且具有包含“GET request”的日志消息。

ibmcloud ks logging filter update --cluster example-cluster --id 885274 --type container --namespace default --container test-container --level debug --message "GET request"

此示例可过滤掉从特定群集转发的所有日志，级别为 info 或更低。 输出会作为 JSON 返回。

ibmcloud ks logging filter update --cluster example-cluster --id 274885 --type all --level info --output json

ibmcloud ks logging refresh

虚拟私有云 经典基础架构

刷新集群的日志记录配置。 此操作将刷新转发到集群中空间级别的任何日志记录配置的日志记录令牌。

不推荐使用此命令的 logging config refresh 别名。

ibmcloud ks logging refresh --cluster CLUSTER [--force-update] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--force-update

强制 Fluentd pod 更新到最新版本。 Fluentd 必须是最新版本才能更改日志配置。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks logging refresh --cluster my_cluster

ibmcloud ks nlb-dns add

经典基础结构

在使用 ibmcloud ks nlb-dns create 命令创建的现有子域中添加一个或多个网络负载平衡器 (NLB) IP 地址。

例如，在多区经典集群中，您可以在每个区创建一个 NLB，以公开一个应用程序。 通过运行 ibmcloud ks nlb-dns create classic 可向子域注册 NLB IP。 日后，可将另一个专区添加到集群，并为该专区添加另一个 NLB。 可以使用此命令将新的 NLB IP 添加到此现有子域。 用户访问应用程序子域时，客户机会随机访问其中一个 IP，并且会向相应的 NLB 发送请求。

ibmcloud ks nlb-dns add --cluster CLUSTER --ip NLB_IP [--ip NLB2_IP2 --ip NLB3_IP ...] --nlb-host SUBDOMAIN [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--ip NLB_IP

要添加到子域的 NLB IP 地址。 要查看 NLB IP，请运行 kubectl get svc。 要指定多个 IP 地址，请使用多个 --ip 选项。

--nlb-host SUBDOMAIN

要向其添加 IP 的子域。 要查看现有子域，请运行 ibmcloud ks nlb-dns ls。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns add --cluster mycluster --ip 1.1.1.1 --nlb-host mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

ibmcloud ks nlb-dns create classic

经典基础结构

通过创建 DNS 子域来注册网络负载均衡器 (NLB) IP，可采用公共方式公开应用程序。

ibmcloud ks nlb-dns create classic --cluster CLUSTER --ip NLB_IP [--ip NLB2_IP --ip NLB3_IP ...] [--secret-namespace NAMESPACE] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--ip IP

要注册的网络负载均衡器 IP 地址。 要查看 NLB IP 地址，请运行 kubectl get svc。 要指定多个 IP 地址，请使用多个 --ip 选项。

--secret-namespace NAMESPACE

要在其中创建 Kubernetes 私钥（用于保存 NLB 的 SSL 证书信息）的 Kubernetes 名称空间。 如果不指定命名空间，秘密会自动在 default 命名空间中创建。

--type public

子域类型。 目前只支持 public。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns create classic --cluster mycluster --ip 1.1.1.1

ibmcloud ks nlb-dns create vpc-gen2

虚拟私有云

为 Network Load Balancer for VPC 或 Application Load Balancer for VPC创建 DNS 记录。

创建 Network Load Balancer for VPC时，将为集群中的每个专区分配负载均衡器外部 IP 地址。 创建 Application Load Balancer for VPC时，会为负载均衡器分配主机名。 如果需要具有 TLS 终止的应用程序子域，那么可以使用 ibmcloud ks nlb-dns create vpc-gen2 命令为 IP 地址或主机名创建 DNS 记录。IBM Cloud 负责为您生成和维护子域的通配符 SSL 证书。 您可以为公共和专用 VPC 负载均衡器创建子域。

ibmcloud ks nlb-dns create vpc-gen2 --cluster CLUSTER (--lb-host VPC_ALB_HOSTNAME | --ip VPC_NLB_IP) [--secret-namespace NAMESPACE] [--type (public|private)] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--lb-host VPC_ALB_HOSTNAME | --ip VPC_NLB_IP

对于 VPC 应用程序负载均衡器，这是负载均衡器主机名。 要查看负载平衡器主机名，请运行 kubectl get svc -o wide。 对于 VPC 网络负载均衡器，外部 IP 地址。 要指定多个 IP 地址，请使用多个 --ip 选项。 要查看负载平衡器 IP 地址，请运行 kubectl get svc -o wide。

--secret-namespace NAMESPACE

要在其中创建 Kubernetes 私钥（用于保存 NLB 的 SSL 证书信息）的 Kubernetes 名称空间。 如果不指定命名空间，秘密会自动在 default 命名空间中创建。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns create vpc-gen2 --cluster mycluster --lb-host 1234abcd-us-south.lb.appdomain.cloud --type public

ibmcloud ks nlb-dns get

虚拟私有云 经典基础架构

查看集群中注册的 NLB 主机名的详细信息。

ibmcloud ks nlb-dns get --cluster CLUSTER --nlb-subdomain SUBDOMAIN [--output OUTPUT] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--nlb-subdomain SUBDOMAIN

注册网络负载均衡器 (NLB) IP 地址的 DNS 子域。 要列出 NLB，请运行 ibmcloud ks nlb-dns ls --cluster mycluster。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns get --cluster mycluster --nlb-subdomain subDomain1

ibmcloud ks nlb-dns ls

在经典集群中，列出向 DNS 子域注册的网络负载均衡器 (NLB) IP 地址。 在 VPC 集群中，列出向 DNS 子域注册的 VPC 负载均衡器主机名。

ibmcloud ks nlb-dns ls --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns ls --cluster mycluster

ibmcloud ks nlb-dns monitor configure

在集群中为现有 NLB 主机名配置运行状况检查监视器。 要启用监控器，请加入 --enable 标志。 要更新现有监视器，请仅包含要更改的设置所对应的标志。

ibmcloud ks nlb-dns monitor configure --cluster CLUSTER --nlb-host HOST [--allows-insecure] [--description DESCRIPTION] [--enable] [--expected-body BODY] [--expected-codes CODES] [--follows-redirects] [--header HEADER ...] [--interval INTERVAL] [--method METHOD] [--output OUTPUT] [--path PATH] [--port PORT] [-q] [--retries RETRIES] [--timeout TIMEOUT] [--type TYPE]

命令选项

--allows-insecure

已废弃 设为 true 则不验证证书。 该标记仅对 HTTP 或 HTTPS 类型有效。 停用说明：今后，健康监测器将不再验证证书。

--cluster CLUSTER, -c CLUSTER

指定集群名称或标识。

--description DESCRIPTION

已废弃 健康监控器的描述。

--enable

为主机名启用运行状况检查监视器。

--expected-body BODY

已弃用 健康检查在响应正文中查找的不区分大小写的子字符串。 如果找不到此字符串，那么会认为该 IP 运行状况不佳。 该标记仅对 HTTP 或 HTTPS 类型有效。

--expected-codes CODES

已弃用 HTTP 健康检查在响应中查找的代码。 如果找不到 HTTP 代码，那么 IP 会被视为运行状况欠佳。 该标记仅对 HTTP 或 HTTPS 类型有效。 默认值：2xx。 弃用说明：今后，HTTP / HTTPS 类型监控程序将接受所有有效的 HTTP / HTTPS 响应。

--follows-redirects

已废弃 设置为 true，以跟踪 IP 返回的任何重定向。 该标记仅对 HTTP 或 HTTPS 类型有效。

--header HEADER

已弃用 HTTP 在健康检查中发送的请求标头，如 Host 标头。 无法覆盖 User-Agent 头。 该标记仅对 HTTP 或 HTTPS 类型有效。 要向请求添加多个头，请多次指定此标志。 该标志接受以下格式的数值：--header Header-Name=value. 更新监视器时，指定的头将替换现有头。 要删除所有现有标头，请使用空值指定标记 --header ""。 弃用说明：今后只有 "Host "标头可以配置。

--interval INTERVAL

各个运行状况检查之间的时间间隔（以秒为单位）。 较短的时间间隔可缩短故障转移时间，但会增加 IP 上的负载。 该值必须大于 (retries_value + 1) * timeout_value，且必须在 [60、300 之间]。 缺省值： 60

--method METHOD

已弃用 用于健康检查的方法。 HTTP 和 HTTPS 的默认值：GET。 TCP 的默认值：connection_established。 停用说明：今后，所有健康监测器都将使用 GET。

--nlb-host HOST

主机名。 要查看现有主机名，请运行 ibmcloud ks nlb-dns ls。

--output OUTPUT

以提供的格式打印命令输出。 接受的值： json

--path PATH

运行状况检查所依据的端点路径。 该标记仅对 HTTP 或 HTTPS 类型有效。 缺省值： /

--port PORT

进行运行状况检查时要连接到的端口号。 如果类型为 TCP，那么此标志是必需的。 如果类型为 HTTP 或 HTTPS，此标志仅用于除 80（针对 HTTP）或 443（针对 HTTPS）以外的端口。 HTTP 默认值：。80 HTTPS 默认值：。443

-q

不显示每日消息或更新提示。

--retries RETRIES

已弃用 出现超时时，在 IP 被视为不健康之前尝试重试的次数。 重试会立即尝试执行。 必须在 [0、5 的]范围内。 缺省值： 2

--timeout TIMEOUT

超时（以秒为单位），在此时间后 IP 会被视为运行状况欠佳。 必须在 [1-60] 范围内。 缺省值： 5

--type TYPE

用于运行状况检查的协议。 接受值：http, https、tcp

ibmcloud ks nlb-dns monitor configure --cluster mycluster --nlb-host mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud --enable --description "Login page monitor" --type HTTPS --method GET --path / --timeout 5 --retries 2 --interval 60  --expected-body "healthy" --expected-codes 2xx --follows-redirects true

ibmcloud ks nlb-dns monitor disable

经典基础结构

对集群中的子域禁用现有运行状况检查监视器。

ibmcloud ks nlb-dns monitor disable --cluster CLUSTER --nlb-host SUBDOMAIN [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--nlb-host SUBDOMAIN

监视器对其执行运行状况检查的子域。 要列出子域，请运行 ibmcloud ks nlb-dns ls --cluster CLUSTER。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns monitor disable --cluster mycluster --nlb-host mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

ibmcloud ks nlb-dns monitor enable

经典基础结构

启用配置的运行状况检查监视器。

首次创建运行状况检查监视器时，必须使用 ibmcloud ks nlb-dns monitor configure 命令来配置并启用该监视器。 使用 ibmcloud ks nlb-dns monitor enable 命令仅可启用已配置但尚未启用的监视器，或者重新启用先前禁用的监视器。

ibmcloud ks nlb-dns monitor enable --cluster CLUSTER --nlb-host SUBDOMAIN [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--nlb-host SUBDOMAIN

监视器对其执行运行状况检查的子域。 要列出子域，请运行 ibmcloud ks nlb-dns ls --cluster CLUSTER。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns monitor enable --cluster mycluster --nlb-host mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

ibmcloud ks nlb-dns monitor get

经典基础结构

查看现有运行状况检查监视器的设置。

ibmcloud ks nlb-dns monitor get --cluster CLUSTER --nlb-host SUBDOMAIN [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--nlb-host SUBDOMAIN

监视器对其执行运行状况检查的子域。 要列出子域，请运行 ibmcloud ks nlb-dns ls --cluster CLUSTER。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns monitor get --cluster mycluster --nlb-host mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

ibmcloud ks nlb-dns monitor ls

经典基础结构

列出集群中每个 NLB 子域的运行状况检查监视器设置。

ibmcloud ks nlb-dns monitor ls --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns monitor ls --cluster mycluster

ibmcloud ks nlb-dns replace

虚拟私有云

替换已向 DNS 子域注册的负载均衡器主机名。 例如，如果您为应用程序创建了一个新的 VPC 负载平衡器，但不想创建一个新的 DNS 子域供用户访问应用程序，您可以用新负载平衡器的主机名替换旧负载平衡器的主机名。

ibmcloud ks nlb-dns replace --cluster CLUSTER --lb-host NEW_LB_HOSTNAME --nlb-subdomain SUBDOMAIN [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--lb-host NEW_LB_HOSTNAME

用于更新子域的新 VPC 负载均衡器的主机名。 要查看 VPC 负载均衡器主机名，请运行 kubectl get svc -o wide。

nlb-subdomain SUBDOMAIN

要替换负载均衡器主机名的 DNS 子域。 要查看现有子域，请运行 ibmcloud ks nlb-dns ls --cluster <cluster>。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns replace --cluster mycluster --lb-host 1234abcd-us-south.lb.appdomain.cloud nlb-subdomain mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

ibmcloud ks nlb-dns rm classic

经典基础结构

从子域中除去网络负载均衡器 (NLB) IP 地址。 如果从子域中除去所有 IP，该子域仍然会存在，但没有与之关联的 IP。 注意：必须为每个要删除的 IP 地址运行此命令。

ibmcloud ks nlb-dns rm classic --cluster CLUSTER --ip IP --nlb-host SUBDOMAIN [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--ip IP

要除去的 NLB IP。 要查看每个子域注册的 IP，请运行 ibmcloud ks nlb-dns ls --cluster <cluster>。

--nlb-host SUBDOMAIN

要从中除去 IP 的子域。 要查看现有子域，请运行 ibmcloud ks nlb-dns ls。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns rm classic --cluster mycluster --ip 1.1.1.1 --nlb-host mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

ibmcloud ks nlb-dns rm vpc-gen2

虚拟私有云

从该负载均衡器的 DNS 记录中除去负载均衡器主机名 (VPC 应用程序负载均衡器) 或 IP 地址 (VPC 网络负载均衡器)。

删除主机名或 IP 地址后，DNS 子域仍然存在，但没有负载平衡器注册。

ibmcloud ks nlb-dns rm vpc-gen2 --cluster CLUSTER --nlb-subdomain SUBDOMAIN [ --ip IP] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--nlb-subdomain SUBDOMAIN

要与 VPC 负载平衡器主机名解除关联的子域。 要查看现有子域，请运行 ibmcloud ks nlb-dns ls --cluster <cluster>。

--ip IP

对于 VPC 网络负载均衡器，这是要除去的 IP 地址。 要查看每个子域注册的 IP，请运行 ibmcloud ks nlb-dns ls --cluster <cluster>。 请注意，必须为每个要删除的 IP 地址重复执行此命令。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns rm vpc-gen2 --cluster mycluster --nlb-subdomain mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

实验: ibmcloud ks nlb-dns secret regenerate

虚拟私有云 经典基础架构

重新生成 NLB 子域的证书和密钥。 密钥重新生成不会造成中断，并且在密钥重新生成时流量会继续流动。

如果在私钥重新生成期间 Let 's Encrypt 证书创建失败，那么必须经过 10 分钟的等待时间，然后再自动尝试重新生成。 重新生成私钥需要另外 5 分钟才能完成，因此在完成此过程之前总共需要 15 分钟时间。

要避免 Let 's Encrypt 速率限制，请勿每天重新生成超过 5 次的私钥。

ibmcloud ks nlb-dns secret regenerate --cluster CLUSTER --nlb-subdomain SUBDOMAIN [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--nlb-subdomain SUBDOMAIN

要为其重新生成私钥的子域。 要列出子域，请运行 ibmcloud ks nlb-dns ls --cluster CLUSTER。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns secret regenerate --cluster mycluster --nlb-subdomain mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

实验: ibmcloud ks nlb-dns secret rm

虚拟私有云 经典基础架构

从 NLB 子域中删除密钥，并阻止证书的未来续订。

如果不再使用 NLB 子域，或者该子域的所有者离开您的组织，那么可以删除该子域的私钥。

ibmcloud ks nlb-dns secret rm --cluster CLUSTER --nlb-subdomain SUBDOMAIN [-f] [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 编辑者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--nlb-subdomain SUBDOMAIN

要删除其私钥的子域。 要列出子域，请运行 ibmcloud ks nlb-dns ls --cluster CLUSTER。

-f

可选：强制命令在没有用户提示的情况下运行。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks nlb-dns secret rm --cluster mycluster --nlb-subdomain mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud

命令选项

--cluster CLUSTER, -c CLUSTER

指定集群名称或标识。

--disable-outbound-traffic-protection

包含此选项以允许来自集群工作程序的公共出站访问。 默认情况下，会阻止公共向外访问。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

示例 webhook-create 命令

ibmcloud ks webhook-create --cluster my_cluster --level Normal --type slack --url http://github.com/mywebhook

ibmcloud ks api-key info

虚拟私有云 经典基础架构

查看 IBM Cloud Identity and Access Management (IAM) API 密钥的所有者的名称和电子邮件地址，IBM Cloud Kubernetes Service 使用此 API 密钥来认证某些请求，例如区域和资源组中的基础结构。

要为资源组和区域创建不同的 API 密钥，请使用 ibmcloud ks api-key reset 命令。

如果使用 ibmcloud ks credential set 命令手动设置 IBM Cloud 基础架构凭证，那么此命令中返回的 API 密钥不会用于基础架构许可权。

ibmcloud ks api-key info --cluster CLUSTER [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

-c, --cluster CLUSTER

必须填写：群集的名称或 ID。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks api-key info --cluster my_cluster

ibmcloud ks api-key reset

虚拟私有云 经典基础架构

创建 IBM Cloud IAM API 密钥，以模拟用户的许可权来认证当前资源组和区域中所有集群的请求。

如果在集群中使用 Block Storage for VPC 或集群自动缩放器附加组件，那么必须在重置 API 密钥后重新创建附加组件控制器 pod。 有关更多信息，请参阅 Block Storage for VPC PVC 创建在 API 密钥重置后失败 和 API 密钥重置后自动缩放失败。

使用该命令前，请确保运行该命令的用户拥有所需的 IBM Cloud Kubernetes Service 和 IBM Cloud 基础架构权限。 将要为其设置 API 密钥的资源组和区域设定为目标。 重置 API 密钥时，先前用于区域和资源组的 API 密钥 (如果有) 现在已过时。 然后，可以从 API 密钥列表中删除旧 API 密钥。 重置 API 密钥之前，请检查是否有其他服务使用现有 API 密钥，例如 密钥管理服务(KMS)提供程序 或 Secrets Manager。

ibmcloud ks api-key reset --region REGION [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--region REGION

在 IBM Cloud Kubernetes Service中指定区域: jp-osa，jp-tok，au-syd，eu-de，eu-gb，us-east 或 us-south。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks api-key reset --region us-south

ibmcloud ks credential get

经典基础结构

如果您将 IBM Cloud 账户设置为使用不同凭据访问 IBM Cloud 基础设施组合，请获取当前目标区域和资源组的基础设施用户名。

ibmcloud ks credential get --region REGION [-q] [--output json]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--region REGION

在 IBM Cloud Kubernetes Service中指定区域: jp-osa，jp-tok，au-syd，eu-de，eu-gb，us-east 或 us-south。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks credential get --region us-south

ibmcloud ks credential set classic

经典基础结构

为资源组和区域设置凭证，以便可以通过 IBM Cloud 帐户访问 IBM Cloud 基础架构产品服务组合。

如果您有 IBM Cloud 现收现付帐户，那么缺省情况下您有权访问 IBM Cloud 基础架构产品服务组合。 但是，您可能希望使用不同的现有 IBM Cloud 基础架构帐户来订购基础架构。 您可以使用此命令将此基础架构帐户链接到 IBM Cloud 帐户。

如果为某个区域和资源组手动设置了 IBM Cloud 基础架构凭证，那么这些凭证会用于为该资源组中该区域内的所有集群订购基础架构。 这些凭证用于确定基础架构许可权，即使已存在该资源组和区域的 IBM CloudIAM API 密钥也不例外。 如果存储了其凭证的用户没有必需的许可权来订购基础架构，那么与基础架构相关的操作（例如，创建集群或重新装入工作程序节点）可能会失败。

不能为同一个 IBM Cloud Kubernetes Service 资源组和区域设置多个证书。

使用此命令之前，请确保使用其凭证的用户具有必需的 IBM Cloud Kubernetes Service 和 IBM Cloud 基础架构许可权。

ibmcloud ks credential set classic --infrastructure-api-key API_KEY --infrastructure-username USERNAME --region REGION [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--infrastructure-username USERNAME

必填：IBM Cloud 基础设施账户 API 用户名。 基础架构 API 用户名与 IBM 标识不同。 要查看基础架构 API 用户名，请参阅 管理经典基础架构 API 密钥。

--infrastructure-api-key API_KEY

需要：IBM Cloud 基础设施账户 API 密钥。 要查看或生成基础架构 API 密钥，请参阅管理经典基础架构 API 密钥。

--region REGION

在 IBM Cloud Kubernetes Service中指定区域: jp-osa，jp-tok，au-syd，eu-de，eu-gb，us-east 或 us-south。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks credential set classic --infrastructure-api-key <api_key> --infrastructure-username dbmanager --region us-south

ibmcloud ks credential unset

经典基础结构

除去资源组和区域的凭证，以除去通过 IBM Cloud 帐户对 IBM Cloud 基础架构产品服务组合的访问权。

除去凭证后，将使用 IBM CloudIAM API 密钥来订购 IBM Cloud 基础架构中的资源。

ibmcloud ks credential unset --region REGION [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--region REGION

在 IBM Cloud Kubernetes Service中指定区域: jp-osa，jp-tok，au-syd，eu-de，eu-gb，us-east 或 us-south。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks credential unset --region us-south

ibmcloud ks infra-permissions get

经典基础结构

检查允许访问 IBM Cloud 基础架构产品服务组合（对于目标资源组和区域）的凭证是否缺少建议或必需的基础架构许可权。

如果区域和资源组的基础架构凭证缺少任何许可权，那么此命令的输出会返回required和suggested许可权的列表。

• 必需：成功订购和管理基础架构资源（例如，工作程序节点）需要这些许可权。 如果基础架构凭证缺少其中某个许可权，那么对区域和资源组中的所有集群执行的 worker reload 等常见操作会失败。
• 建议：将这些许可权包含在基础架构许可权中会非常有用，并且在某些用例中这些许可权可能是必需的。 例如，Add Compute with Public Network Port基础架构许可权是建议许可权，因为如果需要公用网络，那么会需要此许可权。 但是，如果用例是位于仅专用 VLAN 上的集群，那么无需此许可权，因此不会将其视为required。

有关按许可权列出的常见用例的列表，请参阅基础架构角色。

如果在控制台或 基础架构角色 表中找不到某个基础架构权限，该怎么办？

Support Case许可权和基础架构许可权是在控制台的不同部分中进行管理的。 请参阅 定制基础架构许可权。

我要分配哪些基础架构权限？

如果您公司的许可权策略很严格，那么可能需要限制集群用例的suggested许可权。 否则，请确保区域和资源组的基础架构凭证包含所有required和suggested许可权。

对于大多数用例，请使用相应的基础架构许可权为区域和资源组设置 API 密钥。 如果需要使用不同于当前帐户的其他基础架构帐户，请设置手动凭证。

如何控制用户可以执行的操作？

基础架构凭证设置完成后，您可以通过为用户分配 IBM Cloud IAM 平台访问角色 来控制用户可以执行的操作。

ibmcloud ks infra-permissions get --region REGION [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 查看者 平台访问角色

命令选项：

--region REGION

必需: 在 IBM Cloud Kubernetes Service中指定区域: jp-osa，jp-tok，au-syd，eu-de，eu-gb，us-east 或 us-south。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks infra-permissions get --region us-south

Missing Virtual Worker Permissions

Add Server                    suggested
Cancel Server                 suggested
View Virtual Server Details   required

Missing Physical Worker Permissions

No changes are suggested or required.

Missing Network Permissions

No changes are suggested or required.

Missing Storage Permissions

Add Storage       required
Manage Storage    required

ibmcloud ks kms crk ls

虚拟私有云 经典基础架构

列出密钥管理服务实例中可用的客户根密钥 (CRK)。 根密钥打包并解包集群用于加密其密钥的本地数据加密密钥 (DEK)。 有关更多信息，请参阅 了解密钥管理服务(KMS)提供程序。

请勿删除 KMS 实例中的根密钥，即使轮换使用新密钥也是如此。 如果删除群集使用的根密钥，群集将无法使用，丢失所有数据，并且无法恢复。

ibmcloud ks kms crk ls --instance-id KMS_INSTANCE_ID [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中的 查看者 平台访问角色

命令选项：

--instance-id KMS_INSTANCE_ID

要列出其根密钥的密钥管理服务实例的标识。 要列出可用的 KMS 实例，请运行 ibmcloud ks kms instance ls。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks kms crk ls --instance-id 1aa1a111-1111-1111-a111-a1aaaa1a1a1a

ibmcloud ks kms enable

虚拟私有云 经典基础架构

在集群中 启用密钥管理服务（KMS）提供商，加密 Kubernetes 秘密。 要使用现有密钥加密在集群中轮换密钥，请使用新的根密钥标识重新运行此命令。

请勿删除 KMS 实例中的根密钥，即使轮换使用新密钥也是如此。 如果删除群集使用的根密钥，群集将无法使用，丢失所有数据，并且无法恢复。 当您轮换根密钥时，不能对同一集群复用先前的根密钥。

ibmcloud ks kms enable --cluster CLUSTER_NAME_OR_ID --instance-id KMS_INSTANCE_ID --crk ROOT_KEY_ID [--kms-account-id ID] [--public-endpoint] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中集群的 管理员 平台访问角色

命令选项：

--container, -c CLUSTER_NAME_OR_ID

集群的名称或标识。

--instance-id KMS_INSTANCE_ID

要用于对集群中的私钥进行加密的 KMS 实例的标识。 要列出可用的 KMS 实例，请运行 ibmcloud ks kms instance ls。

--crk ROOT_KEY_ID

要用于打包集群中本地存储的数据加密密钥 (DEK) 的 KMS 实例中客户根密钥 (CRK) 的标识。 要列出可用的根密钥，请运行 ibmcloud ks kms crk ls --instance-id <kms_instance_id>。

--kms-account-id ID

可选项：包含要用于本地磁盘或秘密加密的 KMS 实例的账户 ID。

--public-endpoint

可选：指定此选项可使用 KMS 公共云服务端点。 如果不包含此选项，那么缺省情况下将使用私有云服务端点。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks kms enable -c mycluster --instance-id a11aa11a-bbb2-3333-d444-e5e555e5ee5 --crk 1a111a1a-bb22-3c3c-4d44-55e555e55e55

ibmcloud ks kms instance ls

虚拟私有云 经典基础架构

列出您可以选择在集群中启用的 IBM Cloud 帐户中可用的 密钥管理服务(KMS)实例。

ibmcloud ks kms instance ls [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 中的 查看者 平台访问角色

命令选项：

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

示例：

ibmcloud ks kms instance ls

ibmcloud ks quota ls

虚拟私有云 经典基础架构

列出 IBM Cloud 账户中与群集相关资源的所有配额和限制。

ibmcloud ks quota ls [--provider PROVIDER] [--output json]

最低必需许可权

IBM Cloud Kubernetes Service 的 查看者 平台访问角色

命令选项：

--provider (classic | vpc-gen2)

要列出配额和限制的基础架构提供者类型。

--output json

可选：以 JSON 格式打印命令输出。

示例：

ibmcloud ks quota ls

ibmcloud ks vlan ls

经典基础结构

列出可用于经典 IBM Cloud 基础架构帐户中专区的公用和专用 VLAN。 要列出可用 VLAN，您必须具有付费帐户。

ibmcloud ks vlan ls --zone ZONE [--all] [--output json] [-q]

最低必需许可权：

• 要查看群集在区域中连接的 VLAN，请执行以下操作中群集的查看器平台访问角色 IBM Cloud Kubernetes Service
• 要列出区域中所有可用的 VLAN，请执行以下操作中区域的查看器平台访问角色 IBM Cloud Kubernetes Service

命令选项：

--zone ZONE

需要：输入要列出专用和公用 VLAN 的区域。 要查看可用专区，请运行 ibmcloud ks zone ls。

--all

列出所有可用的 VLAN。 缺省情况下，会对 VLAN 进行过滤，以仅显示有效的 VLAN。 要使 VLAN 有效，必须将 VLAN 与可使用本地磁盘存储来托管工作程序的基础架构相关联。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks vlan ls --zone dal10

ibmcloud ks vlan spanning get

经典基础结构

查看 IBM Cloud 基础架构帐户的 VLAN 生成状态。 VLAN 生成支持帐户中的所有设备通过专用网络相互通信，而不管设备分配给哪个 VLAN。

对于在启用 VRF 的帐户中创建的集群，已禁用 VLAN 生成选项。 启用 VRF 时，帐户中的所有 VLAN 都可以通过专用网络自动相互通信。 要检查是否已启用 VRF，请使用 ibmcloud account show 命令。 有关更多信息，请参阅规划集群网络设置：工作程序到工作程序的通信。

ibmcloud ks vlan spanning get --region REGION [--output json] [-q]

最低必需许可权

IBM Cloud Kubernetes Service 的 查看者 平台访问角色

命令选项：

--region REGION

在 IBM Cloud Kubernetes Service中指定区域: jp-osa，jp-tok，au-syd，eu-de，eu-gb，us-east 或 us-south。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks vlan spanning get --region us-south

命令选项

--output OUTPUT

以提供的格式打印命令输出。 接受的值： json --provider PROVIDER

VPC 基础结构提供程序类型。 支持的值为 vpc-classic 和 vpc-gen2。 缺省情况下，将返回所有提供程序类型的 VPC。

-q

不显示每日消息或更新提示。

命令选项

--cluster CLUSTER, -c CLUSTER

指定集群名称或标识。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

命令选项

--cluster CLUSTER, -c CLUSTER

指定集群名称或标识。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

flavor get 命令

虚拟私有云 经典基础架构

获取区域和提供者的类型模板信息。

ibmcloud ks flavor get --flavor FLAVOR --provider PROVIDER --zone ZONE [--output OUTPUT] [-q]

最低必需许可权

无

命令选项：

--flavor FLAVOR

要获取其信息的类型模板。 类型将确定可供每个工作程序节点使用的虚拟 CPU、内存和磁盘空间。

--provider PROVIDER

要获取其类型模板信息的基础结构提供程序。 可用的选项有 classic、vpc-classic 和 vpc-gen2。

--zone ZONE

要获取其类型模板信息的区域。 要查看经典集群的可用专区，请运行 ibmcloud ks zone ls。 要查看 VPC 集群的可用区域，请运行 ibmcloud ks zone ls --provider vpc-gen2 for Generation 2 计算。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks flavor get --zone us-south-1 --provider vpc-gen2 --flavor bx2d.48x192.900gb

flavor ls 命令

虚拟私有云 经典基础架构

列出某个区域的可用类型。

ibmcloud ks flavor ls --zone ZONE [--output OUTPUT] [--provider PROVIDER] [-q] [--show-os] [--show-storage]

最低必需许可权

无

命令选项：

--zone ZONE

要获取其类型模板信息的区域。 要查看经典集群的可用专区，请运行 ibmcloud ks zone ls。 要查看 VPC 集群的可用区域，请运行 ibmcloud ks zone ls --provider vpc-gen2 for Generation 2 计算。

--provider PROVIDER

可选: 要获取其类型模板信息的基础结构提供程序。 可用的选项有 classic、vpc-classic 和 vpc-gen2。

--show-os

可选：列出支持的操作系统。

--show-storage

可选: 显示可用于 SDS 工作程序节点类型模板的其他原始磁盘。 有关更多信息，请参阅 软件定义的存储器(SDS)机器。 在各都市区部分的表格中，SDS 味道位于 Bare Metal 选项卡中，并以 .ssd 结尾。

--output json

可选：以 JSON 格式打印命令输出。

-q

可选：不显示当天的消息或更新提示。

ibmcloud ks flavor ls --zone us-south-1 --provider vpc-gen2 --show-os --show-storage