kubectl create clusterrole

摘要

建立叢集角色。

kubectl create clusterrole NAME --verb=verb --resource=resource.group [--resource-name=resourcename] [--dry-run=server|client|none]

範例

  # Create a cluster role named "pod-reader" that allows user to perform "get", "watch" and "list" on pods
  kubectl create clusterrole pod-reader --verb=get,list,watch --resource=pods
  
  # Create a cluster role named "pod-reader" with ResourceName specified
  kubectl create clusterrole pod-reader --verb=get --resource=pods --resource-name=readablepod --resource-name=anotherpod
  
  # Create a cluster role named "foo" with API Group specified
  kubectl create clusterrole foo --verb=get,list,watch --resource=rs.apps
  
  # Create a cluster role named "foo" with SubResource specified
  kubectl create clusterrole foo --verb=get,list,watch --resource=pods,pods/status
  
  # Create a cluster role name "foo" with NonResourceURL specified
  kubectl create clusterrole "foo" --verb=get --non-resource-url=/logs/*
  
  # Create a cluster role name "monitoring" with AggregationRule specified
  kubectl create clusterrole monitoring --aggregation-rule="rbac.example.com/aggregate-to-monitoring=true"

選項

--aggregation-rule <逗號分隔的 'key=value' 配對>

用於組合 ClusterRole 的聚合標籤選擇器。

--allow-missing-template-keys     預設值:true

如果為 true,則在範本中缺少欄位或地圖鍵時,忽略範本中的任何錯誤。僅適用於 golang 與 jsonpath 輸出格式。

--dry-run string[="unchanged"]     預設值:"none"

必須為 "none"、"server" 或 "client"。如果為 client 策略,則僅列印將傳送的物件,而不傳送它。如果為 server 策略,則提交伺服器端請求而不持久化資源。

--field-manager string     預設值:"kubectl-create"

用於追蹤欄位所有權的管理員名稱。

-h, --help

clusterrole 的說明

--non-resource-url 字串

使用者應有權存取的部分 URL。

-o, --output string

輸出格式。選項之一:(json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file)。

--resource 字串

規則適用的資源

--resource-name 字串

規則適用的白名單中的資源,針對多個項目重複此旗標

--save-config

如果為 true,則目前物件的組態將儲存在其註解中。否則,註解將保持不變。當您想要在未來對此物件執行 kubectl apply 時,此旗標很有用。

--show-managed-fields

如果為 true,則在 JSON 或 YAML 格式中列印物件時,保留 managedFields。

--template 字串

範本字串或範本檔案路徑,用於 -o=go-template、-o=go-template-file 時。範本格式為 golang 範本 [https://go.dev.org.tw/pkg/text/template/#pkg-overview]。

--validate string[="strict"]     預設值:"strict"

必須為下列其中一項:strict (或 true)、warn、ignore (或 false)。"true" 或 "strict" 將使用結構描述驗證輸入,如果無效則請求失敗。如果 API 伺服器上啟用 ServerSideFieldValidation,則將執行伺服器端驗證,但如果未啟用,則會退回較不可靠的用戶端驗證。"warn" 將警告未知或重複欄位,如果 API 伺服器上啟用伺服器端欄位驗證,則不會封鎖請求,否則行為如同 "ignore"。"false" 或 "ignore" 將不會執行任何結構描述驗證,並以靜默方式捨棄任何未知或重複欄位。

--verb 字串

適用於規則中包含的資源的動詞

--as 字串

要模擬操作的使用者名稱。使用者可以是命名空間中的一般使用者或服務帳戶。

--as-group 字串

要模擬操作的群組,可以重複此旗標以指定多個群組。

--as-uid 字串

要模擬操作的 UID。

--cache-dir string     預設值:"$HOME/.kube/cache"

預設快取目錄

--certificate-authority 字串

憑證授權單位的憑證檔案路徑

--client-certificate 字串

TLS 的用戶端憑證檔案路徑

--client-key 字串

TLS 的用戶端金鑰檔案路徑

--cluster 字串

要使用的 kubeconfig 叢集名稱

--context 字串

要使用的 kubeconfig 內容名稱

--default-not-ready-toleration-seconds int     預設值:300

指出針對 notReady:NoExecute 容忍度的 tolerationSeconds,預設會新增至每個尚未具備此容忍度的 Pod。

--default-unreachable-toleration-seconds int     預設值:300

指出針對 unreachable:NoExecute 容忍度的 tolerationSeconds,預設會新增至每個尚未具備此容忍度的 Pod。

--disable-compression

若為 true,則選擇不對所有伺服器請求進行回應壓縮

--insecure-skip-tls-verify

若為 true,則伺服器的憑證將不會檢查其有效性。這會使您的 HTTPS 連線變得不安全

--kubeconfig string

用於 CLI 請求的 kubeconfig 檔案路徑。

--match-server-version

要求伺服器版本與用戶端版本相符

-n, --namespace string

如果存在,則此 CLI 請求的命名空間範圍

--password string

用於 API 伺服器的基本身分驗證密碼

--profile string     預設值:"none"

要擷取的配置檔案名稱。選項之一 (none|cpu|heap|goroutine|threadcreate|block|mutex)

--profile-output string     預設值:"profile.pprof"

要將配置檔案寫入的檔案名稱

--request-timeout string     預設值:"0"

放棄單一伺服器請求前等待的時間長度。非零值應包含對應的時間單位 (例如 1s、2m、3h)。值為零表示請求永不逾時。

-s, --server string

Kubernetes API 伺服器的位址和連接埠

--storage-driver-buffer-duration duration     預設值:1m0s

儲存驅動程式中的寫入將會緩衝此持續時間,並以單一交易提交至非記憶體後端

--storage-driver-db string     預設值:"cadvisor"

資料庫名稱

--storage-driver-host string     預設值:"localhost:8086"

資料庫主機:連接埠

--storage-driver-password string     預設值:"root"

資料庫密碼

--storage-driver-secure

使用與資料庫的安全連線

--storage-driver-table string     預設值:"stats"

表格名稱

--storage-driver-user string     預設值:"root"

資料庫使用者名稱

--tls-server-name string

用於伺服器憑證驗證的伺服器名稱。如果未提供,則會使用用於聯絡伺服器的主機名稱

--token string

用於 API 伺服器身分驗證的 Bearer 權杖

--user string

要使用的 kubeconfig 使用者名稱

--username string

用於 API 伺服器的基本身分驗證使用者名稱

--version version[=true]

--version、--version=raw 列印版本資訊並結束;--version=vX.Y.Z... 設定回報的版本

--warnings-as-errors

將從伺服器收到的警告視為錯誤,並以非零的結束代碼結束

參見

本頁面為自動產生。

如果您計劃回報此頁面的問題,請在您的問題描述中提及此頁面為自動產生。修正可能需要在 Kubernetes 專案的其他地方進行。

最後修改時間:2024 年 12 月 12 日下午 2:44 PST:更新 v1.32 的 kubectl 參考文件 (5c2cfa02af)