kubectl create secret docker-registry

Synopsis

建立一個新的、用於 Docker 倉庫的 Secret。

    Dockercfg secrets are used to authenticate against Docker registries.
    
    When using the Docker command line to push images, you can authenticate to a given registry by running:
    '$ docker login DOCKER_REGISTRY_SERVER --username=DOCKER_USER --password=DOCKER_PASSWORD --email=DOCKER_EMAIL'.

這會生成一個 ~/.dockercfg 檔案,後續的 'docker push' 和 'docker pull' 命令會使用該檔案進行倉庫身份驗證。電子郵件地址是可選的。

    When creating applications, you may have a Docker registry that requires authentication.  In order for the
    nodes to pull images on your behalf, they must have the credentials.  You can provide this information
    by creating a dockercfg secret and attaching it to your service account.
kubectl create secret docker-registry NAME --docker-username=user --docker-password=password --docker-email=email [--docker-server=string] [--from-file=[key=]source] [--dry-run=server|client|none]

示例

  # If you do not already have a .dockercfg file, create a dockercfg secret directly
  kubectl create secret docker-registry my-secret --docker-server=DOCKER_REGISTRY_SERVER --docker-username=DOCKER_USER --docker-password=DOCKER_PASSWORD --docker-email=DOCKER_EMAIL
  
  # Create a new secret named my-secret from ~/.docker/config.json
  kubectl create secret docker-registry my-secret --from-file=path/to/.docker/config.json

Options

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

如果為 true,則在模板中缺少欄位或對映鍵時忽略模板中的任何錯誤。僅適用於 golang 和 jsonpath 輸出格式。

--append-hash

將 Secret 的雜湊值附加到其名稱。

--docker-email string

Docker 倉庫的電子郵件

--docker-password string

Docker 倉庫認證的密碼

--docker-server string     預設值: "https://index.docker.io/v1/"

Docker 倉庫的伺服器位置

--docker-username string

Docker 倉庫認證的使用者名稱

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

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

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

用於跟蹤欄位所有權的管理器名稱。

--from-file strings

可以使用檔案路徑指定金鑰檔案,在這種情況下,將為其提供預設名稱 .dockerconfigjson,或者可選地指定名稱和檔案路徑,在這種情況下將使用提供的名稱。指定目錄將迭代該目錄中的每個有效金鑰檔案。對於此命令,金鑰應始終為 .dockerconfigjson。

-h, --help

docker-registry 的幫助

-o, --output string

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

--save-config

如果為 true,當前物件的配置將儲存在其註解中。否則,註解將保持不變。如果您將來希望對此物件執行 kubectl apply,此標誌非常有用。

--show-managed-fields

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

--template string

當 -o=go-template, -o=go-template-file 時使用的模板字串或模板檔案路徑。模板格式為 golang 模板 [https://golang.org.tw/pkg/text/template/#pkg-overview]。

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

必須是以下值之一:strict(或 true)、warn、ignore(或 false)。"true" 或 "strict" 將使用一個 schema 來驗證輸入,並在無效時失敗請求。如果 api-server 上啟用了 ServerSideFieldValidation,它將執行伺服器端驗證,但如果未啟用,則會回退到不太可靠的客戶端驗證。"warn" 會在知道未知或重複欄位時發出警告,而不會阻止請求(如果 API 伺服器上啟用了伺服器端欄位驗證),否則表現為 "ignore"。"false" 或 "ignore" 將不執行任何 schema 驗證,靜默刪除任何未知或重複的欄位。

繼承的父選項

--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 上下文名稱

--disable-compression

如果為 true,則選擇退出所有到伺服器的請求的響應壓縮

--insecure-skip-tls-verify

如果為 true,則不會檢查伺服器證書的有效性。這將使您的 HTTPS 連線不安全。

--kubeconfig string

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

--kuberc string

用於首選項的 kuberc 檔案路徑。可以透過匯出 KUBECTL_KUBERC=false 功能標誌或關閉 KUBERC=off 功能來停用此功能。

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

--user string

要使用的 kubeconfig 使用者名稱

--username string

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

--version version[=true]

--version, --version=raw 列印版本資訊並退出;--version=vX.Y.Z... 設定報告的版本

--warnings-as-errors

將從伺服器收到的警告視為錯誤,並以非零退出程式碼退出。

另請參閱

本頁面是自動生成的。

如果你打算報告此頁面存在的問題,請在問題描述中提及此頁面是自動生成的。修復可能需要在 Kubernetes 專案的其他地方進行。

最後修改於 2025 年 9 月 4 日下午 3:30 PST: Update kubectl reference for v1.34 (bdc4bba2a5)