다음을 통해 공유


az fleet updaterun

참고 항목

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

업데이트 실행을 관리하는 명령입니다.

명령

Name Description 형식 상태
az fleet updaterun create

업데이트 실행을 만들거나 업데이트합니다.

내선 번호 GA
az fleet updaterun delete

업데이트 실행을 삭제합니다.

내선 번호 GA
az fleet updaterun list

플릿의 업데이트 실행을 나열합니다.

내선 번호 GA
az fleet updaterun show

업데이트 실행을 표시합니다.

내선 번호 GA
az fleet updaterun skip

UpdateRun 내에서 건너뛸 대상을 설정합니다.

내선 번호 GA
az fleet updaterun start

업데이트 실행을 시작합니다.

내선 번호 GA
az fleet updaterun stop

업데이트 실행을 중지합니다.

내선 번호 GA
az fleet updaterun wait

업데이트 실행 리소스가 원하는 상태에 도달할 때까지 기다립니다.

내선 번호 GA

az fleet updaterun create

업데이트 실행을 만들거나 업데이트합니다.

az fleet updaterun create --fleet-name
                          --name
                          --resource-group
                          --upgrade-type {ControlPlaneOnly, Full, NodeImageOnly}
                          [--kubernetes-version]
                          [--no-wait]
                          [--node-image-selection {Consistent, Latest}]
                          [--stages]
                          [--update-strategy-name]

예제

'전체' 업그레이드 유형을 사용하여 플릿에 대한 업데이트 실행을 만듭니다.

az fleet updaterun create -g MyResourceGroup -f MyFleet -n MyUpdateRun --upgrade-type Full --kubernetes-version 1.25.0 --node-image-selection Latest

'NodeImageOnly' 업그레이드 유형을 사용하여 플릿에 대한 업데이트 실행을 만듭니다.

az fleet updaterun create -g MyResourceGroup -f MyFleet -n MyUpdateRun --upgrade-type NodeImageOnly --node-image-selection Latest

'전체' 업그레이드 유형 및 스테이지를 사용하여 플릿에 대한 업데이트 실행을 만듭니다.

az fleet updaterun create -g MyResourceGroup -f MyFleet -n MyUpdateRun --upgrade-type Full --kubernetes-version 1.25.0 --node-image-selection Latest --stages ./test/stages.json

    The following JSON structure represents example contents of the parameter '--stages ./test/stages.json'.
    A stages array is composed of one or more stages, each containing one or more groups.
    Each group contains the 'name' property, which represents the group to which a cluster belongs (see 'az fleet member create --help').
    Stages have an optional 'afterStageWaitInSeconds' integer property, acting as a delay between stage execution.
    {
        "stages": [
            {
                "name": "stage1",
                "groups": [
                    {
                        "name": "group-a1"
                    },
                    {
                        "name": "group-a2"
                    },
                    {
                        "name": "group-a3"
                    }
                ],
                "afterStageWaitInSeconds": 3600
            },
            {
                "name": "stage2",
                "groups": [
                    {
                        "name": "group-b1"
                    },
                    {
                        "name": "group-b2"
                    },
                    {
                        "name": "group-b3"
                    }
                ]
            },
        ]
    }

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--name -n

업데이트 실행의 이름을 지정합니다.

--resource-group -g

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

--upgrade-type

멤버의 업그레이드 유형을 지정합니다. 허용되는 값은 'Full', 'ControlPlaneOnly' 및 'NodeImageOnly'입니다.

허용되는 값: ControlPlaneOnly, Full, NodeImageOnly

선택적 매개 변수

--kubernetes-version

--upgrade-type이 'Full' 또는 'ControlPlaneOnly'로 설정된 경우 멤버를 업그레이드할 kubernetes 버전을 지정합니다. 허용되는 형식은 x.x.x(예: 1.2.3)입니다.

--no-wait

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

Default value: False
--node-image-selection

노드 이미지 선택은 클러스터의 노드를 업그레이드하는 방법을 선택할 수 있는 옵션입니다.

허용되는 값: Consistent, Latest
--stages

플릿을 업그레이드하는 단계를 정의하는 JSON 파일의 경로입니다. 참조에 대한 예제를 참조하세요.

--update-strategy-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 fleet updaterun delete

업데이트 실행을 삭제합니다.

az fleet updaterun delete --fleet-name
                          --name
                          --resource-group
                          [--no-wait]
                          [--yes]

예제

업데이트 실행을 삭제합니다.

az fleet updaterun delete -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--name -n

업데이트 실행의 이름을 지정합니다.

--resource-group -g

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

선택적 매개 변수

--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 fleet updaterun list

플릿의 업데이트 실행을 나열합니다.

az fleet updaterun list --fleet-name
                        --resource-group

예제

업데이트 실행의 세부 정보를 표시합니다.

az fleet updaterun list -g MyFleetResourceGroup -f MyFleetName

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--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 fleet updaterun show

업데이트 실행을 표시합니다.

az fleet updaterun show --fleet-name
                        --name
                        --resource-group

예제

업데이트 실행의 세부 정보를 표시합니다.

az fleet updaterun show -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--name -n

업데이트 실행의 이름을 지정합니다.

--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 fleet updaterun skip

UpdateRun 내에서 건너뛸 대상을 설정합니다.

az fleet updaterun skip --fleet-name
                        --name
                        --resource-group
                        [--no-wait]
                        [--targets]

예제

건너뛸 두 개의 대상을 설정합니다.

az fleet updaterun skip -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun --targets Group:my-group-name Stage:my-stage-name

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--name -n

업데이트 실행의 이름을 지정합니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

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

Default value: False
--targets
미리 보기

건너뛸 대상의 공백으로 구분된 목록입니다. 대상은 Group:MyGroup과 같은 'targetType:targetName' 형식이어야 합니다. 유효한 대상 유형은 ('Member', 'Group', 'Stage', 'AfterStageWait')입니다. 대상 형식은 대/소문자를 구분합니다.

전역 매개 변수
--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 fleet updaterun start

업데이트 실행을 시작합니다.

az fleet updaterun start --fleet-name
                         --name
                         --resource-group
                         [--no-wait]

예제

업데이트 실행을 시작합니다.

az fleet updaterun start -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--name -n

업데이트 실행의 이름을 지정합니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

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

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 fleet updaterun stop

업데이트 실행을 중지합니다.

az fleet updaterun stop --fleet-name
                        --name
                        --resource-group
                        [--no-wait]

예제

업데이트 실행을 중지합니다.

az fleet updaterun stop -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--name -n

업데이트 실행의 이름을 지정합니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

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

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 fleet updaterun wait

업데이트 실행 리소스가 원하는 상태에 도달할 때까지 기다립니다.

업데이트 실행에 대한 작업이 중단되었거나 시작된 --no-wait경우 이 명령을 사용하여 작업이 완료될 때까지 기다립니다.

az fleet updaterun wait --fleet-name
                        --resource-group
                        --update-run-name
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--timeout]
                        [--updated]

필수 매개 변수

--fleet-name -f

플릿 이름을 지정합니다.

--resource-group -g

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

--update-run-name

UpdateRun 리소스의 이름입니다. 필수입니다.

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

Default value: False
--interval

폴링 간격(초)입니다.

Default value: 30
--timeout

최대 대기 시간(초)입니다.

Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

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