az connectedk8s

참고 항목

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

연결된 kubernetes 클러스터를 관리하는 명령입니다.

명령

Name	Description	형식	상태
az connectedk8s connect	연결된 kubernetes 클러스터를 Azure에 온보딩합니다.	내선 번호	GA
az connectedk8s delete	연결된 클러스터 에이전트와 함께 연결된 kubernetes 클러스터를 삭제합니다.	내선 번호	GA
az connectedk8s disable-features	연결된 클러스터에서 선택적 기능을 사용하지 않도록 설정합니다.	내선 번호	프리뷰
az connectedk8s enable-features	연결된 클러스터에서 선택적 기능을 사용하도록 설정합니다.	내선 번호	프리뷰
az connectedk8s list	연결된 kubernetes 클러스터를 나열합니다.	내선 번호	GA
az connectedk8s proxy	연결된 kubernetes 클러스터에 액세스합니다.	내선 번호	GA
az connectedk8s show	연결된 kubernetes 클러스터의 세부 정보를 표시합니다.	내선 번호	GA
az connectedk8s troubleshoot	Arc 지원 Kubernetes 클러스터에서 진단 검사를 수행합니다.	내선 번호	프리뷰
az connectedk8s update	호 온보딩된 kubernetes 클러스터의 속성을 업데이트합니다.	내선 번호	GA
az connectedk8s upgrade	온보딩된 에이전트를 특정 버전으로 원자성으로 업그레이드하거나 기본값을 최신 버전으로 업그레이드합니다.	내선 번호	GA

az connectedk8s connect

연결된 kubernetes 클러스터를 Azure에 온보딩합니다.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert]
                        [--custom-locations-oid]
                        [--disable-auto-upgrade]
                        [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                        [--distribution-version]
                        [--enable-oidc-issuer {false, true}]
                        [--enable-private-link {false, true}]
                        [--enable-wi {false, true}]
                        [--infrastructure {LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--onboarding-timeout]
                        [--pls-arm-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

예제

기본 kube 구성 및 kube 컨텍스트를 사용하여 연결된 kubernetes 클러스터를 온보딩합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

기본 kube 구성 및 kube 컨텍스트를 사용하여 연결된 kubernetes 클러스터를 온보딩하고 arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --disable-auto-upgrade

kubeconfig 및 kubecontext를 지정하여 연결된 kubernetes 클러스터를 등록합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

https 프록시, http 프록시, 프록시 설정 없음을 지정하여 연결된 kubernetes 클러스터를 온보딩합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

https 프록시, http 프록시, 인증서 설정이 있는 프록시를 지정하여 연결된 kubernetes 클러스터를 온보딩합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

프라이빗 링크 매개 변수를 지정하여 프라이빗 링크 기능을 사용하도록 설정된 연결된 kubernetes 클러스터를 등록합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-private-link true --private-link-scope-resource-id pls/resource/arm/id

사용자 지정 온보딩 시간 제한이 있는 연결된 kubernetes 클러스터를 온보딩합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --onboarding-timeout 600

oidc 발급자 및 워크로드 ID 웹후크를 사용하도록 설정된 연결된 kubernetes 클러스터를 온보딩합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

퍼블릭 클라우드 클러스터에 대한 자체 호스팅 발급자 URL을 사용하여 oidc 발급자를 사용하도록 설정된 연결된 kubernetes 클러스터를 온보딩합니다.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--azure-hybrid-benefit

Azure 하이브리드 혜택 기능을 사용하거나 사용하지 않도록 설정하는 플래그입니다.

허용되는 값: False, NotApplicable, True

--container-log-path

흐름 비트 로깅을 사용하도록 설정하려면 기본 컨테이너 로그 경로를 재정의합니다.

--correlation-id

클러스터 온보딩의 원본을 내부적으로 추적하는 데 사용되는 GUID입니다. 권장하지 않는 한 수정하지 마세요.

--custom-ca-cert --proxy-cert

프록시 또는 사용자 지정 인증 기관에 대한 인증서 파일의 경로입니다.

--custom-locations-oid

'사용자 지정 위치' 앱의 OID입니다.

--disable-auto-upgrade

Arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정하는 플래그입니다.

Default value: False

--distribution

연결된 클러스터에서 실행될 Kubernetes 배포입니다.

허용되는 값: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

Default value: generic

--distribution-version

연결된 클러스터의 Kubernetes 배포 버전입니다.

--enable-oidc-issuer

미리 보기

워크로드 ID에 사용되는 OIDC 발급자 URL을 만들 수 있습니다.

허용되는 값: false, true

Default value: False

--enable-private-link

미리 보기

연결된 클러스터 리소스에서 프라이빗 링크 지원을 사용하거나 사용하지 않도록 설정하는 플래그입니다. 허용되는 값: true, false

허용되는 값: false, true

--enable-wi --enable-workload-identity

미리 보기

워크로드 ID 웹후크를 사용하도록 설정합니다.

허용되는 값: false, true

Default value: False

--infrastructure

연결된 클러스터가 나타내는 Kubernetes 클러스터가 실행되는 인프라입니다.

허용되는 값: LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server

Default value: generic

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--location -l

위치. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--no-wait

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

Default value: False

--onboarding-timeout

arc-agent Pod를 kubernetes 클러스터에 설치하는 데 필요한 시간(초)입니다. 클러스터의 하드웨어/네트워크 제약 조건에 arc-agent Pod를 설치하는 데 더 많은 시간이 필요한 경우 이 값을 재정의합니다.

Default value: 1200

--pls-arm-id --private-link-scope-resource-id

미리 보기

연결된 클러스터가 연결된 프라이빗 링크 범위 리소스의 ARM 리소스 ID입니다.

--proxy-http

사용할 Http 프록시 URL입니다.

--proxy-https

사용할 Https 프록시 URL입니다.

--proxy-skip-range

프록시를 사용하지 않아야 하는 URL/CIDR 목록입니다.

--self-hosted-issuer

미리 보기

퍼블릭 클라우드 클러스터에 대한 자체 호스팅 발급자 URL - AKS, GKE, EKS.

--skip-ssl-verification

클러스터 연결에 대한 SSL 확인을 건너뜁니다.

Default value: False

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

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

연결된 클러스터 에이전트와 함께 연결된 kubernetes 클러스터를 삭제합니다.

az connectedk8s delete [--force]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--yes]

예제

기본 kubeconfig 및 kubecontext를 사용하여 연결된 kubernetes 클러스터 및 연결된 클러스터 에이전트를 삭제합니다.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

연결된 클러스터 에이전트 삭제에 대한 kubeconfig 및 kubecontext를 지정하여 연결된 kubernetes 클러스터를 삭제합니다.

az connectedk8s delete -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

선택적 매개 변수

--force

클러스터에서 모든 azure-arc 리소스를 제거하려면 강제로 삭제합니다.

Default value: False

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--name -n

연결된 클러스터의 이름입니다.

--no-wait

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

Default value: False

--resource-group -g

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

--skip-ssl-verification

클러스터 연결에 대한 SSL 확인을 건너뜁니다.

Default value: False

--subscription

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

--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 connectedk8s disable-features

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

연결된 클러스터에서 선택적 기능을 사용하지 않도록 설정합니다.

az connectedk8s disable-features --features {azure-rbac, cluster-connect, custom-locations}
                                 [--ids]
                                 [--kube-config]
                                 [--kube-context]
                                 [--name]
                                 [--resource-group]
                                 [--skip-ssl-verification]
                                 [--subscription]
                                 [--yes]

예제

azure-rbac 기능을 사용하지 않도록 설정합니다.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features azure-rbac

여러 기능을 사용하지 않도록 설정합니다.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features custom-locations azure-rbac

필수 매개 변수

--features

사용하지 않도록 설정할 기능의 공백으로 구분된 목록입니다.

허용되는 값: azure-rbac, cluster-connect, custom-locations

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

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

--skip-ssl-verification

클러스터 연결에 대한 SSL 확인을 건너뜁니다.

Default value: False

--subscription

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

--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 connectedk8s enable-features

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

연결된 클러스터에서 선택적 기능을 사용하도록 설정합니다.

az connectedk8s enable-features --features {azure-rbac, cluster-connect, custom-locations}
                                [--custom-locations-oid]
                                [--ids]
                                [--kube-config]
                                [--kube-context]
                                [--name]
                                [--resource-group]
                                [--skip-azure-rbac-list]
                                [--skip-ssl-verification]
                                [--subscription]

예제

클러스터 연결 기능을 사용하도록 설정합니다.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect

Azure RBAC 기능을 사용하도록 설정합니다.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --skip-azure-rbac-list "user1@domain.com,spn_oid"

여러 기능을 사용하도록 설정합니다.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect custom-locations

필수 매개 변수

--features

사용하려는 기능의 공백으로 구분된 목록입니다.

허용되는 값: azure-rbac, cluster-connect, custom-locations

선택적 매개 변수

--custom-locations-oid

'사용자 지정 위치' 앱의 OID입니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

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

--skip-azure-rbac-list

쉼표로 구분된 사용자 이름/이메일/oid 이름 목록입니다. 이러한 사용자에 대해 Azure RBAC를 건너뜁습니다. azure-rbac를 사용하도록 설정할 때 지정합니다.

--skip-ssl-verification

클러스터 연결에 대한 SSL 확인을 건너뜁니다.

Default value: False

--subscription

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

전역 매개 변수

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

연결된 kubernetes 클러스터를 나열합니다.

az connectedk8s list [--resource-group]

예제

리소스 그룹의 연결된 모든 kubernetes 클러스터를 나열합니다.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

구독에 연결된 모든 kubernetes 클러스터를 나열합니다.

az connectedk8s list --subscription subscriptionName

선택적 매개 변수

--resource-group -g

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

전역 매개 변수

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

연결된 kubernetes 클러스터에 액세스합니다.

az connectedk8s proxy [--file]
                      [--ids]
                      [--kube-context]
                      [--name]
                      [--port]
                      [--resource-group]
                      [--subscription]
                      [--token]

예제

연결된 kubernetes 클러스터에 액세스합니다.

az connectedk8s proxy -n clusterName -g resourceGroupName

사용자 지정 포트를 사용하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

az connectedk8s proxy -n clusterName -g resourceGroupName --port portValue

서비스 계정 토큰을 사용하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

az connectedk8s proxy -n clusterName -g resourceGroupName --token tokenValue

사용자 지정 kubeconfig 위치를 지정하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

az connectedk8s proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

사용자 지정 컨텍스트를 지정하여 연결된 kubernetes 클러스터에 대한 액세스 권한 가져오기

az connectedk8s proxy -n clusterName -g resourceGroupName --kube-context contextName

선택적 매개 변수

--file -f

업데이트할 Kubernetes 구성 파일입니다. 제공되지 않으면 '~/.kube/config' 파일을 업데이트합니다. 대신 '-'를 사용하여 YAML을 stdout에 인쇄합니다.

Default value: ~\.kube\config

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--kube-context

지정한 경우 기본 컨텍스트 이름을 덮어씁 수 있습니다.

--name -n

연결된 클러스터의 이름입니다.

--port

연결된 클러스터에 액세스하는 데 사용되는 포트입니다.

Default value: 47011

--resource-group -g

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

--subscription

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

--token

kubernetes 클러스터에 인증하는 데 사용할 서비스 계정 토큰입니다.

전역 매개 변수

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

연결된 kubernetes 클러스터의 세부 정보를 표시합니다.

az connectedk8s show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

예제

연결된 kubernetes 클러스터에 대한 세부 정보 표시

az connectedk8s show -g resourceGroupName -n connectedClusterName

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

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

--subscription

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

전역 매개 변수

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

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Arc 지원 Kubernetes 클러스터에서 진단 검사를 수행합니다.

az connectedk8s troubleshoot --name
                             --resource-group
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

예제

Arc 지원 Kubernetes 클러스터에서 진단 검사를 수행합니다.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

필수 매개 변수

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubeconfig 컨텍스트입니다.

--skip-ssl-verification

클러스터 연결에 대한 SSL 확인을 건너뜁니다.

Default value: False

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수

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

호 온보딩된 kubernetes 클러스터의 속성을 업데이트합니다.

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--container-log-path]
                       [--custom-ca-cert]
                       [--disable-proxy]
                       [--disable-wi {false, true}]
                       [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                       [--distribution-version]
                       [--enable-oidc-issuer {false, true}]
                       [--enable-wi {false, true}]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--self-hosted-issuer]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--tags]
                       [--yes]

예제

에이전트에 대한 프록시 값 업데이트

az connectedk8s update -g resourceGroupName -n connectedClusterName  --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

에이전트에 대한 프록시 설정 사용 안 함

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-proxy

에이전트 자동 업그레이드 사용 안 함

az connectedk8s update -g resourceGroupName -n connectedClusterName --auto-upgrade false

oidc 발급자 및 워크로드 ID 웹후크를 사용하도록 설정하여 연결된 kubernetes 클러스터를 업데이트합니다.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

퍼블릭 클라우드 클러스터에 대한 자체 호스팅 발급자 URL을 사용하여 oidc 발급자를 사용하도록 설정된 연결된 kubernetes 클러스터를 업데이트합니다.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

연결된 kubernetes 클러스터에서 워크로드 ID 웹후크를 사용하지 않도록 설정합니다.

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-workload-identity

선택적 매개 변수

--auto-upgrade

Arc 에이전트의 자동 업그레이드를 사용하거나 사용하지 않도록 설정하는 플래그입니다. 기본적으로 에이전트의 자동 업그레이드는 사용하도록 설정됩니다.

허용되는 값: false, true

--azure-hybrid-benefit

Azure 하이브리드 혜택 기능을 사용하거나 사용하지 않도록 설정하는 플래그입니다.

허용되는 값: False, NotApplicable, True

--container-log-path

흐름 비트 로깅을 사용하도록 설정하려면 기본 컨테이너 로그 경로를 재정의합니다.

--custom-ca-cert --proxy-cert

프록시 또는 사용자 지정 인증 기관에 대한 인증서 파일의 경로입니다.

--disable-proxy

에이전트에 대한 프록시 설정을 사용하지 않도록 설정합니다.

Default value: False

--disable-wi --disable-workload-identity

미리 보기

워크로드 ID 웹후크를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--distribution

연결된 클러스터에서 실행될 Kubernetes 배포입니다.

허용되는 값: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

--distribution-version

연결된 클러스터의 Kubernetes 배포 버전입니다.

--enable-oidc-issuer

미리 보기

워크로드 ID에 사용되는 OIDC 발급자 URL을 만들 수 있습니다.

허용되는 값: false, true

--enable-wi --enable-workload-identity

미리 보기

워크로드 ID 웹후크를 사용하도록 설정합니다.

허용되는 값: false, true

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--name -n

연결된 클러스터의 이름입니다.

--proxy-http

사용할 Http 프록시 URL입니다.

--proxy-https

사용할 Https 프록시 URL입니다.

--proxy-skip-range

프록시를 사용하지 않아야 하는 URL/CIDR 목록입니다.

--resource-group -g

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

--self-hosted-issuer

미리 보기

퍼블릭 클라우드 클러스터에 대한 자체 호스팅 발급자 URL - AKS, GKE, EKS.

--skip-ssl-verification

클러스터 연결에 대한 SSL 확인을 건너뜁니다.

Default value: False

--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

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

온보딩된 에이전트를 특정 버전으로 원자성으로 업그레이드하거나 기본값을 최신 버전으로 업그레이드합니다.

az connectedk8s upgrade [--agent-version]
                        [--ids]
                        [--kube-config]
                        [--kube-context]
                        [--name]
                        [--resource-group]
                        [--skip-ssl-verification]
                        [--subscription]
                        [--upgrade-timeout]

예제

에이전트를 최신 버전으로 업그레이드

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

에이전트를 특정 버전으로 업그레이드

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --agent-version 0.2.62

사용자 지정 업그레이드 시간 제한으로 에이전트를 업그레이드합니다.

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --upgrade-timeout 600

선택적 매개 변수

--agent-version

helm 차트를 업데이트할 에이전트의 버전입니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--kube-config

kube 구성 파일의 경로입니다.

--kube-context

현재 컴퓨터의 Kubconfig 컨텍스트입니다.

--name -n

연결된 클러스터의 이름입니다.

--resource-group -g

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

--skip-ssl-verification

클러스터 연결에 대한 SSL 확인을 건너뜁니다.

Default value: False

--subscription

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

--upgrade-timeout

arc-agent Pod를 kubernetes 클러스터에서 업그레이드하는 데 필요한 시간(초)입니다. 클러스터의 하드웨어/네트워크 제약 조건에 arc-agent Pod를 업그레이드하는 데 더 많은 시간이 필요한 경우 이 값을 재정의합니다.

Default value: 600

전역 매개 변수

--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를 사용합니다.