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
선택적 매개 변수
하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.
이미지 템플릿의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
이미지 템플릿의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
이미지 템플릿을 빌드하는 동안 대기 하는 최대 기간 (분)입니다. 기본값은 60입니다.
Red Hat ISO 이미지의 SHA256 체크섬입니다.
Azure에 전송 하는 대신 로컬 캐시에 개체를 임시로 저장 합니다. az cache명령을 사용 하 여 보거나 지웁니다.
이미지 템플릿의 사용자 할당 id (이름 또는 ID, 공백으로 구분 된 이름) 목록입니다.
사용자 지정할 기본 이미지입니다. 유효한 플랫폼 이미지 URN, 플랫폼 이미지 별칭, Red Hat ISO 이미지 URI, 관리 되는 이미지 이름/ID 또는 공유 이미지 버전 ID 여야 합니다.
이미지 템플릿 파일의 로컬 경로 또는 URL입니다. --Image 템플릿을 사용 하는 경우-g 및-n을 제외 하 고 다른 모든 매개 변수는 무시 됩니다. 참조: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/image-builder-json
위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
관리 되는 이미지 출력 배포자 정보입니다. 공백으로 구분 된 키-값 쌍의 목록입니다. 예: "image_1 = westus2 image_2 = westus". 각 키는 만들 관리 되는 이미지의 이름 또는 리소스 ID입니다. 각 값은 이미지의 위치입니다.
장기 실행 작업이 완료될 때까지 기다리지 마세요.
OS 디스크의 크기 (GB)입니다. Azure의 기본 OS 디스크 크기를 사용 하려면 0을 생략 하거나 지정 합니다.
이미지를 사용자 지정할 수 있도록 공백으로 구분 된 셸 또는 powershell 스크립트 목록입니다. 각 스크립트는 공개적으로 액세스할 수 있는 URL 이어야 합니다. 파일 확장명 (' sh ' 또는 ' .ps1 ') 또는 원본 형식에서 스크립트의 형식을 유추 합니다. 더 많은 사용자 지정자 옵션과 유연성에 대 한 자세한 내용은 ' az image template 사용자 지정자 추가 '를 참조 하세요.
Sig (공유 이미지 갤러리) 출력 배포자 정보입니다. 공백으로 구분 된 키-값 쌍의 목록입니다. 예: "my_gallery_1/image_def_1 = eastus, westus my_gallery_2/image_def_2 = storage.westcentralus, canadaeast, francesouth." 각 키는 "/"로 구분 된 sig 이미지 정의 ID 또는 sig 갤러리 이름 및 sig 이미지 정의입니다. 각 값은 쉼표로 구분 된 복제본 위치 목록입니다.
빌드 가상 컴퓨터를 배포할 서브넷의 이름 또는 ID입니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
공백으로 구분 된 태그: 키 [= 값] [키 [= 값] ...]. ""를 사용 하 여 기존 태그를 지웁니다.
이미지를 작성, 사용자 지정 및 캡처하는 데 사용 되는 가상 머신의 크기입니다. 기본값 (Standard_D1_v2)을 사용 하려면 빈 문자열을 생략 하거나 지정 합니다.
빌드 가상 컴퓨터를 배포할 VNET의 이름입니다. 서브넷이 이름인 경우에만 지정 해야 합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az image builder delete
이미지 작성기 템플릿을 삭제 합니다.
az image builder delete [--ids]
[--name]
[--resource-group]
[--subscription]
예제
이미지 작성기 템플릿을 삭제 합니다. 자동 생성
az image builder delete --name MyImageTemplate --resource-group MyResourceGroup
선택적 매개 변수
하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.
이미지 템플릿의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az image builder list
이미지 작성기 템플릿을 나열 합니다.
az image builder list [--query-examples]
[--resource-group]
[--subscription]
선택적 매개 변수
JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
선택적 매개 변수
하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.
이미지 템플릿의 이름입니다.
장기 실행 작업이 완료될 때까지 기다리지 마세요.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
선택적 매개 변수
하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.
이미지 템플릿의 이름입니다.
JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
선택적 매개 변수
하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.
이미지 템플릿의 이름입니다.
이미지 작성기 실행 출력의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
선택적 매개 변수
경로 및 키 값 쌍을 지정 하 여 개체 목록에 개체를 추가 합니다. 예:--속성을 추가 합니다. listProperty <key = value, string 또는 JSON string>.
Azure에 전송 하는 대신 로컬 캐시에 개체를 임시로 저장 합니다. az cache명령을 사용 하 여 보거나 지웁니다.
' Set ' 또는 ' a l l '을 사용 하는 경우 JSON으로 변환 하는 대신 문자열 리터럴을 유지 합니다.
하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.
이미지 템플릿의 이름입니다.
목록에서 속성이 나 요소를 제거 합니다. 예:--속성을 제거 합니다. 목록 또는--propertyToRemove을 제거 합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
설정할 속성 경로 및 값을 지정 하 여 개체를 업데이트 합니다. 예:--set property1 property2 =.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
선택적 매개 변수
' 성공 '에서 ' provisioningState '를 사용 하 여 만들 때까지 기다립니다.
조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState! = ' InProgress ', instanceView. 상태 [? code = = ' PowerState/running '].
삭제 될 때까지 기다립니다.
리소스가 있을 때까지 기다립니다.
하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.
폴링 간격 (초)입니다.
이미지 템플릿의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
최대 대기 시간 (초)입니다.
' 성공 '으로 provisioningState으로 업데이트할 때까지 기다립니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.