kubectl create role

概要

建立具有單一規則的角色。

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

範例

  # Create a role named "pod-reader" that allows user to perform "get", "watch" and "list" on pods
  kubectl create role pod-reader --verb=get --verb=list --verb=watch --resource=pods
  
  # Create a role named "pod-reader" with ResourceName specified
  kubectl create role pod-reader --verb=get --resource=pods --resource-name=readablepod --resource-name=anotherpod
  
  # Create a role named "foo" with API Group specified
  kubectl create role foo --verb=get,list,watch --resource=rs.apps
  
  # Create a role named "foo" with SubResource specified
  kubectl create role foo --verb=get,list,watch --resource=pods,pods/status

選項

--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

role 的說明

-o, --output string

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

--resource strings

規則套用的資源

--resource-name strings

規則套用的白名單中的資源,重複此標記以表示多個項目

--save-config

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

--show-managed-fields

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

--template string

當 -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 strings

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

--as string

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

--as-group strings

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

--as-uid string

要模擬操作的 UID。

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

預設快取目錄

--certificate-authority string

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

--client-certificate string

TLS 的用戶端憑證檔案路徑

--client-key string

TLS 的用戶端金鑰檔案路徑

--cluster string

要使用的 kubeconfig 叢集名稱

--context string

要使用的 kubeconfig 環境定義名稱

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

指出預設新增至每個尚未具有此容忍度的 Pod 的 notReady:NoExecute 容忍度的 tolerationSeconds。

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

指出預設新增至每個尚未具有此容忍度的 Pod 的 unreachable:NoExecute 容忍度的 tolerationSeconds。

--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"

放棄單一伺服器請求之前要等待的時間長度。非零值應包含對應的時間單位(例如 1 秒、2 分鐘、3 小時)。值為零表示請求不會逾時。

-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:更新 kubectl v1.32 版本的參考文件 (5c2cfa02af)