다음을 통해 공유

az k8s-extension

  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.51.0 이상)에 대한 k8s 확장 확장의 일부입니다. az k8s-extension 명령을 처음 실행할 때 확장 이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Kubernetes 확장을 관리하는 명령입니다.

명령

Name Description 형식 상태
az k8s-extension create

Azure Marketplace에서 확장 제품 구매를 포함하여 Kubernetes 클러스터 확장을 만듭니다(AKS에만 해당). 확장을 만들거나 확장 제품을 구매하는 방법을 보려면 마지막에 있는 예제를 참조하세요.

 내선 번호 GA
az k8s-extension delete

Kubernetes 확장을 삭제합니다.

 내선 번호 GA
az k8s-extension extension-types

Kubernetes 확장 형식을 검색하는 명령입니다.

 내선 번호 미리 보기를
az k8s-extension extension-types list

기존 클러스터에 사용 가능한 클러스터 확장 유형을 나열합니다.

 내선 번호 미리 보기 및 사용되지 않음
az k8s-extension extension-types list-by-cluster

기존 클러스터에 사용 가능한 클러스터 확장 유형을 나열합니다. 필터링에 사용되는 속성에는 클러스터 유형(관리형, 연결된 등), kubernetes 버전, 클러스터 위치가 포함됩니다.

 내선 번호 미리 보기를
az k8s-extension extension-types list-by-location

지역에서 사용 가능한 클러스터 확장 유형을 나열합니다.

 내선 번호 미리 보기를
az k8s-extension extension-types list-versions

지정된 클러스터의 클러스터 확장 유형에 사용 가능한 버전을 나열합니다.

 내선 번호 미리 보기 및 사용되지 않음
az k8s-extension extension-types list-versions-by-cluster

지정된 클러스터의 클러스터 확장 유형에 사용 가능한 버전을 나열합니다. 필터링에 사용되는 속성에는 클러스터 유형(관리형, 연결된 등), kubernetes 버전, 클러스터 위치가 포함됩니다.

 내선 번호 미리 보기를
az k8s-extension extension-types list-versions-by-location

지역의 클러스터 확장 유형 버전에 사용 가능한 버전을 나열합니다.

 내선 번호 미리 보기를
az k8s-extension extension-types show

지역에서 클러스터 확장 유형에 대한 속성을 가져옵니다.

 내선 번호 미리 보기 및 사용되지 않음
az k8s-extension extension-types show-by-cluster

기존 클러스터의 클러스터 확장 유형에 대한 속성을 표시합니다. 필터링에 사용되는 속성에는 클러스터 유형(관리형, 연결된 등), kubernetes 버전, 클러스터 위치가 포함됩니다.

 내선 번호 미리 보기를
az k8s-extension extension-types show-by-location

지역에 클러스터 확장 유형에 대한 속성을 표시합니다.

 내선 번호 미리 보기를
az k8s-extension extension-types show-version-by-cluster

기존 클러스터의 클러스터 확장 유형 버전과 연결된 속성을 표시합니다. 필터링에 사용되는 속성에는 클러스터 유형(관리형, 연결된 등), kubernetes 버전, 클러스터 위치가 포함됩니다.

 내선 번호 미리 보기를
az k8s-extension extension-types show-version-by-location

지역에 클러스터 확장 유형 버전과 연결된 속성을 표시합니다.

 내선 번호 미리 보기를
az k8s-extension list

Kubernetes 확장을 나열합니다.

 내선 번호 GA
az k8s-extension show

Kubernetes 확장을 표시합니다.

 내선 번호 GA
az k8s-extension update

Kubernetes 확장의 변경 가능한 속성을 업데이트합니다.

 내선 번호 GA

az k8s-extension create

Azure Marketplace에서 확장 제품 구매를 포함하여 Kubernetes 클러스터 확장을 만듭니다(AKS에만 해당). 확장을 만들거나 확장 제품을 구매하는 방법을 보려면 마지막에 있는 예제를 참조하세요.

Kubernetes 확장을 만듭니다. 출력에는 보호해야 하는 비밀이 포함됩니다. 이러한 비밀을 소스 제어에 포함하지 않는지 확인합니다. 또한 명령 또는 스크립트의 로그에 비밀이 없는지 확인합니다. 자세한 내용은 http://aka.ms/clisecrets를 참조하세요.

az k8s-extension create --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --extension-type
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--plan-name]
                        [--plan-product]
                        [--plan-publisher]
                        [--release-namespace]
                        [--release-train]
                        [--scope {cluster, namespace}]
                        [--target-namespace]
                        [--version]

예제

Kubernetes 확장 만들기

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --extension-type microsoft.openservicemesh --scope cluster --release-train stable

Kubernetes Marketplace 확장 만들기

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type managedClusters --name myextension --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --release-train stable --plan-name testplan --plan-product kubernetest_apps_demo_offer --plan-publisher test_test_mix3pptest0011614206850774

필수 매개 변수

--cluster-name -c

Kubernetes 클러스터의 이름입니다.

--cluster-type -t

Arc 클러스터 또는 AKS 관리형 클러스터 또는 Arc 어플라이언스 또는 provisionedClusters를 지정합니다.

허용되는 값: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

확장 형식의 이름입니다.

--name -n

확장 인스턴스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--auto-upgrade --auto-upgrade-minor-version

확장 인스턴스의 부 버전을 자동으로 업그레이드합니다.

허용되는 값: false, true
--cluster-resource-provider --cluster-rp

이 clusterType의 클러스터 리소스 공급자 이름(provisionedClusters에 필요).

--config --configuration-settings

구성 설정 키=값 쌍으로 표시됩니다. 각 설정에 대해 매개 변수를 반복합니다. 이 값은 응답으로 반환되므로 비밀에 사용하지 마세요.

--config-file --config-settings-file

구성 설정에 대한 JSON 파일 경로입니다.

--config-protected --config-protected-settings

키=값 쌍으로 보호된 설정 구성합니다. 각 설정에 대해 매개 변수를 반복합니다. 키만 응답으로 반환되고 값은 반환되지 않습니다.

--config-protected-file --config-protected-settings-file

구성 보호 설정에 대한 JSON 파일 경로입니다.

--config-settings
사용되지 않음

옵션 '--config-settings'는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--configuration-settings'를 사용합니다.

구성 설정 키=값 쌍으로 표시됩니다. 각 설정에 대해 매개 변수를 반복합니다. 이 값은 응답으로 반환되므로 비밀에 사용하지 마세요.

--configuration-protected-settings
사용되지 않음

옵션 '--configuration-protected-settings'는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--config-protected-settings'를 사용합니다.

키=값 쌍으로 보호된 설정 구성합니다. 각 설정에 대해 매개 변수를 반복합니다. 키만 응답으로 반환되고 값은 반환되지 않습니다.

--configuration-protected-settings-file
사용되지 않음

옵션 '--configuration-protected-settings-file'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--config-protected-file'을 사용합니다.

구성 보호 설정에 대한 JSON 파일 경로입니다.

--configuration-settings-file
사용되지 않음

옵션 '--configuration-settings-file'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--config-settings-file'을 사용합니다.

구성 설정에 대한 JSON 파일 경로입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--plan-name

계획 이름은 사용량 정보 + 지원 아래 Marketplace 포털에서 가져온 확장의 계획 ID를 나타냅니다.

--plan-product

플랜 제품은 사용량 정보 + 지원에 따라 Marketplace 포털에서 가져온 확장의 제품 ID를 참조합니다. 이 예제는 사용된 ISV 제품의 이름입니다.

--plan-publisher

계획 게시자는 사용 정보 + 지원 아래 Marketplace 포털에서 가져온 확장의 게시자 ID를 참조합니다.

--release-namespace

확장 릴리스를 설치할 네임스페이스를 지정합니다.

--release-train

확장 유형에 대한 릴리스 학습을 지정합니다.

--scope

확장 범위를 지정합니다.

허용되는 값: cluster, namespace
--target-namespace

확장 인스턴스에 설치할 대상 네임스페이스를 지정합니다. 확장 범위가 '네임스페이스'로 설정된 경우 이 매개 변수가 필요합니다.

--version

--auto-upgrade-minor-version을 사용하도록 설정하지 않은 경우 확장 인스턴스에 설치할 버전을 지정합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az k8s-extension delete

Kubernetes 확장을 삭제합니다.

az k8s-extension delete --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--cluster-resource-provider]
                        [--force]
                        [--no-wait]
                        [--yes]

예제

기존 Kubernetes 확장 삭제

az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

필수 매개 변수

--cluster-name -c

Kubernetes 클러스터의 이름입니다.

--cluster-type -t

Arc 클러스터 또는 AKS 관리형 클러스터 또는 Arc 어플라이언스 또는 provisionedClusters를 지정합니다.

허용되는 값: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

확장 인스턴스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--cluster-resource-provider --cluster-rp

이 clusterType의 클러스터 리소스 공급자 이름(provisionedClusters에 필요).

--force

클러스터에서 확장을 강제로 삭제할지 여부를 지정합니다.

Default value: False
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--yes -y

확인 프롬프트를 무시합니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az k8s-extension list

Kubernetes 확장을 나열합니다.

해당 속성을 포함하여 클러스터의 모든 Kubernetes 확장을 나열합니다. 출력에는 보호해야 하는 비밀이 포함됩니다. 이러한 비밀을 소스 제어에 포함하지 않는지 확인합니다. 또한 명령 또는 스크립트의 로그에 비밀이 없는지 확인합니다. 자세한 내용은 http://aka.ms/clisecrets를 참조하세요.

az k8s-extension list --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --resource-group
                      [--cluster-resource-provider]

예제

클러스터의 모든 Kubernetes 확장 나열

az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

필수 매개 변수

--cluster-name -c

Kubernetes 클러스터의 이름입니다.

--cluster-type -t

Arc 클러스터 또는 AKS 관리형 클러스터 또는 Arc 어플라이언스 또는 provisionedClusters를 지정합니다.

허용되는 값: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--cluster-resource-provider --cluster-rp

이 clusterType의 클러스터 리소스 공급자 이름(provisionedClusters에 필요).

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az k8s-extension show

Kubernetes 확장을 표시합니다.

해당 속성을 포함하여 Kubernetes 확장을 표시합니다. 출력에는 보호해야 하는 비밀이 포함됩니다. 이러한 비밀을 소스 제어에 포함하지 않는지 확인합니다. 또한 명령 또는 스크립트의 로그에 비밀이 없는지 확인합니다. 자세한 내용은 http://aka.ms/clisecrets를 참조하세요.

az k8s-extension show --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --name
                      --resource-group
                      [--cluster-resource-provider]

예제

Kubernetes 확장의 세부 정보 표시

az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

필수 매개 변수

--cluster-name -c

Kubernetes 클러스터의 이름입니다.

--cluster-type -t

Arc 클러스터 또는 AKS 관리형 클러스터 또는 Arc 어플라이언스 또는 provisionedClusters를 지정합니다.

허용되는 값: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

확장 인스턴스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--cluster-resource-provider --cluster-rp

이 clusterType의 클러스터 리소스 공급자 이름(provisionedClusters에 필요).

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az k8s-extension update

Kubernetes 확장의 변경 가능한 속성을 업데이트합니다.

Config설정 및 ConfigProtected설정 업데이트의 경우 이러한 속성을 업데이트하기 전에 지원되는 검사 이러한 속성에 대한 업데이트는 클러스터 확장 서비스의 설명서를 참조하세요. 출력에는 보호해야 하는 비밀이 포함됩니다. 이러한 비밀을 소스 제어에 포함하지 않는지 확인합니다. 또한 명령 또는 스크립트의 로그에 비밀이 없는지 확인합니다. 자세한 내용은 http://aka.ms/clisecrets를 참조하세요.

az k8s-extension update --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--release-train]
                        [--version]
                        [--yes]

예제

Kubernetes 확장 업데이트

az k8s-extension update --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --auto-upgrade true/false --version extension-version --release-train stable --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file

필수 매개 변수

--cluster-name -c

Kubernetes 클러스터의 이름입니다.

--cluster-type -t

Arc 클러스터 또는 AKS 관리형 클러스터 또는 Arc 어플라이언스 또는 provisionedClusters를 지정합니다.

허용되는 값: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

확장 인스턴스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--auto-upgrade --auto-upgrade-minor-version

확장 인스턴스의 부 버전을 자동으로 업그레이드합니다.

허용되는 값: false, true
--cluster-resource-provider --cluster-rp

이 clusterType의 클러스터 리소스 공급자 이름(provisionedClusters에 필요).

--config --configuration-settings

구성 설정 키=값 쌍으로 표시됩니다. 각 설정에 대해 매개 변수를 반복합니다. 이 값은 응답으로 반환되므로 비밀에 사용하지 마세요.

--config-file --config-settings-file

구성 설정에 대한 JSON 파일 경로입니다.

--config-protected --config-protected-settings

키=값 쌍으로 보호된 설정 구성합니다. 각 설정에 대해 매개 변수를 반복합니다. 키만 응답으로 반환되고 값은 반환되지 않습니다.

--config-protected-file --config-protected-settings-file

구성 보호 설정에 대한 JSON 파일 경로입니다.

--config-settings
사용되지 않음

옵션 '--config-settings'는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--configuration-settings'를 사용합니다.

구성 설정 키=값 쌍으로 표시됩니다. 각 설정에 대해 매개 변수를 반복합니다. 이 값은 응답으로 반환되므로 비밀에 사용하지 마세요.

--configuration-protected-settings
사용되지 않음

옵션 '--configuration-protected-settings'는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--config-protected-settings'를 사용합니다.

키=값 쌍으로 보호된 설정 구성합니다. 각 설정에 대해 매개 변수를 반복합니다. 키만 응답으로 반환되고 값은 반환되지 않습니다.

--configuration-protected-settings-file
사용되지 않음

옵션 '--configuration-protected-settings-file'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--config-protected-file'을 사용합니다.

구성 보호 설정에 대한 JSON 파일 경로입니다.

--configuration-settings-file
사용되지 않음

옵션 '--configuration-settings-file'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--config-settings-file'을 사용합니다.

구성 설정에 대한 JSON 파일 경로입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--release-train

확장 유형에 대한 릴리스 학습을 지정합니다.

--version

--auto-upgrade-minor-version을 사용하도록 설정하지 않은 경우 확장 인스턴스에 설치할 버전을 지정합니다.

--yes -y

확인 프롬프트를 무시합니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.