指令選項

-q

不要顯示日或更新提示的訊息。

範例

檢視現行 API 端點

ibmcloud ks api

範例

顯示說明

ibmcloud ks api-key help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集的 API 金鑰持有者相關資訊

ibmcloud ks api-key info --cluster CLUSTER

指令選項

-f

強制執行指令，而不出現使用者提示。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--region

請指定要設為目標的地區。

範例

替換指定區域內所有叢集及目標資源群組的 API 金鑰

ibmcloud ks api-key reset --region REGION

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用 Red Hat 的「進階叢集管理」附加元件

ibmcloud ks cluster addon disable acm --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用 ALB「OAuth」代理程式附加元件

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用「叢集自動擴展」附加元件

ibmcloud ks cluster addon disable cluster-autoscaler --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用「診斷與除錯工具」附加元件

ibmcloud ks cluster addon disable debug-tool --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用「頭燈」附加元件

ibmcloud ks cluster addon disable headlamp --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster addon disable help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用 HPCS 路由器操作員附加元件，以 OpenShift

ibmcloud ks cluster addon disable hpcs-router --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用「IBM Cloud」儲存運算子附加元件

ibmcloud ks cluster addon disable ibm-storage-operator --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

IBM Cloud 影像金鑰同步器 擴充套件

ibmcloud ks cluster addon disable image-key-synchronizer --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用受管版「Istio」附加元件

ibmcloud ks cluster addon disable istio --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用額外的 Istio 元件：Grafana、Jaeger 以及 Kiali

ibmcloud ks cluster addon disable istio-extras --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用「Istio」BookInfo 範例應用程式附加元件（已廢棄）

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用 Knative 無伺服器框架附加元件

ibmcloud ks cluster addon disable knative --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用「Kubernetes」網頁終端附加元件

ibmcloud ks cluster addon disable kube-terminal --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

Red Hat OpenShift Data Foundation on IBM Cloud 附加程式

ibmcloud ks cluster addon disable openshift-data-foundation --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用「靜態路由」附加元件

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用 VPC Block Storage CSI 驅動程式附加元件

ibmcloud ks cluster addon disable vpc-block-csi-driver --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

--param

指定附加程式的安裝選項。 如果未指定參數，則會使用預設值。 請使用 ibmcloud ks cluster addon options 指令檢視可用的選項。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用「Red Hat」進階叢集管理附加元件

ibmcloud ks cluster addon enable acm --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用 ALB「OAuth」代理程式附加元件

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用「叢集自動擴展」附加元件

ibmcloud ks cluster addon enable cluster-autoscaler --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用「診斷與除錯工具」附加元件

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用「頭燈」附加元件

ibmcloud ks cluster addon enable headlamp --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster addon enable help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用 HPCS 路由器操作員附加元件，適用於 OpenShift

ibmcloud ks cluster addon enable hpcs-router --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用「IBM Cloud」儲存運算子附加元件

ibmcloud ks cluster addon enable ibm-storage-operator --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

IBM Cloud 影像金鑰同步器 擴充套件

ibmcloud ks cluster addon enable image-key-synchronizer --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用受管 Istio 附加元件

ibmcloud ks cluster addon enable istio --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用額外的 Istio 元件：Grafana、Jaeger 以及 Kiali

ibmcloud ks cluster addon enable istio-extras --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

在叢集中啟用「Istio」BookInfo 範例應用程式附加元件（已廢棄）

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

--param

指定附加程式的安裝選項。 如果未指定參數，則會使用預設值。 請使用 ibmcloud ks cluster addon options 指令檢視可用的選項。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

Red Hat OpenShift Data Foundation on IBM Cloud 附加程式

ibmcloud ks cluster addon enable openshift-data-foundation --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用「靜態路由」附加元件

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

啟用所有附加程式相依關係。

範例

啟用 VPC「Block Storage」CSI 驅動程式附加元件

ibmcloud ks cluster addon enable vpc-block-csi-driver --cluster CLUSTER

指令選項

--addon

附加程式名稱或 ID。

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視已安裝附加元件的詳細資訊

ibmcloud ks cluster addon get --addon ADDON --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster addon help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出已啟用的附加元件

ibmcloud ks cluster addon ls --cluster CLUSTER

指令選項

--addon

附加程式名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--version

指定要顯示其選項的附加程式版本。 如果未指定版本，則會顯示預設版本的選項。

範例

檢視附加元件的安裝選項

ibmcloud ks cluster addon options --addon ADDON

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 Red Hat 進階叢集管理附加元件

ibmcloud ks cluster addon update acm --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 ALB「OAuth」代理程式附加元件

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新叢集自動擴展 (Cluster Autoscaler) 附加元件

ibmcloud ks cluster addon update cluster-autoscaler --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新「診斷與除錯工具」附加元件

ibmcloud ks cluster addon update debug-tool --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新「頭燈」擴充套件

ibmcloud ks cluster addon update headlamp --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster addon update help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 HPCS 路由器操作員附加元件，適用於 OpenShift

ibmcloud ks cluster addon update hpcs-router --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 IBM Cloud 儲存運算子附加元件

ibmcloud ks cluster addon update ibm-storage-operator --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新「Image Key Synchronizer」外掛程式

ibmcloud ks cluster addon update image-key-synchronizer --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新受管 Istio 外掛程式

ibmcloud ks cluster addon update istio --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新額外的 Istio 元件：Grafana、Jaeger 以及 Kiali

ibmcloud ks cluster addon update istio-extras --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 Istio BookInfo 範例應用程式附加元件（已廢棄）

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 Knative 無伺服器框架附加元件

ibmcloud ks cluster addon update knative --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 Kubernetes 網頁終端機外掛程式

ibmcloud ks cluster addon update kube-terminal --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 OpenShift Data Foundation 附加元件

ibmcloud ks cluster addon update openshift-data-foundation --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新「靜態路由」附加元件

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--version

指定要安裝的附加程式版本。 如果未指定任何版本，則會安裝預設版本。

-y

更新所有附加程式相依關係。

範例

更新 VPC Block Storage CSI 驅動程式附加元件

ibmcloud ks cluster addon update vpc-block-csi-driver --cluster CLUSTER

指令選項

--addon

指定附加程式名稱以針對其過濾版本。

--offering

請指定要篩選版本的服務。 有效值：kubernetes、openshift、openshift-vs

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--show-defaults

在輸出中顯示預設版本欄位。

範例

列出受支援的「受管理附加元件」版本

ibmcloud ks cluster addon versions

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

為您的叢集建立 CA 憑證

ibmcloud ks cluster ca create --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集的 CA 憑證詳細資訊

ibmcloud ks cluster ca get --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster ca help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

輪替叢集的 CA 憑證，這需要您事先已建立 CA 憑證

ibmcloud ks cluster ca rotate --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集的 CA 憑證輪替狀態

ibmcloud ks cluster ca status --cluster CLUSTER

指令選項

--admin

擷取管理者憑證和 PEM 金鑰。

-c, --cluster

請指定叢集名稱或 ID。

--endpoint

用於叢集環境定義的伺服器 URL。 如果您不包括此旗標，則會使用預設叢集服務端點。 如需更多資訊，請參閱 https://ibm.biz/context-kubeKubernetes，或 https://ibm.biz/context-ocpOpenShift 叢集。 有效值：private、link、vpe

--network

擷取具有管理者配置的 Calico 網路配置。

--output

以指定的格式輸出指令結果，並跳過 kubeconfig 的合併操作。 ZIP 輸出檔中不包含刷新代碼。 有效值：json、yaml、zip

-q

不要顯示日或更新提示的訊息。

--skip-rbac

跳過新增 RBAC 角色。 只有在您管理自己的 Kubernetes RBAC 角色時才包括此選項。 如果您使用 IAM 服務存取角色管理您的所有 RBAC 使用者，請勿包含此選項。

範例

下載 Kubernetes 的設定檔和憑證，以便透過 kubectl 指令連線至您的叢集

ibmcloud ks cluster config --cluster CLUSTER

指令選項

--disable-disk-encrypt

在工作者節點上停用加密。

--entitlement

僅當您將此叢集與具備「OpenShift」授權的許可證（例如「Cloud Pak」）一同使用時，才應將此標誌設定為「ocp_entitled」。

--flavor

工作程式節點的特性。 若要查看可用的版本，請執行 ibmcloud ks flavor ls --zone <zone name> （適用於 public. IBM Cloud 帳戶）或 ibmcloud ks flavor ls （適用於 IBM Cloud Dedicated 帳戶）。

--hardware

工作者節點的硬體隔離層次。 請使用 dedicated 以獲得僅供您專用的實體資源，或使用 shared 讓實體資源可與其他 IBM 客戶共享。 如果是 IBM Cloud 公用帳戶，會共用預設值。 如果是 IBM Cloud 專用帳戶，專用是唯一可用的選項。

--location

Deprecated 為維持與較早版本的相容性，此標記仍予保留。 請改用 --zone 標誌。

--name

輸入叢集的名稱。

--no-subnet

在建立叢集時，防止建立可攜式子網路。 依預設，會在相關聯的 VLAN 上建立公用和專用可攜式子網路，而此旗標會防止該行為。 若要稍後將子網添加至叢集，請執行 ibmcloud ks cluster subnet add。

--operating-system

指定作業系統的名稱。

--pod-subnet

指定自訂子網路 CIDR 為 POD 提供專用 IP 位址。 子網必須至少為 /23 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-classic

--private-only

使用此旗標來防止建立公用 VLAN。 僅在您指定 --private-vlan 標誌但未指定 --public-vlan 標誌時才需要此設定。

--private-service-endpoint

啟用專用服務端點以使主控節點可私下存取。

--private-vlan

條件：請指定私有 VLAN 的 ID。 若要查看可用的 VLAN，請執行 ibmcloud ks vlan ls --zone <zone name>。 如果您尚未擁有私人 VLAN，請勿指定此選項，因為系統會自動為您建立一個。 當您指定私有 VLAN 時，也必須同時指定「--public-vlan」標誌或「--private-only」標誌。

--public-service-endpoint

啟用公用服務端點以使主控節點可公開存取。

--public-vlan

條件：請指定公共 VLAN 的 ID。 若要查看可用的 VLAN，請執行 ibmcloud ks vlan ls --zone <zone name>。 如果您尚未擁有公共 VLAN，請勿指定此選項，因為系統會自動為您建立一個。

-q

不要顯示日或更新提示的訊息。

--service-subnet

指定自訂子網路 CIDR 為服務提供專用 IP 位址。 子網必須至少為 /24 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-classic。 預設值： 172.21.0.0/16

--skip-advance-permissions-check

完成此動作之前，請跳過檢查基礎架構權限。 請注意，如果您沒有適當的基礎架構權限，則此動作可能僅局部成功。

--sm-group

在其中持續保存密鑰的 IBM Cloud Secrets Manager 實例的密鑰群組 ID。

--sm-instance

IBM Cloud Secrets Manager 實例的 CRN。

--version

請指定 Kubernetes 或 OpenShift 版本，其中至少包括 major.minor 版本。 如果您不包括此旗標，則會使用預設版本。 若要查看可用的版本，請執行 ibmcloud ks versions。

--workers

叢集工作程式節點數。 預設值為 1。

--zone

指定多區域叢集中之工作程式儲存區的區域。 要列出可用的區域，請執行 ibmcloud ks zone ls。

範例

在傳統基礎架構上建立包含工作節點的叢集

ibmcloud ks cluster create classic --flavor FLAVOR --name NAME --zone ZONE --private-only

範例

顯示說明

ibmcloud ks cluster create help

指令選項

--enable-config-admin

授予叢集 admin 存取 Satellite Config 的權限，以便管理 Kubernetes 資源。

--entitlement

僅當您將此叢集與具備「OpenShift」授權的許可證（例如「Cloud Pak」）一同使用時，才應將此標誌設定為「ocp_entitled」。

--host-label, --hl

請以鍵值對的形式輸入任何標籤，用以識別要指派給您的 Satellite 控制平面或 Red Hat OpenShift 叢集的主機。 第一個具有此標籤且未經指派的主機將會自動指派給控制平面或叢集。 若要查詢可用的主機標籤，請執行 ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>``。

--infrastructure-topology

指定叢集應該執行單一工作者節點，還是預設工作者節點數目。 若要建立單節點叢集，請指定 single-replica。 若要建立一個包含多個工作節點的預設叢集，請指定 ` `highly-available。 預設情況下會套用「highly-available」選項。 允許的值：single-replica，highly-available

--location

Satellite 位置的名稱或 ID。 若要查詢位置的識別碼或名稱，請執行 ibmcloud sat location ls。

--name

輸入叢集的名稱。

--operating-system

指定作業系統的名稱。

--pod-network-interface-selection

選取內部 Pod 網路的節點網路介面的方法。 只有在您指定的 Satellite 位置已啟用 Red Hat CoreOS 時，才能使用此選項。 若要提供直接的 URL 或 IP 位址，請指定 can-reach=<url> 或 can-reach=<ip_address>。 若要選擇網路介面，請指定 interface=<network_interface>``。

--pod-subnet

指定自訂子網路 CIDR 為 POD 提供專用 IP 位址。 子網必須至少為 /23 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-satellite。 預設值： 172.30.0.0/16

--pull-secret

透過提供 Red Hat 帳戶取出密碼，為此叢集的工作者節點指定現有 OpenShift 授權。

-q

不要顯示日或更新提示的訊息。

--service-subnet

指定自訂子網路 CIDR 為服務提供專用 IP 位址。 子網必須至少為 /24 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-satellite。 預設值： 172.21.0.0/16

--sm-group

在其中持續保存密鑰的 IBM Cloud Secrets Manager 實例的密鑰群組 ID。

--sm-instance

IBM Cloud Secrets Manager 實例的 CRN。

--version

Red Hat OpenShift on IBM Cloud 版本，其中至少包括 major.minor 版本。 若要查看可用的版本，請執行 ibmcloud ks versions。

--workers

預設工作程式儲存區中每個區域的工作程式節點數。 當指定 --host-label 時，此參數為必填項目。

--zone

多重區域叢集中預設工作程式儲存區的區域。 若要列出您所在位置的區域，請執行 ibmcloud sat location get。

範例

在您自己的基礎架構上建立一個 IBM Cloud Satellite 叢集

ibmcloud ks cluster create satellite --location LOCATION --name NAME --version VERSION

指令選項

--disable-public-service-endpoint

停用公用服務端點以阻止對主控節點的公開存取。

--entitlement

僅當您將此叢集與具備「OpenShift」授權的許可證（例如「Cloud Pak」）一同使用時，才應將此標誌設定為「ocp_entitled」。

--flavor

工作程式節點的特性。 若要查看可用的版本，請執行 ibmcloud ks flavor ls --zone <zone name> （適用於 public. IBM Cloud 帳戶）或 ibmcloud ks flavor ls （適用於 IBM Cloud Dedicated 帳戶）。

--name

輸入叢集的名稱。

--operating-system

指定作業系統的名稱。

--pod-subnet

指定自訂子網路 CIDR 為 POD 提供專用 IP 位址。 子網必須至少為 /23 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-vpc

-q

不要顯示日或更新提示的訊息。

--service-subnet

指定自訂子網路 CIDR 為服務提供專用 IP 位址。 子網必須至少為 /24 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-vpc。 預設值： 172.21.0.0/16

--sm-group

在其中持續保存密鑰的 IBM Cloud Secrets Manager 實例的密鑰群組 ID。

--sm-instance

IBM Cloud Secrets Manager 實例的 CRN。

--subnet-id

要指派給叢集的 VPC 子網路。 若要列出可用的子網，請執行 ibmcloud ks subnets --provider vpc-classic --vpc-id <vpc-id> --zone <vpc-zone>。

--version

請指定 Kubernetes 或 OpenShift 版本，其中至少包括 major.minor 版本。 如果您不包括此旗標，則會使用預設版本。 若要查看可用的版本，請執行 ibmcloud ks versions。

--vpc-id

要在其中建立工作程式節點的 VPC ID。 若要列出可用的 ID，請執行 ibmcloud ks vpcs。

--workers

預設工作程式儲存區中每個區域的工作程式節點數。 對於 OpenShift 叢集，您必須將此值設定為至少 2。 對於 Kubernetes 叢集，此值為可選項。

--zone

指定多區域叢集中之工作程式儲存區的區域。 要列出可用的區域，請執行 ibmcloud ks zone ls。

範例

在 Virtual Private Cloud (VPC) Gen 1 基礎架構上建立包含工作節點的叢集

ibmcloud ks cluster create vpc-classic \
  --flavor FLAVOR \
  --name NAME \
  --subnet-id ID \
  --vpc-id ID \
  --zone ZONE

指令選項

--cluster-security-group

選用。 指定一或多個安全群組 ID，以套用至叢集上的所有工作者。 對於 OpenShift 版本 4.15 以及 Kubernetes 版本 1.30 及後續版本，這些安全群組將在 IBM 所管理的 kube-clusterID 安全群組之外額外套用。 對於較早版本的叢集，請指定 --cluster-security-group cluster 選項，以套用 kube-clusterID 安全群組。 若未指定任何值，系統將套用包含「kube-clusterID」在內的一組預設安全群組。

--cni

設定叢集的網路外掛程式。 Calico 預設為此值。 允許的值：Calico，OVNKubernetes

--cos-instance

僅對於 OpenShift Cluster 而言是必要的。 要將內部登錄備份在 OpenShift Cluster 中的標準 Cloud Object Storage 實例的 CRN。 若要列出您的雲端物件儲存執行個體的 CRN，請執行 ibmcloud resource service-instances --long --service-name cloud-object-storage。

--crk

要用於本端磁碟加密的 KMS 實例的根金鑰 ID。 若要列出可用的根金鑰，請執行 ibmcloud ks kms crk ls --instance-id <kms_instance>。

--disable-outbound-traffic-protection

若要允許叢集工作節點進行對外公開存取，請啟用此選項。 預設情況下，OpenShift 版本 4.15 及後續版本，以及 Kubernetes 版本 1.30 及後續版本，均會封鎖對外公開存取。

--disable-public-service-endpoint

停用公用服務端點以阻止對主控節點的公開存取。

--entitlement

僅當您將此叢集與具備「OpenShift」授權的許可證（例如「Cloud Pak」）一同使用時，才應將此標誌設定為「ocp_entitled」。

--flavor

工作程式節點的特性。 若要查看可用的版本，請執行 ibmcloud ks flavor ls --zone <zone name> （適用於 public. IBM Cloud 帳戶）或 ibmcloud ks flavor ls （適用於 IBM Cloud Dedicated 帳戶）。

--kms-account-id

包含您要用於本端磁碟或密鑰加密之 KMS 實例的帳戶 ID。

--kms-instance

要用於本端磁碟加密的 KMS 實例的 ID。 若要列出可用的 KMS 執行個體，請執行 ibmcloud ks kms instance ls。

--name

輸入叢集的名稱。

--offering

請指定叢集方案。 有效值：kubernetes、openshift、openshift-vs

--operating-system

指定作業系統的名稱。

--pod-subnet

指定自訂子網路 CIDR 為 POD 提供專用 IP 位址。 子網必須至少為 /23 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-vpc

-q

不要顯示日或更新提示的訊息。

--secondary-storage

特性的次要儲存體選項。 若要查看某種規格可用的次級儲存選項，請執行 ibmcloud ks flavor get --provider vpc-gen2 --zone <zone name>。

--service-subnet

指定自訂子網路 CIDR 為服務提供專用 IP 位址。 子網必須至少為 /24 或更大。 如需更多資訊，請參閱 https://ibm.biz/cluster-create-vpc。 預設值： 172.21.0.0/16

--sm-group

在其中持續保存密鑰的 IBM Cloud Secrets Manager 實例的密鑰群組 ID。

--sm-instance

IBM Cloud Secrets Manager 實例的 CRN。

--subnet-id

要指派給叢集的 VPC 子網路。 若要列出可用的子網，請執行 ibmcloud ks subnets --provider vpc-gen2 --vpc-id <vpc-id> --zone <vpc-zone>。

--version

請指定 Kubernetes 或 OpenShift 版本，其中至少包括 major.minor 版本。 如果您不包括此旗標，則會使用預設版本。 若要查看可用的版本，請執行 ibmcloud ks versions。

--vpc-id

要在其中建立工作程式節點的 VPC ID。 若要列出可用的 ID，請執行 ibmcloud ks vpcs。

--workers

預設工作程式儲存區中每個區域的工作程式節點數。 對於 OpenShift 叢集，您必須將此值設定為至少 2。 對於 Kubernetes 叢集，此值為可選項。

--zone

指定多區域叢集中之工作程式儲存區的區域。 要列出可用的區域，請執行 ibmcloud ks zone ls。

範例

在 Virtual Private Cloud (VPC) Gen 2 基礎架構上建立包含工作節點的叢集

ibmcloud ks cluster create vpc-gen2 \
  --flavor FLAVOR \
  --name NAME \
  --subnet-id ID \
  --vpc-id ID \
  --zone ZONE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--show-resources

顯示其他叢集資源，例如附加元件、VLAN 及子網。

範例

檢視叢集的詳細資訊

ibmcloud ks cluster get --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

在您的叢集中停用影像安全性強制執行

ibmcloud ks cluster image-security disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

在您的叢集中啟用影像安全性強制執行

ibmcloud ks cluster image-security enable --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster image-security help

指令選項

-l, --location

要過濾的位置。 若要列出可用的位置，請執行 ibmcloud ks locations。

--output

以提供的格式列印指令輸出。 若未包含提供者標誌，則僅會回傳傳統叢集。 允許的值：json

--provider

過濾清單以取得特定的基礎架構提供者。 有效值：classic、vpc-classic、vpc-gen2、satellite

-q

不要顯示日或更新提示的訊息。

範例

列出您在 IBM Cloud 帳戶中的所有叢集

ibmcloud ks cluster ls

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集的「Kubernetes」API 伺服器的稽核 Webhook 設定

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

範例

顯示說明

ibmcloud ks cluster master audit-webhook help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--ca-cert

用來驗證遠端記載服務之 CA 憑證的檔案路徑。

--client-cert

用戶端憑證的檔案路徑，此憑證用來接受遠端記載服務的鑑別。

--client-key

用來連接至遠端記載服務之對應用戶端金鑰的檔案路徑。

--policy

指定審核原則類型。 允許的值：default，verbose

-q

不要顯示日或更新提示的訊息。

--remote-server

遠端記載服務的 URL 或 IP 位址。

範例

為叢集的 Kubernetes API伺服器設定稽核 webhook 設定

ibmcloud ks cluster master audit-webhook set --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

移除叢集內 Kubernetes API 伺服器的稽核 Webhook 設定

ibmcloud ks cluster master audit-webhook unset --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

取得 OpenShift 網頁控制台及 OAuth 伺服器存取類型

ibmcloud ks cluster master console-oauth-access get --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster master console-oauth-access help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--type

請指定「OpenShift」網頁控制台及「OAuth」伺服器的存取類型。 允許的值：vpe-gateway，legacy

範例

設定 OpenShift 網頁控制台與 OAuth 伺服器的存取類型

ibmcloud ks cluster master console-oauth-access set --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster master help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集的 Kubernetes API 伺服器的 PodSecurity 存取設定

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

範例

顯示說明

ibmcloud ks cluster master pod-security help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

為叢集的 Kubernetes API 伺服器停用「PodSecurityPolicy」功能

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

為叢集的 Kubernetes API 伺服器啟用 PodSecurityPolicy

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集的 Kubernetes API 伺服器的 PodSecurityPolicy 設定

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

範例

顯示說明

ibmcloud ks cluster master pod-security policy help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--config-file

自訂 PodSecurity 配置的檔案路徑。 如果未指定，則會套用 Kubernetes 預設值。 如需相關資訊，請參閱 https://ibm.biz/BdPtUB

-q

不要顯示日或更新提示的訊息。

範例

為叢集的 Kubernetes API 伺服器設定並啟用「PodSecurity」存取控制配置

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

移除叢集中 Kubernetes API 伺服器的 PodSecurity 存取設定

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--subnet

指定子網路 CIDR。

範例

將子網新增至叢集的私有服務端點白名單中

ibmcloud ks cluster master private-service-endpoint allowlist add --cluster CLUSTER --subnet SUBNET

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用白名單

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

啟用白名單

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

取得叢集的私有服務端點白名單

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

範例

顯示說明

ibmcloud ks cluster master private-service-endpoint allowlist help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--subnet

指定子網路 CIDR。

範例

從叢集的私有服務端點允許清單中移除子網

ibmcloud ks cluster master private-service-endpoint allowlist rm --cluster CLUSTER --subnet SUBNET

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

-y

如果此特性需要進一步動作（例如，重新載入工作者或重新整理叢集主控節點），請在沒有使用者提示的情況下執行這些動作。

範例

啟用私有服務端點，使主節點可透過私有方式存取

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

範例

顯示說明

ibmcloud ks cluster master private-service-endpoint help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

-y

如果此特性需要進一步動作（例如，重新載入工作者或重新整理叢集主控節點），請在沒有使用者提示的情況下執行這些動作。

範例

停用公共服務端點，使主伺服器僅能透過私有方式存取

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

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

-y

如果此特性需要進一步動作（例如，重新載入工作者或重新整理叢集主控節點），請在沒有使用者提示的情況下執行這些動作。

範例

啟用公共服務端點，使主伺服器對外公開

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

範例

顯示說明

ibmcloud ks cluster master public-service-endpoint help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

重新啟動叢集主節點，以套用新的 Kubernetes API 配置變更

ibmcloud ks cluster master refresh --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--subnet

指定子網路 CIDR。

範例

將子網添加至 Satellite 叢集的服務端點允許清單中

ibmcloud ks cluster master satellite-service-endpoint allowlist add \
  --cluster CLUSTER \
  --subnet SUBNET

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

停用 Satellite 叢集的白名單

ibmcloud ks cluster master satellite-service-endpoint allowlist disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

為 Satellite 叢集啟用白名單

ibmcloud ks cluster master satellite-service-endpoint allowlist enable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

取得 Satellite 叢集的服務端點白名單

ibmcloud ks cluster master satellite-service-endpoint allowlist get --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster master satellite-service-endpoint allowlist help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--subnet

指定子網路 CIDR。

範例

從 Satellite 叢集的服務端點白名單中移除子網

ibmcloud ks cluster master satellite-service-endpoint allowlist rm --cluster CLUSTER --subnet SUBNET

範例

顯示說明

ibmcloud ks cluster master satellite-service-endpoint help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

--force-update

即使該項變更大於工作者節點現行版本的兩個次要版本，也要嘗試更新。

-q

不要顯示日或更新提示的訊息。

--version

請指定 Kubernetes 或 OpenShift 版本，其中至少包括 major.minor 版本。 如果您不包括此旗標，則會使用預設版本。 若要查看可用的版本，請執行 ibmcloud ks versions。

範例

將叢集主節點更新至最新版本或指定的 Kubernetes 版本

ibmcloud ks cluster master update --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

產生並套用一個新的映像檔拉取密鑰，該密鑰用於儲存 IAM 憑證，供叢集存取映像檔 IBM Cloud Container Registry

ibmcloud ks cluster pull-secret apply --cluster CLUSTER

範例

顯示說明

ibmcloud ks cluster pull-secret help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--delete-openshift-registry-cos-bucket

刪除 ROKS 叢集中存放 OpenShift 登錄檔備份的 COS 儲存桶及其相關服務金鑰

--delete-storage

強制移除叢集的持久性儲存空間。 無法回復已刪除的資料。

-f

強制執行指令，而不出現使用者提示。 除非同時指定了 delete-storage 選項，否則該叢集的持久儲存空間不會被刪除。 除非同時指定了 delete-openshift-registry-cos-bucket 選項，否則 COS 儲存桶及其相關的服務金鑰將不會被刪除。

-q

不要顯示日或更新提示的訊息。

--skip-advance-permissions-check

完成此動作之前，請跳過檢查基礎架構權限。 請注意，如果您沒有適當的基礎架構權限，則此動作可能僅局部成功。

範例

刪除叢集

ibmcloud ks cluster rm --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--key

指定現有服務金鑰的名稱或 GUID。 若您定義了服務金鑰，則無法同時設定「--role」選項。

-n, --namespace

請指定 Kubernetes 名稱空間。

-q

不要顯示日或更新提示的訊息。

--role

為服務金鑰指定 IAM 角色。 如果您指定現有金鑰用於未啟用 IAM 的服務（如 Cloud Foundry 服務），此旗標無法運作。

--service

指定服務實例的名稱。 若要查看可用服務執行個體的清單，請針對 Cloud Foundry 服務執行 ibmcloud service list ，或針對已啟用 IAM 的服務執行 ibmcloud resource service-instances 。

範例

透過將服務實例綁定至 Kubernetes 命名空間，將 IBM Cloud 服務新增至叢集

ibmcloud ks cluster service bind --cluster CLUSTER --namespace NAMESPACE --service SERVICE --key KEY

範例

顯示說明

ibmcloud ks cluster service help

指令選項

--all-namespaces

包含所有 Kubernetes 名稱空間。

-c, --cluster

請指定叢集名稱或 ID。

-n, --namespace

Kubernetes 名稱空間。 若未指定，則會使用 default 命名空間。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出綁定至 Kubernetes 命名空間的服務

ibmcloud ks cluster service ls --cluster CLUSTER --all-namespaces

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-n, --namespace

請指定 Kubernetes 名稱空間。

-q

不要顯示日或更新提示的訊息。

--service

指定服務實例的名稱。 若要查看可用服務執行個體的清單，請針對 Cloud Foundry 服務執行 ibmcloud service list ，或針對已啟用 IAM 的服務執行 ibmcloud resource service-instances 。

範例

透過將 IBM Cloud 服務從 Kubernetes 命名空間中解除綁定，將該服務從叢集中移除

ibmcloud ks cluster service unbind --cluster CLUSTER --namespace NAMESPACE --service SERVICE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--subnet-id

指定子網路 ID。

範例

將您在 IBM Cloud 基礎架構帳戶中的現有公開或私有可攜式子網，提供給經典叢集使用

ibmcloud ks cluster subnet add --cluster CLUSTER --subnet-id ID

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--size

指定可攜式子網路的大小。 大小必須為 8、16、32 或 64 其中之一。

--vlan

指定公用或專用 VLAN ID。

範例

在您的公有或私有 VLAN 上建立一個可攜式子網，並使其可供經典叢集使用

ibmcloud ks cluster subnet create --cluster CLUSTER --size SIZE --vlan VLAN

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--subnet-id

指定子網路 ID。

範例

將現有的公共或私有可攜式子網從經典叢集中分離

ibmcloud ks cluster subnet detach --cluster CLUSTER --subnet-id ID

範例

顯示說明

ibmcloud ks cluster subnet help

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--region

請指定要設為目標的地區。

範例

若您已設定 IBM Cloud 帳戶，使用不同的憑證存取 IBM Cloud 經典基礎架構組合，請取得該基礎架構的使用者名稱

ibmcloud ks credential get --region REGION

範例

顯示說明

ibmcloud ks credential help

指令選項

--infrastructure-api-key

IBM Cloud 標準基礎架構帳戶的 API 金鑰。

--infrastructure-username

IBM Cloud 標準基礎架構帳戶的使用者名稱。

-q

不要顯示日或更新提示的訊息。

--region

請指定要設為目標的地區。

範例

設定憑證，以便您能透過 IBM Cloud 帳戶存取 IBM Cloud 的傳統基礎架構組合

ibmcloud ks credential set classic \
  --infrastructure-api-key KEY \
  --infrastructure-username USERNAME \
  --region REGION

範例

顯示說明

ibmcloud ks credential set help

指令選項

-q

不要顯示日或更新提示的訊息。

--region

請指定要設為目標的地區。

範例

移除可讓您透過 IBM Cloud 帳戶存取 IBM Cloud 經典基礎架構組合的憑證

ibmcloud ks credential unset --region REGION

範例

顯示說明

ibmcloud ks experimental help

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--region

資源群所在的區域。

--resource-group

要擷取其預設受信任設定檔的資源群組。

範例

[Expires on 2026-10-21] 取得在資源群組中建立的叢集所對應的預設受信任設定檔

ibmcloud ks experimental trusted-profile default get --region REGION --resource-group GROUP

範例

顯示說明

ibmcloud ks experimental trusted-profile default help

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--region

資源群所在的區域。

--resource-group

用於設定受信任設定檔的資源群組 ID。

--trusted-profile

受信任的設定檔 ID。

範例

[Expires on 2026-10-21] 為在資源群組中建立的叢集設定預設的可信憑證設定檔

ibmcloud ks experimental trusted-profile default set \
  --region REGION \
  --resource-group GROUP \
  --trusted-profile PROFILE

指令選項

--cluster

用於檢索其受信任設定檔的叢集 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

[Expires on 2026-10-21] 取得叢集的可信資料檔

ibmcloud ks experimental trusted-profile get --cluster CLUSTER

範例

顯示說明

ibmcloud ks experimental trusted-profile help

指令選項

--cluster

用於設定受信任設定檔的叢集 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--trusted-profile

受信任的設定檔 ID。

範例

[Expires on 2026-10-21] 在叢集中設定受信任的配置檔

ibmcloud ks experimental trusted-profile set --cluster CLUSTER --trusted-profile PROFILE

指令選項

--flavor

工作程式節點的特性。 若要查看可用的版本，請執行 ibmcloud ks flavor ls --zone <zone name> （適用於 public. IBM Cloud 帳戶）或 ibmcloud ks flavor ls （適用於 IBM Cloud Dedicated 帳戶）。

--output

以提供的格式列印指令輸出。 允許的值：json

--provider

請指定提供者。 可選的選項包括 classic、vpc-classic 以及 vpc-gen2。

-q

不要顯示日或更新提示的訊息。

--zone

指定要列出其可用特性的區域。 要列出可用的區域，請執行 ibmcloud ks zone ls。

範例

取得特定區域及服務供應商之風味相關資訊

ibmcloud ks flavor get --flavor FLAVOR --provider PROVIDER --zone ZONE

範例

顯示說明

ibmcloud ks flavor help

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

--provider

要取得其特性的提供者類型。 有效值：classic、vpc-classic、vpc-gen2、satellite

-q

不要顯示日或更新提示的訊息。

--show-os

請列出支援的作業系統。

--show-storage

顯示其他儲存體硬碟。

--zone

指定要列出其可用特性的區域。 要列出可用的區域，請執行 ibmcloud ks zone ls。

範例

列出某個區域的可用口味

ibmcloud ks flavor ls --zone ZONE

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--region

請指定要設為目標的地區。 若尚未指定目標區域，則必須指定此參數。 若要檢查某個區域是否為目標區域，請執行 ibmcloud target。

範例

請檢查，用於存取 IBM Cloud 經典基礎架構組合中目標資源群組的憑證，是否缺少建議或必需的基礎架構權限

ibmcloud ks infra-permissions get

範例

顯示說明

ibmcloud ks infra-permissions help

指令選項

--alb

ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

查看 Ingress ALB 的自動擴展狀態與設定

ibmcloud ks ingress alb autoscale get --alb ALB --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress alb autoscale help

指令選項

--alb

ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。

-c, --cluster

請指定叢集名稱或 ID。

--cpu-average-utilization

平均 CPU 使用率臨界值。 用來動態計算抄本數目。

--custom-metrics-file

自訂度量值檔案的路徑。 如需詳細資料，請參閱 https://ibm.biz/iks-ingress-custom-metrics。

--max-replicas

給定 ALB 的抄本數上限。 請確保有足夠的工人。

--min-replicas

給定 ALB 的抄本數下限。 必須大於或等於 1。 （基於高可用性目的，建議下限為 2。）

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

為 Ingress ALB 設定自動擴展

ibmcloud ks ingress alb autoscale set \
  --alb ALB \
  --cluster CLUSTER \
  --max-replicas REPLICAS \
  --min-replicas REPLICAS \
  --cpu-average-utilization PERCENT

指令選項

--alb

ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

刪除 Ingress ALB 的自動擴展設定

ibmcloud ks ingress alb autoscale unset --alb ALB --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

停用叢集中所有 Ingress ALB Pod 的自動更新

ibmcloud ks ingress alb autoupdate disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

啟用叢集中所有 Ingress ALB Pod 的自動更新

ibmcloud ks ingress alb autoupdate enable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

查看叢集中的 Ingress ALB Pod 是否設定為自動更新，以及 ALB Pod 是否為最新版本

ibmcloud ks ingress alb autoupdate get --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress alb autoupdate help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--ip

請指定一個可攜式公網或私網 IP 位址，該位址須可在 vlan 以及即將建立或啟用的 ALB 的 zone 中使用。

-q

不要顯示日或更新提示的訊息。

--type

指定 ALB 的類型。 可選選項：公開、私有

--version

指定 ALB 映像檔版本。 若要查看受支援的影像版本，請執行 ibmcloud ks ingress alb versions。

--vlan

VLAN ID。 此 VLAN 必須與 ALB 的「type」相符，並且必須位於與您要建立的 ALB 相同的「zone」中。

--zone

指定多區域叢集中之工作程式儲存區的區域。 要列出可用的區域，請執行 ibmcloud ks zone ls。

範例

在經典叢集中建立並啟用 Ingress ALB

ibmcloud ks ingress alb create classic --cluster CLUSTER --type TYPE --vlan VLAN --zone ZONE

範例

顯示說明

ibmcloud ks ingress alb create help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--type

指定 ALB 的類型。 可選選項：公開、私有

--version

指定 ALB 映像檔版本。 若要查看受支援的影像版本，請執行 ibmcloud ks ingress alb versions。

--zone

指定多區域叢集中之工作程式儲存區的區域。 要列出可用的區域，請執行 ibmcloud ks zone ls。

範例

在 VPC Gen 2 叢集中建立並啟用 Ingress ALB

ibmcloud ks ingress alb create vpc-gen2 --cluster CLUSTER --type TYPE --zone ZONE

指令選項

--alb

ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

停用叢集中的 Ingress ALB

ibmcloud ks ingress alb disable --alb ALB --cluster CLUSTER

指令選項

--alb

ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。

-c, --cluster

請指定叢集名稱或 ID。

--ip

請指定一個可攜式公網或私網 IP 位址，該位址須可在 vlan 以及即將建立或啟用的 ALB 的 zone 中使用。

-q

不要顯示日或更新提示的訊息。

--version

指定 ALB 映像檔版本。 若要查看受支援的影像版本，請執行 ibmcloud ks ingress alb versions。

範例

在經典叢集中啟用 Ingress ALB

ibmcloud ks ingress alb enable classic --alb ALB --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress alb enable help

指令選項

--alb

ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--version

指定 ALB 映像檔版本。 若要查看受支援的影像版本，請執行 ibmcloud ks ingress alb versions。

範例

在 VPC Gen 2 叢集中啟用 Ingress ALB

ibmcloud ks ingress alb enable vpc-gen2 --alb ALB --cluster CLUSTER

指令選項

--alb

ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集內 Ingress ALB 的詳細資訊

ibmcloud ks ingress alb get --alb ALB --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

停用 Ingress 狀態檢查器

ibmcloud ks ingress alb health-checker disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

啟用 Ingress 狀態檢查器

ibmcloud ks ingress alb health-checker enable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視 Ingress 狀態檢查器的狀態

ibmcloud ks ingress alb health-checker get --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress alb health-checker help

範例

顯示說明

ibmcloud ks ingress alb help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出叢集中的所有 Ingress ALB ID，並標示各 ALB Pod 是否為最新版本

ibmcloud ks ingress alb ls --cluster CLUSTER

指令選項

--alb

若要更新特定的 ALB，請指定 ALB ID。 若要查看可用的 ALB ID，請執行 ibmcloud ks ingress alb ls。 若要更新多個 ALB，請在每個標誌中指定一個 ALB ID，例如 --alb ID_1 --alb ID_2。 若要更新所有 ALB，請勿包含此旗標。

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--version

指定 ALB 映像檔版本。 若要查看受支援的影像版本，請執行 ibmcloud ks ingress alb versions。

範例

強制對叢集中的個別或所有 ALB 執行 Pod 的一次性更新

ibmcloud ks ingress alb update --cluster CLUSTER

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--region

請指定要設為目標的地區。

範例

列出可用的 Ingress ALB 映像版本

ibmcloud ks ingress alb versions

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--crn

IBM CIS 實例的 CRN。

--domain

Ingress 網域。 若要查看現有的網域，請執行 ibmcloud ks ingress domain ls。

--domain-provider

DNS 服務供應商。 預設的 DNS 服務提供者是我們的內部服務。 有關受支援的供應商，請參閱我們的文件：https://ibm.biz/containers-ingress-domains

--domain-zone

CIS 的 ZoneID。

--hostname

適用於 VPC 叢集。 要為網域登錄的主機名稱。

--ip

要為網域登錄的 IP 位址。

--is-default

包含此選項以將相關網域設為叢集的預設網域。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--secret-namespace

在其中建立 TLS 密碼的名稱空間。

範例

為叢集建立一個 Ingress 網域

ibmcloud ks ingress domain create --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress domain default help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--domain

Ingress 網域。 若要查看現有的網域，請執行 ibmcloud ks ingress domain ls。

-q

不要顯示日或更新提示的訊息。

範例

變更叢集的預設 Ingress 網域

ibmcloud ks ingress domain default replace --cluster CLUSTER --domain DOMAIN

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--domain

Ingress 網域。 若要查看現有的網域，請執行 ibmcloud ks ingress domain ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視 Ingress 領域的詳細資訊

ibmcloud ks ingress domain get --cluster CLUSTER --domain DOMAIN

範例

顯示說明

ibmcloud ks ingress domain help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出某個叢集的所有 Ingress 域

ibmcloud ks ingress domain ls --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--domain

Ingress 網域。 若要查看現有的網域，請執行 ibmcloud ks ingress domain ls。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

從叢集中移除一個 Ingress 網域

ibmcloud ks ingress domain rm --cluster CLUSTER --domain DOMAIN

範例

顯示說明

ibmcloud ks ingress domain secret help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--domain

Ingress 網域。 若要查看現有的網域，請執行 ibmcloud ks ingress domain ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

重新產生 Ingress 網域的憑證

ibmcloud ks ingress domain secret regenerate --cluster CLUSTER --domain DOMAIN

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--domain

Ingress 網域。 若要查看現有的網域，請執行 ibmcloud ks ingress domain ls。

-f

強制執行指令，而不出現使用者提示。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

刪除 Ingress 網域的機密，並阻止該憑證日後續期

ibmcloud ks ingress domain secret rm --cluster CLUSTER --domain DOMAIN

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--domain

Ingress 網域。 若要查看現有的網域，請執行 ibmcloud ks ingress domain ls。

--hostname

適用於 VPC 叢集。 要為網域登錄的主機名稱。

--ip

要為網域登錄的 IP 位址。

-q

不要顯示日或更新提示的訊息。

範例

更新叢集的 Ingress 域

ibmcloud ks ingress domain update --cluster CLUSTER --domain DOMAIN

範例

顯示說明

ibmcloud ks ingress help

範例

顯示說明

ibmcloud ks ingress instance default help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--name

已登錄 IBM Cloud Secret Manager 實例的名稱。

-q

不要顯示日或更新提示的訊息。

--secret-group

持續保存密鑰之 IBM Cloud Secret Manager 實例的密鑰群組 ID。

範例

將一個已註冊的 IBM Cloud Secrets Manager 實例設定為預設值

ibmcloud ks ingress instance default set --cluster CLUSTER --name NAME

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--name

已登錄 IBM Cloud Secret Manager 實例的名稱。

-q

不要顯示日或更新提示的訊息。

範例

將已註冊的 IBM Cloud Secrets Manager 實例從預設值中移除

ibmcloud ks ingress instance default unset --cluster CLUSTER --name NAME

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--name

已登錄 IBM Cloud Secret Manager 實例的名稱。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視已註冊至叢集的 IBM Cloud Secrets Manager 實例的詳細資訊

ibmcloud ks ingress instance get --cluster CLUSTER --name NAME

範例

顯示說明

ibmcloud ks ingress instance help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--show-deleted

顯示已從叢集取消登錄的 IBM Cloud Secret Manager 實例。

範例

列出已註冊至某個叢集的 IBM Cloud Secrets Manager 實例

ibmcloud ks ingress instance ls --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--crn

IBM Cloud Secret Manager 實例的 CRN。

--is-default

將 IBM Cloud Secrets Manager 實例設為預設值。 如果現有的預設實例存在，則會取消設定。

-q

不要顯示日或更新提示的訊息。

--secret-group

持續保存密鑰之 IBM Cloud Secret Manager 實例的密鑰群組 ID。

範例

將 IBM Cloud Secrets Manager 實例註冊至叢集

ibmcloud ks ingress instance register --cluster CLUSTER --crn CRN

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--name

已登錄 IBM Cloud Secret Manager 實例的名稱。

-q

不要顯示日或更新提示的訊息。

範例

從叢集中解除註冊一個 IBM Cloud Secrets Manager 實例

ibmcloud ks ingress instance unregister --cluster CLUSTER --name NAME

範例

顯示說明

ibmcloud ks ingress load-balancer backend help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--private-backend

專用負載平衡器的後端

--public-backend

公共負載平衡器的後端

-q

不要顯示日或更新提示的訊息。

範例

為暴露叢集 Ingress 控制器之 VPC ALB 負載平衡器設定私有和／或公共後端

ibmcloud ks ingress load-balancer backend set --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

取得您叢集中公開 Ingress ALB 的負載平衡器的配置

ibmcloud ks ingress load-balancer get --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress load-balancer help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

在 Ingress ALB 上停用 PROXY 協定

ibmcloud ks ingress load-balancer proxy-protocol disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--cidr

負載平衡器的 IP 位址範圍（CIDR 格式）。 透過其他 IP 範圍內的負載平衡器轉遞的 PROXY 標頭不會加以處理。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

啟用 PROXY 協定，以便將客戶端連線資訊透過請求標頭傳遞給 ALB

ibmcloud ks ingress load-balancer proxy-protocol enable --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress load-balancer proxy-protocol help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--cert-crn

憑證 CRN。

--field

要併入作為欄位的密鑰 CRN。 若要匯入該秘密而不指定名稱，請使用 --field 。 若要指定欄位名稱，請使用 ` `--field name=<crn>。 若要將「IBM Cloud Secrets Manager」密鑰用作前綴，請使用 --field prefix=<crn>。

-n, --namespace

請指定 Kubernetes 名稱空間。

--name

在叢集中建立的 Ingress 密碼名稱。

--persist

在叢集中持續保存密碼，以便無法刪除密碼。

-q

不要顯示日或更新提示的訊息。

--type

Ingress 密錀類型。 可以是 TLS 或 Opaque。 如果未指定任何選項，依預設會套用 TLS。

範例

在叢集中建立一個 Ingress 機密，用以對應儲存於 IBM Cloud 機密管理員 中的機密

ibmcloud ks ingress secret create --cluster CLUSTER --name NAME

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--field

要併入作為欄位的密鑰 CRN。 若要匯入該秘密而不指定名稱，請使用 --field 。 若要指定欄位名稱，請使用 ` `--field name=<crn>。 若要將「IBM Cloud Secrets Manager」密鑰用作前綴，請使用 --field prefix=<crn>。

-n, --namespace

請指定 Kubernetes 名稱空間。

--name

在叢集中建立的 Ingress 密碼名稱。

-q

不要顯示日或更新提示的訊息。

範例

在現有的 Ingress 機密中新增欄位

ibmcloud ks ingress secret field add --cluster CLUSTER --name NAME --namespace NAMESPACE

範例

顯示說明

ibmcloud ks ingress secret field help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-n, --namespace

請指定 Kubernetes 名稱空間。

--name

在叢集中建立的 Ingress 密碼名稱。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--show-crn

顯示密鑰的 CRN 值。

範例

檢視 Ingress 機密項目的欄位

ibmcloud ks ingress secret field ls --cluster CLUSTER --name NAME --namespace NAMESPACE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--field-name

要從密鑰中移除的欄位名稱。

-n, --namespace

請指定 Kubernetes 名稱空間。

--name

在叢集中建立的 Ingress 密碼名稱。

-q

不要顯示日或更新提示的訊息。

範例

從現有的 Ingress 機密中移除欄位

ibmcloud ks ingress secret field rm --cluster CLUSTER --name NAME --namespace NAMESPACE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-n, --namespace

請指定 Kubernetes 名稱空間。

--name

在叢集中建立的 Ingress 密碼名稱。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視 Ingress 機密的詳細資訊

ibmcloud ks ingress secret get --cluster CLUSTER --name NAME --namespace NAMESPACE

範例

顯示說明

ibmcloud ks ingress secret help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--show-crn

顯示密鑰的 CRN 值。

--show-deleted

顯示已從叢集中刪除的密鑰。

範例

列出叢集中的所有 Ingress 祕密

ibmcloud ks ingress secret ls --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-n, --namespace

請指定 Kubernetes 名稱空間。

--name

在叢集中建立的 Ingress 密碼名稱。

-q

不要顯示日或更新提示的訊息。

範例

從叢集中移除 Ingress 機密

ibmcloud ks ingress secret rm --cluster CLUSTER --name NAME --namespace NAMESPACE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--cert-crn

憑證 CRN。

-n, --namespace

請指定 Kubernetes 名稱空間。

--name

在叢集中建立的 Ingress 密碼名稱。

-q

不要顯示日或更新提示的訊息。

範例

更新現有的 Ingress 機密

ibmcloud ks ingress secret update --cluster CLUSTER --name NAME --namespace NAMESPACE

範例

顯示說明

ibmcloud ks ingress security help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

在您的叢集中停用 80 號埠

ibmcloud ks ingress security port80 disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

範例

在您的叢集中啟用 80 號埠的使用

ibmcloud ks ingress security port80 enable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

取得叢集中第 80 埠的安全設定

ibmcloud ks ingress security port80 get --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress security port80 help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

停用叢集中 Ingress 元件的狀態回報功能

ibmcloud ks ingress status-report disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

為叢集中的 Ingress 元件啟用狀態回報功能

ibmcloud ks ingress status-report enable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

取得叢集中 Ingress 元件的狀態報告

ibmcloud ks ingress status-report get --cluster CLUSTER

範例

顯示說明

ibmcloud ks ingress status-report help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--code

要忽略的警告代碼。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

抑制叢集的 Ingress 狀態報告中的警告

ibmcloud ks ingress status-report ignored-errors add --cluster CLUSTER --code CODE

範例

顯示說明

ibmcloud ks ingress status-report ignored-errors help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出當前被叢集的 Ingress 狀態所忽略的警告

ibmcloud ks ingress status-report ignored-errors ls --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--code

要移除之警告的代碼。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

移除目前被叢集的 Ingress 狀態所忽略的警告

ibmcloud ks ingress status-report ignored-errors rm --cluster CLUSTER --code CODE

範例

顯示說明

ibmcloud ks kms crk help

指令選項

--instance-id

KMS 實例 ID。 若要查看可用的 KMS 實例，請執行 ibmcloud ks kms instance ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出 Key Management Service 實例的可用根金鑰

ibmcloud ks kms crk ls --instance-id ID

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--crk

KMS 實例中的根金鑰 ID。 若要列出可用的根金鑰，請執行 ibmcloud ks kms crk ls --instance-id <kms_instance>。

--instance-id

KMS 實例 ID。 若要查看可用的 KMS 實例，請執行 ibmcloud ks kms instance ls。

--kms-account-id

包含您要用於本端磁碟或密鑰加密之 KMS 實例的帳戶 ID。

--public-endpoint

指定此選項以使用 KMS 公用服務端點。 否則，將使用 KMS 專用服務端點。

-q

不要顯示日或更新提示的訊息。

範例

在您的叢集中啟用金鑰管理服務 (KMS)，以加密您的機密資訊

ibmcloud ks kms enable --cluster CLUSTER --crk CRK --instance-id ID

範例

顯示說明

ibmcloud ks kms help

範例

顯示說明

ibmcloud ks kms instance help

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出可用的金鑰管理服務實例

ibmcloud ks kms instance ls

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

--provider

過濾清單以取得特定的基礎架構提供者。 有效值：classic、vpc-classic、vpc-gen2、satellite

-q

不要顯示日或更新提示的訊息。

--show-flavors

顯示 VPC 區域中可用的工作者節點特性。

範例

列出支援的 IBM Cloud Kubernetes Service 地點

ibmcloud ks locations

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

停用叢集中所有 Fluentd Pod 的自動更新

ibmcloud ks logging autoupdate disable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

範例

啟用叢集中所有 Fluentd Pod 的自動更新

ibmcloud ks logging autoupdate enable --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

查看您的 Fluentd Pod 是否已設定為在叢集中自動更新

ibmcloud ks logging autoupdate get --cluster CLUSTER

範例

顯示說明

ibmcloud ks logging autoupdate help

指令選項

-C, --app-container

指定您要收集其日誌的儲存器。 若要指定多個路徑，請使用多個參數，例如 -C container1 -C container2。 此選項是 application 記錄來源的必填項目。 如果未提供，則會從傳入的應用程式日誌路徑中收集所有儲存器的日誌。

-c, --cluster

請指定叢集名稱或 ID。

--ca-cert

當記錄類型為「syslog」，且通訊協定為 TLS 時，Kubernetes 中的機密名稱即為包含憑證授權單位憑證的機密名稱。

--force-update

將叢集中的 Fluentd POD 強制更新為最新版本。

--hostname

當日誌類型為 syslog 時，此處為日誌收集器的主機名稱或 IP 位址。 當記錄類型為「ibm」（已廢棄）時，此為記錄匯入端點。 如果您沒有提供記載汲取端點，則會使用現行區域的端點。

--logsource

要轉遞的日誌來源。 支援的值包括：container、application、ingress、worker、storage 以及 kubernetes。 這個引數支援以逗點區隔的日誌來源清單。 若未指定日誌來源，系統將轉發 container 及 ingress 的日誌。

-n, --namespace

您要套用日誌轉遞配置的名稱空間。 僅在搭配「container」日誌來源使用時，或未指定日誌來源時，才應使用此標誌。 如果您沒有指定名稱空間，則所有名稱空間都會使用這項配置。

--org

Deprecated 要將日誌傳送至的組織名稱。 此標誌僅在記錄類型為 ibm 時才有效。 當您指定空間名稱時，需要指定組織名稱。 如果您沒有指定空間名稱，則會在帳戶層次轉遞日誌。

--output

以提供的格式列印指令輸出。 允許的值：json

-p, --app-path

指定要在儲存器內從中收集日誌的絕對檔案路徑。 若要指定多個路徑，請使用多個參數，例如 -p path1 -p path2。 在為日誌來源指定 application 時，此為必填參數。 系統接受 /var/log/*.log 這類通配符，但不接受 /var/log/**/test.log 這類遞迴通配符。

--port

日誌收集器的埠。 若未指定埠號，則 ibm （已廢棄）會使用資料匯入端點的預設埠號，而 syslog 則會使用 514。

-q

不要顯示日或更新提示的訊息。

--skip-validation

跳過組織和空間名稱（若有指定）的驗證。 如果值無效，這可能損壞記載配置，但將縮短處理時間。

--space

Deprecated 要傳送日誌至該空間的名稱。 此標誌僅在記錄類型為 ibm 時才有效。 當您指定組織名稱時，需要指定空間名稱。 如果您沒有指定空間名稱，則會在帳戶層次轉遞日誌。

--syslog-protocol

當記錄類型為「syslog」時，即為傳輸層協定。 支援的值包括 tls、tcp 以及預設值 udp。 當使用 UDP 通訊協定轉遞至 rsyslog 伺服器時，會截斷超過 1KB 的日誌。

--type

您要使用的日誌轉遞通訊協定。 唯一受支援的值是 syslog。

--verify-mode

當記錄類型為「syslog」且通訊協定為 TLS 時，驗證模式。 支援的值為 verify-peer，預設值為 verify-none。

範例

建立記錄設定

ibmcloud ks logging config create \
  --cluster CLUSTER \
  --logsource LOGSOURCE \
  --type TYPE \
  --ca-cert CERT \
  --syslog-protocol PROTOCOL \
  --verify-mode MODE \
  --namespace NAMESPACE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--logsource

您要過濾的日誌來源類型。 可接受的值為 container、application、ingress、worker、storage 以及 kubernetes。 若未傳入日誌來源，則會回傳該叢集的所有日誌設定。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集的日誌轉發設定

ibmcloud ks logging config get --cluster CLUSTER

範例

顯示說明

ibmcloud ks logging config help

指令選項

--all

移除所有日誌轉遞配置。

-c, --cluster

請指定叢集名稱或 ID。

--force-update

將叢集中的 Fluentd POD 強制更新為最新版本。

--id

指定記載配置的 ID。

-n, --namespace

要從中移除日誌轉遞配置的名稱空間。 如果同一個命名空間有多個設定檔，請改為使用 --id 標誌。

-q

不要顯示日或更新提示的訊息。

範例

從叢集中刪除日誌轉發設定

ibmcloud ks logging config rm --cluster CLUSTER --all

指令選項

-C, --app-container

指定您要收集其日誌的儲存器。 若要指定多個路徑，請使用多個參數，例如 -C container1 -C container2。 此選項是 application 記錄來源的必填項目。 如果未提供，則會從傳入的應用程式日誌路徑中收集所有儲存器的日誌。

-c, --cluster

請指定叢集名稱或 ID。

--ca-cert

當記錄類型為「syslog」，且通訊協定為 TLS 時，Kubernetes 中的機密名稱即為包含憑證授權單位憑證的機密名稱。

--force-update

將叢集中的 Fluentd POD 強制更新為最新版本。

--hostname

當日誌類型為 syslog 時，此處為日誌收集器的主機名稱或 IP 位址。 當記錄類型為「ibm」（已廢棄）時，此為記錄匯入端點。 如果您沒有提供記載汲取端點，則會使用現行區域的端點。

--id

指定記載配置的 ID。

--logsource

要轉遞的日誌來源。 支援的值包括：container、application、ingress、worker、storage 以及 kubernetes。 這個引數支援以逗點區隔的日誌來源清單。 若未指定日誌來源，系統將轉發 container 及 ingress 的日誌。

-n, --namespace

您要套用日誌轉遞配置的名稱空間。 僅在搭配「container」日誌來源使用時，或未指定日誌來源時，才應使用此標誌。 如果您沒有指定名稱空間，則所有名稱空間都會使用這項配置。

--org

Deprecated 要將日誌傳送至的組織名稱。 此標誌僅在記錄類型為 ibm 時才有效。 當您指定空間名稱時，需要指定組織名稱。 如果您沒有指定空間名稱，則會在帳戶層次轉遞日誌。

--output

以提供的格式列印指令輸出。 允許的值：json

-p, --app-path

指定要在儲存器內從中收集日誌的絕對檔案路徑。 若要指定多個路徑，請使用多個參數，例如 -p path1 -p path2。 在為日誌來源指定 application 時，此為必填參數。 系統接受 /var/log/*.log 這類通配符，但不接受 /var/log/**/test.log 這類遞迴通配符。

--port

日誌收集器的埠。 若未指定埠號，則 ibm （已廢棄）會使用資料匯入端點的預設埠號，而 syslog 則會使用 514。

-q

不要顯示日或更新提示的訊息。

--skip-validation

跳過組織和空間名稱（若有指定）的驗證。 如果值無效，這可能損壞記載配置，但將縮短處理時間。

--space

Deprecated 要傳送日誌至該空間的名稱。 此標誌僅在記錄類型為 ibm 時才有效。 當您指定組織名稱時，需要指定空間名稱。 如果您沒有指定空間名稱，則會在帳戶層次轉遞日誌。

--syslog-protocol

當記錄類型為「syslog」時，即為傳輸層協定。 支援的值包括 tls、tcp 以及預設值 udp。 當使用 UDP 通訊協定轉遞至 rsyslog 伺服器時，會截斷超過 1KB 的日誌。

--type

您要使用的日誌轉遞通訊協定。 唯一受支援的值是 syslog。

--verify-mode

當記錄類型為「syslog」且通訊協定為 TLS 時，驗證模式。 支援的值為 verify-peer，預設值為 verify-none。

範例

更新叢集的日誌轉發設定

ibmcloud ks logging config update \
  --cluster CLUSTER \
  --id ID \
  --logsource LOGSOURCE \
  --type TYPE \
  --ca-cert CERT \
  --syslog-protocol PROTOCOL \
  --verify-mode MODE \
  --namespace NAMESPACE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--container

您要從中過濾掉日誌的容器名稱。 只有在使用日誌類型儲存器才會套用此旗標。

--force-update

將叢集中的 Fluentd POD 強制更新為最新版本。

--lc, --logging-config

記載配置 ID。 若未提供，則該篩選器將套用至所有傳遞給該篩選器的叢集記錄設定。 您可以搭配使用 --show-matching-configs 旗標與指令來檢視符合過濾器的日誌配置。

--level

過濾掉指定層次以下的日誌。 可接受的值（按其標準順序）有 fatal、error、warn/warning、info、debug 和 trace。 舉例而言，如果您過濾 info 層次上的日誌，則也會過濾 debug 和 trace。 附註：只有在日誌訊息是 JSON 格式且包含 level 欄位時，才能使用此旗標。 輸出範例：{"log": "hello", "level": "info"}

--message

過濾掉日誌中任何位置包含指定訊息的任何日誌。 訊息會逐字比對，而不是以表示式的方式比對。 範例：訊息 "Hello"、"!" 及 "Hello, World!" 將套用至日誌 "Hello, World!"。

-n, --namespace

您要從中過濾日誌的 Kubernetes 名稱空間。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--regex-message

濾出任何在日誌中包含指定的訊息正規表示式型樣的日誌。 該訊息會與正規表示式比對。 範例：模式「hello [0-9]」將套用至「hello 1」、「hello 2」、「hello 9」

--type

您要將過濾器套用至其中的日誌類型。 目前支援所有的儲存器和主機。

範例

建立一個篩選器，以排除不需轉發的日誌行

ibmcloud ks logging filter create --cluster CLUSTER --message MESSAGE

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--id

指定記載過濾器的 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--show-covering-filters

顯示將先前過濾器呈現為已作廢的記載過濾器。

--show-matching-configs

顯示符合您正在檢視之配置的記載配置。

範例

檢視日誌篩選器設定

ibmcloud ks logging filter get --cluster CLUSTER

範例

顯示說明

ibmcloud ks logging filter help

指令選項

--all

刪除所有日誌轉發篩選器。

-c, --cluster

請指定叢集名稱或 ID。

--force-update

將叢集中的 Fluentd POD 強制更新為最新版本。

--id

指定記載過濾器的 ID。

-q

不要顯示日或更新提示的訊息。

範例

刪除記錄篩選器

ibmcloud ks logging filter rm --cluster CLUSTER --all

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--container

您要從中過濾掉日誌的容器名稱。 只有在使用日誌類型儲存器才會套用此旗標。

--force-update

將叢集中的 Fluentd POD 強制更新為最新版本。

--id

指定記載過濾器的 ID。

--lc, --logging-config

記載配置 ID。 若未提供，則該篩選器將套用至所有傳遞給該篩選器的叢集記錄設定。 您可以搭配使用 --show-matching-configs 旗標與指令來檢視符合過濾器的日誌配置。

--level

過濾掉指定層次以下的日誌。 可接受的值（按其標準順序）有 fatal、error、warn/warning、info、debug 和 trace。 舉例而言，如果您過濾 info 層次上的日誌，則也會過濾 debug 和 trace。 附註：只有在日誌訊息是 JSON 格式且包含 level 欄位時，才能使用此旗標。 輸出範例：{"log": "hello", "level": "info"}

--message

過濾掉日誌中任何位置包含指定訊息的任何日誌。 訊息會逐字比對，而不是以表示式的方式比對。 範例：訊息 "Hello"、"!" 及 "Hello, World!" 將套用至日誌 "Hello, World!"。

-n, --namespace

您要從中過濾日誌的 Kubernetes 名稱空間。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--regex-message

濾出任何在日誌中包含指定的訊息正規表示式型樣的日誌。 該訊息會與正規表示式比對。 範例：模式「hello [0-9]」將套用至「hello 1」、「hello 2」、「hello 9」

--type

您要將過濾器套用至其中的日誌類型。 目前支援所有的儲存器和主機。

範例

更新日誌篩選器

ibmcloud ks logging filter update --cluster CLUSTER --id ID --message MESSAGE

範例

顯示說明

ibmcloud ks logging help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--force-update

將叢集中的 Fluentd POD 強制更新為最新版本。

-q

不要顯示日或更新提示的訊息。

範例

重新載入叢集的日誌記錄設定

ibmcloud ks logging refresh --cluster CLUSTER

指令選項

-q

不要顯示日或更新提示的訊息。

範例

檢視當前使用者的訊息

ibmcloud ks messages

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--ip

一個以上 NLB IP 位址。 若要查看負載平衡器的 IP 位址，請執行 kubectl get svc -n <namespace>。

--nlb-host

主機名稱。 若要查看現有的主機名稱，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

將 NLB IP 新增至您先前使用 ibmcloud ks nlb-dns create

ibmcloud ks nlb-dns add --cluster CLUSTER --ip IP --nlb-host HOST

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--ip

一個以上 NLB IP 位址。 若要查看負載平衡器的 IP 位址，請執行 kubectl get svc -n <namespace>。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--secret-namespace

建立 SSL 密碼所在的名稱空間。 若未指定此標誌，密鑰將建立於 default.

範例

建立一個 DNS 主機名稱，以在傳統叢集中註冊一個或多個 NLB IP 位址

ibmcloud ks nlb-dns create classic --cluster CLUSTER --ip IP

範例

顯示說明

ibmcloud ks nlb-dns create help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--ip

一個以上 NLB IP 位址。 若要查看負載平衡器的 IP 位址，請執行 kubectl get svc -n <namespace>。

--lb-host

VPC 負載平衡器主機名稱。 若要查看負載平衡器的主機名稱，請執行 kubectl get svc -n <namespace>。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--secret-namespace

建立 SSL 密碼所在的名稱空間。 若未指定此標誌，密鑰將建立於 default.

範例

建立 DNS 記錄，以在 VPC 叢集中註冊負載平衡器的主機名稱或負載平衡器的 IP 位址

ibmcloud ks nlb-dns create vpc-gen2 --cluster CLUSTER --ip IP

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--nlb-subdomain

子網域。 若要查看現有的子網域，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視叢集內已登錄的 NLB 主機名稱的詳細資訊

ibmcloud ks nlb-dns get --cluster CLUSTER --nlb-subdomain SUBDOMAIN

範例

顯示說明

ibmcloud ks nlb-dns help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出叢集中已註冊的 NLB 主機名稱和 IP 位址

ibmcloud ks nlb-dns ls --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--enable

針對主機名稱啟用性能檢查監視器。

--header

HTTP 健康檢查的請求標頭僅限於 Host 標頭。 此標誌僅適用於 HTTP 或 HTTPS 這兩種類型。 此旗標接受以下格式的值：--header Header-Name=value。 更新監視器時，現有標頭會取代為您指定的標頭。 若要刪除所有現有的標頭，請將標誌設定為空值：--header ""。

--interval

每次性能檢查之間的間隔（以秒為單位）。 短間隔可能會改進失效接手時間，但會增加 IP 負載。 必須位於範圍 [60, 300] 內。 預設值： 60

--nlb-host

主機名稱。 若要查看現有的主機名稱，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

--path

據以進行性能檢查的端點路徑。 此標誌僅適用於 HTTP 或 HTTPS 這兩種類型。 預設值： /

--port

要連接至以進行性能檢查的埠號。 如果類型為 TCP，則需要此旗標。 如果類型為 HTTP 或 HTTPS，請僅針對 80（用於 HTTP）或 443（用於 HTTPS）以外的其他埠使用此旗標。 HTTP 預設值：80。 HTTPS 預設值：443。

-q

不要顯示日或更新提示的訊息。

--timeout

將 IP 視為性能不佳之前的逾時（以秒為單位）。 必須位於範圍 [1, 60] 內。 預設值： 5

--type

用於性能檢查的通訊協定。 有效值：http、https、tcp

範例

為叢集中的現有 NLB 主機名稱設定狀態檢查監控器

ibmcloud ks nlb-dns monitor configure --cluster CLUSTER --nlb-host HOST

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--nlb-host

主機名稱。 若要查看現有的主機名稱，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

停用叢集中某個 NLB 主機名稱的現有健康檢查監控器

ibmcloud ks nlb-dns monitor disable --cluster CLUSTER --nlb-host HOST

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--nlb-host

主機名稱。 若要查看現有的主機名稱，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

為叢集中的 NLB 主機名稱啟用健康檢查監控

ibmcloud ks nlb-dns monitor enable --cluster CLUSTER --nlb-host HOST

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--nlb-host

主機名稱。 若要查看現有的主機名稱，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

檢視現有健康檢查監控器的設定

ibmcloud ks nlb-dns monitor get --cluster CLUSTER --nlb-host HOST

範例

顯示說明

ibmcloud ks nlb-dns monitor help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

列出叢集中每個 NLB 主機名的健康檢查監控設定

ibmcloud ks nlb-dns monitor ls --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--lb-host

VPC 負載平衡器主機名稱。 若要查看負載平衡器的主機名稱，請執行 kubectl get svc -n <namespace>。

--nlb-subdomain

子網域。 若要查看現有的子網域，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

透過在 VPC 叢集中替換與該 DNS 主機名稱相關聯的負載平衡器主機名稱，來更新現有的 DNS 主機名稱

ibmcloud ks nlb-dns replace --cluster CLUSTER --lb-host HOST --nlb-subdomain SUBDOMAIN

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--ip

一個 NLB IP 位址。 若要查看與該主機名稱相關聯的 NLB IP 位址，請執行 ibmcloud ks nlb-dns ls。

--nlb-host

主機名稱。 若要查看現有的主機名稱，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

從 NLB 主機名稱中移除一個 NLB IP 位址

ibmcloud ks nlb-dns rm classic --cluster CLUSTER --ip IP --nlb-host HOST

範例

顯示說明

ibmcloud ks nlb-dns rm help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--ip

一個 NLB IP 位址。 若要查看與該主機名稱相關聯的 NLB IP 位址，請執行 ibmcloud ks nlb-dns ls。

--nlb-subdomain

子網域。 若要查看現有的子網域，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

從 VPC 叢集中的 DNS 記錄中移除負載平衡器的主機名稱或 IP 位址

ibmcloud ks nlb-dns rm vpc-gen2 --cluster CLUSTER --nlb-subdomain SUBDOMAIN

範例

顯示說明

ibmcloud ks nlb-dns secret help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--nlb-subdomain

子網域。 若要查看現有的子網域，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

重新產生 NLB 子網域的憑證與機密金鑰

ibmcloud ks nlb-dns secret regenerate --cluster CLUSTER --nlb-subdomain SUBDOMAIN

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

--nlb-subdomain

子網域。 若要查看現有的子網域，請執行 ibmcloud ks nlb-dns ls。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

範例

從 NLB 子網域中刪除機密，並防止該憑證日後續期

ibmcloud ks nlb-dns secret rm --cluster CLUSTER --nlb-subdomain SUBDOMAIN

範例

顯示說明

ibmcloud ks quota help

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

--provider

過濾清單以取得特定的基礎架構提供者。 有效值：classic、vpc-classic、vpc-gen2、satellite

-q

不要顯示日或更新提示的訊息。

範例

列出您在 IBM Cloud 帳戶中所有與叢集相關資源的配額與限制

ibmcloud ks quota ls

範例

顯示說明

ibmcloud ks script help

指令選項

--in-place

使用更新的指令結構重寫原始檔。

-q

不要顯示日或更新提示的訊息。

範例

重寫呼叫 IBM Cloud Kubernetes Service 外掛程式指令的腳本

ibmcloud ks script update FILE

範例

顯示說明

ibmcloud ks security-group help

指令選項

--attached-to

根據安全群組所綁定的元件來篩選這些安全群組。 有效值：cluster、load-balancer、vpc、vpe-gateway、worker-pool

-c, --cluster

請指定叢集名稱或 ID。

--managed-by

指定 user 以回傳該使用者所建立的安全群組。 請指定 ibm ，以僅回傳由 IBM 所管理的安全群組。 允許的值：ibm，user

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--scope

指定 cluster 以返回範圍限於該叢集的安全群組。 請指定 vpc ，以返回作用範圍涵蓋整個 VPC 的安全群組。 允許的值：cluster，vpc

範例

列出與某個叢集相關的所有安全群組

ibmcloud ks security-group ls --cluster CLUSTER

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-f

強制執行指令，而不出現使用者提示。

-q

不要顯示日或更新提示的訊息。

--security-group, --sg

指定安全群組 ID。

範例

刪除所有現有的安全群組規則，並重新套用預設規則

ibmcloud ks security-group reset --cluster CLUSTER --security-group GROUP

指令選項

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

--security-group, --sg

指定安全群組 ID。

範例

重新套用不存在的預設安全群組規則

ibmcloud ks security-group sync --cluster CLUSTER --security-group GROUP

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--volume

指定磁區 ID。 要列出可用的磁碟區，請執行 ibmcloud ks storage volume ls。

-w, --worker

指定工作程式 ID。 若要列出可用的工作節點，請執行 ibmcloud ks workers。

範例

將儲存卷掛載至工作節點

ibmcloud ks storage attachment create --cluster CLUSTER --volume VOLUME --worker WORKER_ID

指令選項

--attachment

指定磁區連接 ID。 若要列出可用的附件，請執行 ibmcloud ks storage attachment ls。

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

-w, --worker

指定工作程式 ID。 若要列出可用的工作節點，請執行 ibmcloud ks workers。

範例

取得叢集中某個卷連接點的詳細資訊

ibmcloud ks storage attachment get --attachment ATTACHMENT --cluster CLUSTER --worker WORKER_ID

範例

顯示說明

ibmcloud ks storage attachment help

指令選項

-c, --cluster

請指定叢集名稱或 ID。

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

-w, --worker

指定工作程式 ID。 若要列出可用的工作節點，請執行 ibmcloud ks workers。

範例

列出叢集中某個工作節點的所有儲存卷連接

ibmcloud ks storage attachment ls --cluster CLUSTER --worker WORKER_ID

指令選項

--attachment

指定磁區連接 ID。 若要列出可用的附件，請執行 ibmcloud ks storage attachment ls。

-c, --cluster

請指定叢集名稱或 ID。

-q

不要顯示日或更新提示的訊息。

-w, --worker

指定工作程式 ID。 若要列出可用的工作節點，請執行 ibmcloud ks workers。

範例

從工作節點中刪除卷附加裝置

ibmcloud ks storage attachment rm --attachment ATTACHMENT --cluster CLUSTER --worker WORKER_ID

範例

顯示說明

ibmcloud ks storage help

指令選項

--output

以提供的格式列印指令輸出。 允許的值：json

-q

不要顯示日或更新提示的訊息。

--volume

指定磁區 ID。 要列出可用的磁碟區，請執行 ibmcloud ks storage volume ls。