az image builder

이미지 작성기 템플릿을 관리 하 고 빌드합니다.

명령

az image builder cancel

이미지 템플릿을 기반으로 하는 장기 실행 이미지 빌드를 취소 합니다.

az image builder create

이미지 작성기 템플릿을 만듭니다.

az image builder customizer

이미지 작성기 템플릿 사용자 지정자를 관리합니다.

az image builder customizer add

이미지 작성기 템플릿에 이미지 작성기 사용자 지정자 추가

az image builder customizer clear

이미지 작성기 템플릿에서 모든 이미지 작성기 사용자 지정자를 제거합니다.

az image builder customizer remove

이미지 작성기 템플릿에서 이미지 작성기 사용자 지정자 제거

az image builder delete

이미지 작성기 템플릿을 삭제 합니다.

az image builder list

이미지 작성기 템플릿을 나열 합니다.

az image builder output

이미지 작성기 템플릿 출력 배포자를 관리 합니다.

az image builder output add

이미지 작성기 템플릿에 이미지 작성기 출력 배포자를 추가 합니다.

az image builder output clear

이미지 작성기 템플릿에서 모든 이미지 작성기 출력 배포자를 제거 합니다.

az image builder output remove

이미지 작성기 템플릿에서 이미지 작성기 출력 배포자를 제거 합니다.

az image builder run

이미지 작성기 템플릿을 빌드합니다.

az image builder show

이미지 작성기 템플릿을 표시 합니다.

az image builder show-runs

이미지 작성기 템플릿의 실행 출력을 표시 합니다.

az image builder update

이미지 작성기 템플릿을 업데이트 합니다.

az image builder wait

템플릿의 조건이 충족 될 때까지 대기 상태에 CLI를 추가 합니다.

az image builder cancel

이미지 템플릿을 기반으로 하는 장기 실행 이미지 빌드를 취소 합니다.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

예제

이미지 빌드를 취소 합니다.

az image builder cancel -n mytemplate -g my-group

선택적 매개 변수

--ids

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

--name -n

이미지 템플릿의 이름입니다.

--resource-group -g

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

--subscription

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

az image builder create

이미지 작성기 템플릿을 만듭니다.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--subnet]
                        [--subscription]
                        [--tags]
                        [--vm-size]
                        [--vnet]

예제

UbuntuLTS 18.04 이미지에서 이미지 작성기 템플릿을 만듭니다. 관리 되는 이미지 및 공유 이미지 갤러리 이미지 버전으로 배포

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:UbuntuServer:18.04-LTS:18.04.201903060"

az image builder create --image-source $imagesource -n mytemplate -g my-group \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myidentity

이미지 템플릿 파일을 사용 하 여 이미지 작성기 템플릿을 만듭니다.

az image builder create -g my-group -n mytemplate --image-template filename

고급 --지연을 통해 CLI의 개체 캐시를 사용 하 여 여러 개인 정보와 배포자가 있는 이미지 템플릿을 만듭니다. 는 사용자 지정자 및 출력 이름, powershell 종료 코드, 인라인 스크립트, windows 다시 시작, 파일 사용자 지정자, 아티팩트 태그 및 vhd 출력 배포자와 같은 기능을 지원 합니다.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n mytemplate \
    -g my-group --scripts $script --identity myidentity --defer

# add customizers
az image builder customizer add -n mytemplate -g my-group  \
    --customizer-name my-pwsh-script --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n mytemplate -g my-group \
    --customizer-name my-file-customizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n mytemplate -g my-group --is-vhd \
    --output-name my-win-image-vhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n mytemplate -g my-group \
    --output-name my-win-image-managed --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n mytemplate -g my-group

필수 매개 변수

--name -n

이미지 템플릿의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--build-timeout

이미지 템플릿을 빌드하는 동안 대기 하는 최대 기간 (분)입니다. 기본값은 60입니다.

--checksum

Red Hat ISO 이미지의 SHA256 체크섬입니다.

--defer

Azure에 전송 하는 대신 로컬 캐시에 개체를 임시로 저장 합니다. az cache명령을 사용 하 여 보거나 지웁니다.

--identity

이미지 템플릿의 사용자 할당 id (이름 또는 ID, 공백으로 구분 된 이름) 목록입니다.

--image-source -i

사용자 지정할 기본 이미지입니다. 유효한 플랫폼 이미지 URN, 플랫폼 이미지 별칭, Red Hat ISO 이미지 URI, 관리 되는 이미지 이름/ID 또는 공유 이미지 버전 ID 여야 합니다.

다음에서의 값: az vm image list, az vm image show
--image-template

이미지 템플릿 파일의 로컬 경로 또는 URL입니다. --Image 템플릿을 사용 하는 경우-g 및-n을 제외 하 고 다른 모든 매개 변수는 무시 됩니다. 참조: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/image-builder-json

--location -l

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

--managed-image-destinations

관리 되는 이미지 출력 배포자 정보입니다. 공백으로 구분 된 키-값 쌍의 목록입니다. 예: "image_1 = westus2 image_2 = westus". 각 키는 만들 관리 되는 이미지의 이름 또는 리소스 ID입니다. 각 값은 이미지의 위치입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--os-disk-size

OS 디스크의 크기 (GB)입니다. Azure의 기본 OS 디스크 크기를 사용 하려면 0을 생략 하거나 지정 합니다.

--scripts

이미지를 사용자 지정할 수 있도록 공백으로 구분 된 셸 또는 powershell 스크립트 목록입니다. 각 스크립트는 공개적으로 액세스할 수 있는 URL 이어야 합니다. 파일 확장명 (' sh ' 또는 ' .ps1 ') 또는 원본 형식에서 스크립트의 형식을 유추 합니다. 더 많은 사용자 지정자 옵션과 유연성에 대 한 자세한 내용은 ' az image template 사용자 지정자 추가 '를 참조 하세요.

--shared-image-destinations

Sig (공유 이미지 갤러리) 출력 배포자 정보입니다. 공백으로 구분 된 키-값 쌍의 목록입니다. 예: "my_gallery_1/image_def_1 = eastus, westus my_gallery_2/image_def_2 = storage.westcentralus, canadaeast, francesouth." 각 키는 "/"로 구분 된 sig 이미지 정의 ID 또는 sig 갤러리 이름 및 sig 이미지 정의입니다. 각 값은 쉼표로 구분 된 복제본 위치 목록입니다.

--subnet

빌드 가상 컴퓨터를 배포할 서브넷의 이름 또는 ID입니다.

--subscription

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

--tags

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

--vm-size

이미지를 작성, 사용자 지정 및 캡처하는 데 사용 되는 가상 머신의 크기입니다. 기본값 (Standard_D1_v2)을 사용 하려면 빈 문자열을 생략 하거나 지정 합니다.

--vnet

빌드 가상 컴퓨터를 배포할 VNET의 이름입니다. 서브넷이 이름인 경우에만 지정 해야 합니다.

az image builder delete

이미지 작성기 템플릿을 삭제 합니다.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

예제

이미지 작성기 템플릿을 삭제 합니다. 자동 생성

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

선택적 매개 변수

--ids

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

--name -n

이미지 템플릿의 이름입니다.

--resource-group -g

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

--subscription

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

az image builder list

이미지 작성기 템플릿을 나열 합니다.

az image builder list [--query-examples]
                      [--resource-group]
                      [--subscription]

선택적 매개 변수

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

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

--subscription

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

az image builder run

이미지 작성기 템플릿을 빌드합니다.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

예제

템플릿 빌드 실행을 시작한 후 완료 될 때까지 기다립니다.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='running'"

az image builder show -n mytemplate -g my-group

선택적 매개 변수

--ids

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

--name -n

이미지 템플릿의 이름입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

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

--subscription

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

az image builder show

이미지 작성기 템플릿을 표시 합니다.

az image builder show [--ids]
                      [--name]
                      [--query-examples]
                      [--resource-group]
                      [--subscription]

예제

이미지 작성기 템플릿 표시 (자동 생성)

az image builder show --name mytemplate  --resource-group my-group

선택적 매개 변수

--ids

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

--name -n

이미지 템플릿의 이름입니다.

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

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

--subscription

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

az image builder show-runs

이미지 작성기 템플릿의 실행 출력을 표시 합니다.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

예제

템플릿 빌드 실행을 실행 한 다음 실행 출력을 봅니다.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='running'"

az image builder show-runs -n mytemplate -g my-group

선택적 매개 변수

--ids

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

--name -n

이미지 템플릿의 이름입니다.

--output-name

이미지 작성기 실행 출력의 이름입니다.

--resource-group -g

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

--subscription

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

az image builder update

이미지 작성기 템플릿을 업데이트 합니다.

이미지 작성기 템플릿 업데이트는 현재 지원 되지 않습니다. 이 명령은--를 사용 하 여 CLI 캐시 내에서 이미지 템플릿 개체를 업데이트 하는 것과 함께 사용할 수 있습니다. --를 지연 하지 않으면 캐시에서 지정 된 이미지 템플릿을 검색 하 고 Azure에 요청을 보내 이미지 템플릿을 만듭니다.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

예제

Cli 캐시의 템플릿 개체에서 템플릿 리소스를 만듭니다.

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정 하 여 개체 목록에 개체를 추가 합니다. 예:--속성을 추가 합니다. listProperty <key = value, string 또는 JSON string>.

--defer

Azure에 전송 하는 대신 로컬 캐시에 개체를 임시로 저장 합니다. az cache명령을 사용 하 여 보거나 지웁니다.

--force-string

' Set ' 또는 ' a l l '을 사용 하는 경우 JSON으로 변환 하는 대신 문자열 리터럴을 유지 합니다.

--ids

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

--name -n

이미지 템플릿의 이름입니다.

--remove

목록에서 속성이 나 요소를 제거 합니다. 예:--속성을 제거 합니다. 목록 또는--propertyToRemove을 제거 합니다.

--resource-group -g

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

--set

설정할 속성 경로 및 값을 지정 하 여 개체를 업데이트 합니다. 예:--set property1 property2 =.

--subscription

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

az image builder wait

템플릿의 조건이 충족 될 때까지 대기 상태에 CLI를 추가 합니다.

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--subscription]
                      [--timeout]
                      [--updated]

예제

템플릿 빌드 실행을 시작한 후 완료 될 때까지 기다립니다.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='running'"

az image builder show -n mytemplate -g my-group

선택적 매개 변수

--created

' 성공 '에서 ' provisioningState '를 사용 하 여 만들 때까지 기다립니다.

--custom

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

--deleted

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

--exists

리소스가 있을 때까지 기다립니다.

--ids

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

--interval

폴링 간격 (초)입니다.

기본값: 30
--name -n

이미지 템플릿의 이름입니다.

--resource-group -g

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

--subscription

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

--timeout

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

기본값: 3600
--updated

' 성공 '으로 provisioningState으로 업데이트할 때까지 기다립니다.