Share via

az arcdata dc config

  • 參考

注意

此參考是 Azure CLI 的 arcdata 延伸模組的一部分 （2.3.1 版或更高版本）。 擴充功能會在您第一次執行 az arcdata dc config 命令時自動安裝。 深入了解擴充功能。

組態命令。

命令

名稱 Description 類型 狀態
az arcdata dc config add

針對設定檔中的 json 路徑新增值。

 擴充 GA
az arcdata dc config init

初始化可與 搭配 az arcdata dc create 使用的資料控制器組態設定檔。

 擴充 GA
az arcdata dc config list

列出可用的組態設定檔選項。

 擴充 GA
az arcdata dc config patch

根據 json 修補程式檔案修補組態檔。

 擴充 GA
az arcdata dc config remove

針對設定檔中的 json 路徑移除值。

 擴充 GA
az arcdata dc config replace

針對設定檔中的 json 路徑取代值。

 擴充 GA
az arcdata dc config show

傳回資料控制器自訂資源的組態。

 擴充 GA

az arcdata dc config add

針對設定檔中的 json 路徑新增值。

在組態檔中的 json 路徑上新增值。 所有下列範例都是以 Bash 提供。 如果使用另一個命令列，您可能需要適當地逸出引號。 或者，您可以使用修補檔案功能。

az arcdata dc config add --config-file
                         --json-values
                         --path

範例

新增資料控制器儲存體。

az arcdata dc config add --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 '-p'。

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

--json-values -j

針對值之 json 路徑的機碼值組清單：key1.subkey1=value1,key2.subkey2=value2. 您可以提供內嵌 json 值，例如 key='{"kind":"cluster","name":"test-cluster"}'，或是提供檔案路徑，例如 key=./values.json。 add 命令不支援條件式。 如果您要提供的內嵌值是索引鍵值組本身與 「=」 和 「，」逸出這些字元。 例如，key1="key2=val2,key3=val3"。 如需路徑外觀的範例，請參閱 http://jsonpatch.com/ 。 如果您想要存取陣列，您必須指定索引，例如 key.0=value。

--path -p

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az arcdata dc config init

初始化可與 搭配 az arcdata dc create 使用的資料控制器組態設定檔。

初始化可與 搭配 az arcdata dc create 使用的資料控制器組態設定檔。 您可在引數中指定組態設定檔的特定來源。

az arcdata dc config init [--force]
                          [--path]
                          [--source]
                          [--target]

範例

引導式資料控制器設定 init 體驗 - 您會收到所需值的提示。

az arcdata dc config init

arcdata dc config init 搭配引數，在 ./custom 中建立 aks-dev-test 的組態設定檔。

az arcdata dc config init --source azure-arc-kubeadm --path custom

選擇性參數

--force -f

強制覆寫目標檔案。

--path -p

您想要放置組態設定檔的檔案路徑，預設為 /custom。

--source -s

組態設定檔來源：['azure-arc-ake'， 'azure-arc-aks-default-storage'， 'azure-arc-aks-dev-test'， 'azure-arc-aks-hci'、'azure-arc-aks-premium-storage'、'azure-arc-azure-openshift'、'azure-arc-eks'、'azure-arc-gke'、'azure-arc-kubeadm'、'azure-arc-kubeadm-dev-test'、'azure-arc-openshift'、'azure-arc-unit-test']。

--target -t
已被取代

選項 '-t' 已被取代，將在未來的版本中移除。 請改用 '-p'。

您想要放置組態設定檔的檔案路徑，預設為 /custom。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az arcdata dc config list

列出可用的組態設定檔選項。

列出可用於 的 arcdata dc config init 組態設定檔選項。

az arcdata dc config list [--config-profile]

範例

顯示所有可用的設定檔名稱。

az arcdata dc config list

顯示特定設定檔的 json。

az arcdata dc config list --config-profile aks-dev-test

選擇性參數

--config-profile -c

預設組態設定檔： ['azure-arc-ake'， 'azure-arc-aks-default-storage'， 'azure-arc-aks-dev-test'， 'azure-arc-aks-hci'、'azure-arc-aks-premium-storage'、'azure-arc-azure-openshift'、'azure-arc-eks'、'azure-arc-gke'、'azure-arc-kubeadm'、'azure-arc-kubeadm-dev-test'、'azure-arc-openshift'、'azure-arc-unit-test']。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az arcdata dc config patch

根據 json 修補程式檔案修補組態檔。

根據指定的修補檔修補組態檔。 請參閱 http://jsonpatch.com/ 以進一步瞭解應該如何撰寫路徑。 基於 jsonpath 程式庫 https://jsonpath.com/ \(英文\) 的原因，取代作業可以在其路徑中使用條件。 所有修補 json 檔案都必須以 "patch" 的機碼作為開頭，其具有修補陣列及其相對應的作業 (新增、取代、移除)、路徑及值。 「移除」作業不需要值，只需要路徑。 請參閱以下範例。

az arcdata dc config patch --config-file
                           --patch-file
                           --path

範例

例如 1 - 將單一端點的埠 （Data Controller Endpoint） 取代為修補程式檔案。

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

例如 2 - 以修補程式檔案取代資料控制器儲存體。

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 '--path'。

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

--patch-file -p

以 jsonpatch 程式庫 http://jsonpatch.com/ \(英文\) 為基礎之修補 json 檔案的路徑。 您必須以名為 "patch" 的機碼作為修補 json 檔案的開頭，其值是您要執行之修補作業的陣列。 針對修補作業的路徑，您可以使用點標記法，例如可針對大部分作業使用的 key1.key2。 如果您想要進行取代作業，且您是要取代需要條件之陣列中的值，請透過以 $ 作為路徑開頭來使用 jsonpath 標記法。 這可讓您執行 $.key1.key2[？（@.key3==「someValue」].key4。 請參閱以下範例。 如需條件的其他說明，請參閱： https://jsonpath.com/ 。

--path

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az arcdata dc config remove

針對設定檔中的 json 路徑移除值。

移除組態檔中 json 路徑的值。 所有下列範例都是以 Bash 提供。 如果使用另一個命令列，您可能需要適當地逸出引號。 或者，您可以使用修補檔案功能。

az arcdata dc config remove --config-file
                            --json-path
                            --path

範例

例如 1 - 移除資料控制器儲存體。

az arcdata dc config remove --path custom/control.json --json-path '.spec.storage'

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 '-p'。

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

--json-path -j

根據 jsonpatch 程式庫的 json 路徑清單，其能指出您想要移除的值，例如：key1.subkey1,key2.subkey2。 remove 命令不支援條件式。 如需路徑外觀的範例，請參閱 http://jsonpatch.com/ 。 如果您想要存取陣列，您必須指定索引，例如 key.0=value。

--path -p

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az arcdata dc config replace

針對設定檔中的 json 路徑取代值。

取代組態檔中 json 路徑的值。 Bash 中會提供所有範例。 如果使用另一個命令列，您可能需要適當地逸出引號。 或者，您可以使用修補檔案功能。

az arcdata dc config replace --config-file
                             --json-values
                             --path

範例

例如 1 - 取代單一端點的埠（資料控制器端點）。

az arcdata dc config replace --path custom/control.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

例如 2 - 取代資料控制器儲存體。

az arcdata dc config replace --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 '-p'。

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

--json-values -j

針對值之 json 路徑的機碼值組清單：key1.subkey1=value1,key2.subkey2=value2. 您可以提供內嵌 json 值，例如 key='{"kind":"cluster","name":"test-cluster"}'，或是提供檔案路徑，例如 key=./values.json。 replace 命令支援透過 jsonpath 程式庫的條件。 若要使用此方法，請以 $ 作為路徑開頭。 這可讓您執行條件式，例如 -j $.key1.key2[？（@.key3==「someValue」].key4=value。 如果您要提供的內嵌值是索引鍵值組本身與 「=」 和 「，」逸出這些字元。 例如，key1="key2=val2,key3=val3"。 您可以參閱底下的範例。 如需其他說明，請參閱： https://jsonpath.com/ 。

--path -p

您想要設定之組態的資料控制器設定檔路徑，也就是 custom/control.json。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az arcdata dc config show

傳回資料控制器自訂資源的組態。

az arcdata dc config show [--k8s-namespace]
                          [--use-k8s]

選擇性參數

--k8s-namespace -k

資料控制器所在的 Kubernetes 命名空間。

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。