Microsoft.VirtualMachineImages imageTemplates
Bicep 리소스 정의
imageTemplates 리소스 종류는 다음을 위해 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.VirtualMachineImages/imageTemplates 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2022-02-14' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
identity: {
type: 'string'
userAssignedIdentities: {}
}
properties: {
buildTimeoutInMinutes: int
customize: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute: [
{
artifactTags: {}
runOutputName: 'string'
type: 'string'
// For remaining properties, see ImageTemplateDistributor objects
}
]
source: {
type: 'string'
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup: 'string'
validate: {
continueDistributeOnFailure: bool
inVMValidations: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly: bool
}
vmProfile: {
osDiskSizeGB: int
userAssignedIdentities: [
'string'
]
vmSize: 'string'
vnetConfig: {
proxyVmSize: 'string'
subnetId: 'string'
}
}
}
}
ImageTemplateCustomizer 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
파일의 경우 다음을 사용합니다.
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
PowerShell의 경우 다음을 사용합니다.
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Shell의 경우 다음을 사용합니다.
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
WindowsRestart의 경우 다음을 사용합니다.
type: 'WindowsRestart'
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
WindowsUpdate의 경우 다음을 사용합니다.
type: 'WindowsUpdate'
filters: [
'string'
]
searchCriteria: 'string'
updateLimit: int
ImageTemplateDistributor 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
ManagedImage의 경우 다음을 사용합니다.
type: 'ManagedImage'
imageId: 'string'
location: 'string'
SharedImage의 경우 다음을 사용합니다.
type: 'SharedImage'
excludeFromLatest: bool
galleryImageId: 'string'
replicationRegions: [
'string'
]
storageAccountType: 'string'
VHD의 경우 다음을 사용합니다.
type: 'VHD'
ImageTemplateSource 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
ManagedImage의 경우 다음을 사용합니다.
type: 'ManagedImage'
imageId: 'string'
PlatformImage의 경우 다음을 사용합니다.
type: 'PlatformImage'
offer: 'string'
planInfo: {
planName: 'string'
planProduct: 'string'
planPublisher: 'string'
}
publisher: 'string'
sku: 'string'
version: 'string'
SharedImageVersion의 경우 다음을 사용합니다.
type: 'SharedImageVersion'
imageVersionId: 'string'
ImageTemplateInVMValidator 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
PowerShell의 경우 다음을 사용합니다.
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Shell의 경우 다음을 사용합니다.
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
속성 값
imageTemplates
Name | Description | 값 |
---|---|---|
name | 리소스 이름 | string(필수) |
위치 | 리소스가 있는 지리적 위치 | string(필수) |
tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
identity | 구성된 경우 이미지 템플릿의 ID입니다. | ImageTemplateIdentity (필수) |
properties | 이미지 템플릿의 속성 | ImageTemplateProperties |
ImageTemplateIdentity
Name | Description | 값 |
---|---|---|
형식 | 이미지 템플릿에 사용되는 ID 유형입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다. | 'None' 'UserAssigned' |
userAssignedIdentities | 이미지 템플릿과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. | object |
ImageTemplateProperties
Name | Description | 값 |
---|---|---|
buildTimeoutInMinutes | 이미지 템플릿을 빌드하는 동안 대기할 최대 기간입니다(모든 사용자 지정, 유효성 검사 및 배포 포함). 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다. | int |
사용자 지정 | 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. | ImageTemplateCustomizer[] |
배포(distribute) | 배포 대상은 이미지 출력을 이동해야 하는 위치입니다. | ImageTemplateDistributor[](필수) |
source | 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. | ImageTemplateSource (필수) |
stagingResourceGroup | 이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 준비 리소스 그룹 ID입니다. 이 필드가 비어 있으면 임의 이름을 가진 리소스 그룹이 만들어집니다. 이 필드에 지정된 리소스 그룹이 없으면 동일한 이름으로 만들어집니다. 지정된 리소스 그룹이 있는 경우 비어 있어야 하며 이미지 템플릿과 동일한 지역에 있어야 합니다. 이 필드가 비어 있거나 지정된 리소스 그룹이 없는 경우 템플릿을 삭제하는 동안 만든 리소스 그룹이 삭제되지만 지정된 리소스 그룹이 있는 경우 템플릿을 삭제하는 동안 리소스 그룹에서 만든 리소스가 삭제되고 리소스 그룹 자체가 유지됩니다. | string |
validate | 결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다. | ImageTemplatePropertiesValidate |
vmProfile | 가상 머신이 이미지를 빌드하도록 설정되는 방법을 설명합니다. | ImageTemplateVmProfile |
ImageTemplateCustomizer
Name | Description | 값 |
---|---|---|
name | 이 사용자 지정 단계가 수행하는 작업을 컨텍스트를 제공하는 이름 | 문자열 |
type | 개체 형식 설정 | 최근에 사용한 파일 PowerShell 셸 WindowsRestart WindowsUpdate (필수) |
ImageTemplateFileCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | '파일'(필수) |
destination | sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)입니다. | 문자열 |
sha256Checksum | 위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬 | 문자열 |
sourceUri | VM을 사용자 지정하기 위해 업로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등일 수 있습니다. | string |
ImageTemplatePowerShellCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'PowerShell'(필수) |
inline | 실행할 PowerShell 명령의 배열 | string[] |
runAsSystem | 지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다. | bool |
runElevated | 지정된 경우 PowerShell 스크립트는 관리자 권한으로 실행됩니다. | bool |
scriptUri | 사용자 지정을 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등일 수 있습니다. | 문자열 |
sha256Checksum | 위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬 | 문자열 |
validExitCodes | PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] | int[] |
ImageTemplateShellCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'Shell'(필수) |
inline | 실행할 셸 명령의 배열 | string[] |
scriptUri | 사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등일 수 있습니다. | 문자열 |
sha256Checksum | scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬 | 문자열 |
ImageTemplateRestartCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'WindowsRestart'(필수) |
restartCheckCommand | 다시 시작이 성공하면 검사 명령 [기본값: ''] | 문자열 |
restartCommand | 다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"'] | 문자열 |
restartTimeout | 크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2시간'(2시간) [기본값: '5m'] | 문자열 |
ImageTemplateWindowsUpdateCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'WindowsUpdate'(필수) |
filters | 적용할 업데이트를 선택할 필터의 배열입니다. 기본값(필터 없음)을 사용하도록 빈 배열을 생략하거나 지정합니다. 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요. | string[] |
searchCriteria | 업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요. | 문자열 |
updateLimit | 한 번에 적용할 최대 업데이트 수입니다. 기본값을 사용하려면 0을 생략하거나 지정합니다(1000). | int |
ImageTemplateDistributor
Name | Description | 값 |
---|---|---|
artifactTags | 배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용할 태그입니다. | object |
runOutputName | 연결된 RunOutput에 사용할 이름입니다. | string(필수) |
형식 | 개체 형식 설정 | ManagedImage SharedImage VHD (필수) |
ImageTemplateManagedImageDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | 'ManagedImage'(필수) |
imageId | Managed Disk 이미지의 리소스 ID | string(필수) |
위치 | 이미지에 대한 Azure 위치는 이미지가 이미 있는 경우 일치해야 합니다. | string(필수) |
ImageTemplateSharedImageDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | 'SharedImage'(필수) |
excludeFromLatest | 만든 이미지 버전을 최신 버전에서 제외할지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다. | bool |
galleryImageId | Shared Image Gallery 이미지의 리소스 ID | string(필수) |
replicationRegions | 이미지가 복제될 지역 목록 | string[] (필수) |
storageAccountType | 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | 'VHD'(필수) |
ImageTemplateSource
Name | Description | 값 |
---|---|---|
형식 | 개체 형식 설정 | ManagedImage PlatformImage SharedImageVersion (필수) |
ImageTemplateManagedImageSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'ManagedImage'(필수) |
imageId | 고객 구독에서 관리되는 이미지의 ARM 리소스 ID | string(필수) |
ImageTemplatePlatformImageSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'PlatformImage'(필수) |
제품 | Azure 갤러리 이미지의 이미지 제품입니다. | 문자열 |
planInfo | 플랫폼 이미지에 대한 구매 플랜의 선택적 구성입니다. | PlatformImagePurchasePlan |
publisher | Azure 갤러리 이미지의 이미지 게시자입니다. | string |
sku | Azure 갤러리 이미지의 이미지 sku입니다. | 문자열 |
버전 | Azure 갤러리 이미지의 이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿이 제출될 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다. | 문자열 |
PlatformImagePurchasePlan
Name | Description | 값 |
---|---|---|
planName | 구매 플랜의 이름입니다. | string(필수) |
planProduct | 구매 플랜의 제품입니다. | string(필수) |
planPublisher | 구매 플랜의 게시자입니다. | string(필수) |
ImageTemplateSharedImageVersionSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'SharedImageVersion'(필수) |
imageVersionId | 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID | string(필수) |
ImageTemplatePropertiesValidate
Name | Description | 값 |
---|---|---|
continueDistributeOnFailure | 유효성 검사에 실패하고 이 필드를 false로 설정하면 출력 이미지가 배포되지 않습니다. 기본 동작입니다. 유효성 검사에 실패하고 이 필드가 true로 설정된 경우 출력 이미지는 계속 배포됩니다. 이 옵션을 사용하면 잘못된 이미지가 배포될 수 있으므로 주의해서 사용하세요. 두 경우 모두(true 또는 false) 유효성 검사 실패 시 종단 간 이미지 실행이 실패한 것으로 보고됩니다. [참고: 유효성 검사에 성공하면 이 필드는 효과가 없습니다.] | bool |
inVMValidations | 수행할 유효성 검사 목록입니다. | ImageTemplateInVMValidator[] |
sourceValidationOnly | 이 필드를 true로 설정하면 'source' 섹션에 지정된 이미지의 유효성이 직접 검사됩니다. 사용자 지정 이미지를 생성한 다음, 유효성을 검사하기 위해 별도의 빌드가 실행되지 않습니다. | bool |
ImageTemplateInVMValidator
Name | Description | 값 |
---|---|---|
name | 이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 이름 | 문자열 |
type | 개체 유형 설정 | PowerShell 셸 (필수) |
ImageTemplatePowerShellValidator
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다. | 'PowerShell'(필수) |
inline | 실행할 PowerShell 명령의 배열 | string[] |
runAsSystem | 지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다. | bool |
runElevated | 지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다. | bool |
scriptUri | 유효성 검사를 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage URI 등이 될 수 있습니다. | 문자열 |
sha256Checksum | 위의 scriptUri 필드에 제공된 전원 셸 스크립트의 SHA256 체크섬 | 문자열 |
validExitCodes | PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] | int[] |
ImageTemplateShellValidator
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다. | 'Shell'(필수) |
inline | 실행할 셸 명령의 배열 | string[] |
scriptUri | 유효성 검사를 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage URI 등이 될 수 있습니다. | string |
sha256Checksum | scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬 | 문자열 |
ImageTemplateVmProfile
Name | Description | 값 |
---|---|---|
osDiskSizeGB | OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. | int |
userAssignedIdentities | 빌드 VM 및 유효성 검사 VM에서 구성할 사용자 할당 관리 ID의 리소스 ID의 선택적 배열입니다. 여기에는 이미지 템플릿의 ID가 포함될 수 있습니다. | string[] |
vmSize | 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). | string |
vnetConfig | 빌드 VM 및 유효성 검사 VM을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. | VirtualNetworkConfig |
VirtualNetworkConfig
Name | Description | 값 |
---|---|---|
proxyVmSize | 빌드 VM 및 유효성 검사 VM에 트래픽을 전달하는 데 사용되는 프록시 가상 머신의 크기입니다. 기본값(Standard_A1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다. | 문자열 |
subnetId | 기존 서브넷의 리소스 ID입니다. | string |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.
템플릿 | Description |
---|---|
Azure Windows 기준이 있는 Azure Image Builder |
Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다. |
Dev Box 서비스 구성 |
이 템플릿은 Dev Box 빠른 시작 가이드에 따라 모든 Dev Box 관리자 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다. |
ARM 템플릿 리소스 정의
imageTemplates 리소스 종류는 다음을 위해 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.VirtualMachineImages/imageTemplates 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.VirtualMachineImages/imageTemplates",
"apiVersion": "2022-02-14",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"buildTimeoutInMinutes": "int",
"customize": [
{
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
],
"distribute": [
{
"artifactTags": {},
"runOutputName": "string",
"type": "string"
// For remaining properties, see ImageTemplateDistributor objects
}
],
"source": {
"type": "string"
// For remaining properties, see ImageTemplateSource objects
},
"stagingResourceGroup": "string",
"validate": {
"continueDistributeOnFailure": "bool",
"inVMValidations": [
{
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateInVMValidator objects
}
],
"sourceValidationOnly": "bool"
},
"vmProfile": {
"osDiskSizeGB": "int",
"userAssignedIdentities": [ "string" ],
"vmSize": "string",
"vnetConfig": {
"proxyVmSize": "string",
"subnetId": "string"
}
}
}
}
ImageTemplateCustomizer 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
파일의 경우 다음을 사용합니다.
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
PowerShell의 경우 다음을 사용합니다.
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Shell의 경우 다음을 사용합니다.
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
WindowsRestart의 경우 다음을 사용합니다.
"type": "WindowsRestart",
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string"
WindowsUpdate의 경우 다음을 사용합니다.
"type": "WindowsUpdate",
"filters": [ "string" ],
"searchCriteria": "string",
"updateLimit": "int"
ImageTemplateDistributor 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
ManagedImage의 경우 다음을 사용합니다.
"type": "ManagedImage",
"imageId": "string",
"location": "string"
SharedImage의 경우 다음을 사용합니다.
"type": "SharedImage",
"excludeFromLatest": "bool",
"galleryImageId": "string",
"replicationRegions": [ "string" ],
"storageAccountType": "string"
VHD의 경우 다음을 사용합니다.
"type": "VHD"
ImageTemplateSource 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
ManagedImage의 경우 다음을 사용합니다.
"type": "ManagedImage",
"imageId": "string"
PlatformImage의 경우 다음을 사용합니다.
"type": "PlatformImage",
"offer": "string",
"planInfo": {
"planName": "string",
"planProduct": "string",
"planPublisher": "string"
},
"publisher": "string",
"sku": "string",
"version": "string"
SharedImageVersion의 경우 다음을 사용합니다.
"type": "SharedImageVersion",
"imageVersionId": "string"
ImageTemplateInVMValidator 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
PowerShell의 경우 다음을 사용합니다.
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Shell의 경우 다음을 사용합니다.
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
속성 값
imageTemplates
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | 'Microsoft.VirtualMachineImages/imageTemplates' |
apiVersion | 리소스 api 버전 | '2022-02-14' |
name | 리소스 이름 | string(필수) |
위치 | 리소스가 있는 지리적 위치 | string(필수) |
tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
identity | 구성된 경우 이미지 템플릿의 ID입니다. | ImageTemplateIdentity (필수) |
properties | 이미지 템플릿의 속성 | ImageTemplateProperties |
ImageTemplateIdentity
Name | Description | 값 |
---|---|---|
형식 | 이미지 템플릿에 사용되는 ID 유형입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다. | 'None' 'UserAssigned' |
userAssignedIdentities | 이미지 템플릿과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. | object |
ImageTemplateProperties
Name | Description | 값 |
---|---|---|
buildTimeoutInMinutes | 이미지 템플릿을 빌드하는 동안 대기할 최대 기간입니다(모든 사용자 지정, 유효성 검사 및 배포 포함). 기본값(4시간)을 사용하도록 0을 생략하거나 지정합니다. | int |
사용자 지정 | 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. | ImageTemplateCustomizer[] |
배포(distribute) | 배포 대상은 이미지 출력을 이동해야 하는 위치입니다. | ImageTemplateDistributor[] (필수) |
source | 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. | ImageTemplateSource (필수) |
stagingResourceGroup | 이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 스테이징 리소스 그룹 ID입니다. 이 필드가 비어 있으면 임의 이름을 가진 리소스 그룹이 만들어집니다. 이 필드에 지정된 리소스 그룹이 없으면 동일한 이름으로 만들어집니다. 지정된 리소스 그룹이 있는 경우 비어 있어야 하며 이미지 템플릿과 동일한 지역에 있어야 합니다. 이 필드가 비어 있거나 지정된 리소스 그룹이 없는 경우 템플릿을 삭제하는 동안 만든 리소스 그룹이 삭제되지만 지정된 리소스 그룹이 있는 경우 템플릿을 삭제하는 동안 리소스 그룹에서 만든 리소스가 삭제되고 리소스 그룹 자체가 유지됩니다. | 문자열 |
validate | 결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다. | ImageTemplatePropertiesValidate |
vmProfile | 가상 머신이 이미지를 빌드하도록 설정되는 방법을 설명합니다. | ImageTemplateVmProfile |
ImageTemplateCustomizer
Name | Description | 값 |
---|---|---|
name | 이 사용자 지정 단계가 수행하는 작업을 컨텍스트를 제공하는 이름 | 문자열 |
type | 개체 형식 설정 | 최근에 사용한 파일 PowerShell 셸 WindowsRestart WindowsUpdate (필수) |
ImageTemplateFileCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | '파일'(필수) |
destination | sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)입니다. | string |
sha256Checksum | 위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬 | 문자열 |
sourceUri | VM을 사용자 지정하기 위해 업로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등일 수 있습니다. | string |
ImageTemplatePowerShellCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'PowerShell'(필수) |
inline | 실행할 PowerShell 명령의 배열 | string[] |
runAsSystem | 지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다. | bool |
runElevated | 지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다. | bool |
scriptUri | 사용자 지정을 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다. | string |
sha256Checksum | 위의 scriptUri 필드에 제공된 전원 셸 스크립트의 SHA256 체크섬 | 문자열 |
validExitCodes | PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] | int[] |
ImageTemplateShellCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'Shell'(필수) |
inline | 실행할 셸 명령의 배열 | string[] |
scriptUri | 사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다. | 문자열 |
sha256Checksum | scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬 | 문자열 |
ImageTemplateRestartCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'WindowsRestart'(필수) |
restartCheckCommand | 다시 시작에 성공하면 검사 명령 [기본값: ''] | string |
restartCommand | 다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"'] | 문자열 |
restartTimeout | 크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(2시간) [기본값: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'WindowsUpdate'(필수) |
filters | 적용할 업데이트를 선택할 필터의 배열입니다. 기본값(필터 없음)을 사용하도록 빈 배열을 생략하거나 지정합니다. 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요. | string[] |
searchCriteria | 업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요. | string |
updateLimit | 한 번에 적용할 최대 업데이트 수입니다. 기본값을 사용하려면 0을 생략하거나 지정합니다(1000). | int |
ImageTemplateDistributor
Name | Description | 값 |
---|---|---|
artifactTags | 배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에서 적용되는 태그입니다. | object |
runOutputName | 연결된 RunOutput에 사용할 이름입니다. | string(필수) |
형식 | 개체 유형 설정 | ManagedImage SharedImage VHD (필수) |
ImageTemplateManagedImageDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | 'ManagedImage'(필수) |
imageId | Managed Disk 이미지의 리소스 ID | string(필수) |
위치 | 이미지의 Azure 위치는 이미지가 이미 있는 경우 일치해야 합니다. | string(필수) |
ImageTemplateSharedImageDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | 'SharedImage'(필수) |
excludeFromLatest | 만든 이미지 버전을 최신 버전에서 제외할지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하려면 생략합니다. | bool |
galleryImageId | Shared Image Gallery 이미지의 리소스 ID | string(필수) |
replicationRegions | 이미지가 복제될 지역 목록 | string[] (필수) |
storageAccountType | 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | 'VHD'(필수) |
ImageTemplateSource
Name | Description | 값 |
---|---|---|
형식 | 개체 유형 설정 | ManagedImage PlatformImage SharedImageVersion (필수) |
ImageTemplateManagedImageSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'ManagedImage'(필수) |
imageId | 고객 구독에서 관리되는 이미지의 ARM 리소스 ID | string(필수) |
ImageTemplatePlatformImageSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'PlatformImage'(필수) |
제품 | Azure 갤러리 이미지의 이미지 제품입니다. | 문자열 |
planInfo | 플랫폼 이미지에 대한 구매 플랜의 선택적 구성입니다. | PlatformImagePurchasePlan |
publisher | Azure 갤러리 이미지의 이미지 게시자입니다. | string |
sku | Azure 갤러리 이미지의 이미지 sku입니다. | 문자열 |
버전 | Azure 갤러리 이미지의 이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿이 제출될 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다. | string |
PlatformImagePurchasePlan
Name | Description | 값 |
---|---|---|
planName | 구매 플랜의 이름입니다. | string(필수) |
planProduct | 구매 플랜의 제품입니다. | string(필수) |
planPublisher | 구매 플랜의 게시자입니다. | string(필수) |
ImageTemplateSharedImageVersionSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'SharedImageVersion'(필수) |
imageVersionId | 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID | string(필수) |
ImageTemplatePropertiesValidate
Name | Description | 값 |
---|---|---|
continueDistributeOnFailure | 유효성 검사에 실패하고 이 필드를 false로 설정하면 출력 이미지가 배포되지 않습니다. 기본 동작입니다. 유효성 검사에 실패하고 이 필드가 true로 설정된 경우 출력 이미지는 계속 배포됩니다. 이 옵션을 사용하면 잘못된 이미지가 배포될 수 있으므로 주의해서 사용하세요. 두 경우 모두(true 또는 false) 유효성 검사 실패 시 종단 간 이미지 실행이 실패한 것으로 보고됩니다. [참고: 유효성 검사에 성공하면 이 필드는 효과가 없습니다.] | bool |
inVMValidations | 수행할 유효성 검사 목록입니다. | ImageTemplateInVMValidator[] |
sourceValidationOnly | 이 필드를 true로 설정하면 'source' 섹션에 지정된 이미지의 유효성이 직접 검사됩니다. 사용자 지정 이미지를 생성한 다음, 유효성을 검사하기 위해 별도의 빌드가 실행되지 않습니다. | bool |
ImageTemplateInVMValidator
Name | Description | 값 |
---|---|---|
name | 이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 이름 | 문자열 |
type | 개체 유형 설정 | PowerShell 셸 (필수) |
ImageTemplatePowerShellValidator
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다. | 'PowerShell'(필수) |
inline | 실행할 PowerShell 명령의 배열 | string[] |
runAsSystem | 지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다. | bool |
runElevated | 지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다. | bool |
scriptUri | 유효성 검사를 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage URI 등이 될 수 있습니다. | 문자열 |
sha256Checksum | 위의 scriptUri 필드에 제공된 전원 셸 스크립트의 SHA256 체크섬 | 문자열 |
validExitCodes | PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] | int[] |
ImageTemplateShellValidator
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다. | 'Shell'(필수) |
inline | 실행할 셸 명령의 배열 | string[] |
scriptUri | 유효성 검사를 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage URI 등이 될 수 있습니다. | string |
sha256Checksum | scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬 | 문자열 |
ImageTemplateVmProfile
Name | Description | 값 |
---|---|---|
osDiskSizeGB | OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. | int |
userAssignedIdentities | 빌드 VM 및 유효성 검사 VM에서 구성할 사용자 할당 관리 ID의 리소스 ID의 선택적 배열입니다. 여기에는 이미지 템플릿의 ID가 포함될 수 있습니다. | string[] |
vmSize | 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). | string |
vnetConfig | 빌드 VM 및 유효성 검사 VM을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. | VirtualNetworkConfig |
VirtualNetworkConfig
Name | Description | 값 |
---|---|---|
proxyVmSize | 빌드 VM 및 유효성 검사 VM에 트래픽을 전달하는 데 사용되는 프록시 가상 머신의 크기입니다. 기본(Standard_A1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다. | string |
subnetId | 기존 서브넷의 리소스 ID입니다. | 문자열 |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
템플릿 | Description |
---|---|
Azure Windows 기준이 있는 Azure Image Builder |
Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다. |
Dev Box 서비스 구성 |
이 템플릿은 Dev Box 빠른 시작 가이드에 따라 모든 Dev Box 관리자 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다. |
Terraform(AzAPI 공급자) 리소스 정의
imageTemplates 리소스 종류는 다음으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.VirtualMachineImages/imageTemplates 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "UserAssigned"
identity_ids = []
}
body = jsonencode({
properties = {
buildTimeoutInMinutes = int
customize = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute = [
{
artifactTags = {}
runOutputName = "string"
type = "string"
// For remaining properties, see ImageTemplateDistributor objects
}
]
source = {
type = "string"
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup = "string"
validate = {
continueDistributeOnFailure = bool
inVMValidations = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly = bool
}
vmProfile = {
osDiskSizeGB = int
userAssignedIdentities = [
"string"
]
vmSize = "string"
vnetConfig = {
proxyVmSize = "string"
subnetId = "string"
}
}
}
})
}
ImageTemplateCustomizer 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
파일의 경우 다음을 사용합니다.
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
PowerShell의 경우 다음을 사용합니다.
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Shell의 경우 다음을 사용합니다.
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
WindowsRestart의 경우 다음을 사용합니다.
type = "WindowsRestart"
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
WindowsUpdate의 경우 다음을 사용합니다.
type = "WindowsUpdate"
filters = [
"string"
]
searchCriteria = "string"
updateLimit = int
ImageTemplateDistributor 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
ManagedImage의 경우 다음을 사용합니다.
type = "ManagedImage"
imageId = "string"
location = "string"
SharedImage의 경우 다음을 사용합니다.
type = "SharedImage"
excludeFromLatest = bool
galleryImageId = "string"
replicationRegions = [
"string"
]
storageAccountType = "string"
VHD의 경우 다음을 사용합니다.
type = "VHD"
ImageTemplateSource 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
ManagedImage의 경우 다음을 사용합니다.
type = "ManagedImage"
imageId = "string"
PlatformImage의 경우 다음을 사용합니다.
type = "PlatformImage"
offer = "string"
planInfo = {
planName = "string"
planProduct = "string"
planPublisher = "string"
}
publisher = "string"
sku = "string"
version = "string"
SharedImageVersion의 경우 다음을 사용합니다.
type = "SharedImageVersion"
imageVersionId = "string"
ImageTemplateInVMValidator 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
PowerShell의 경우 다음을 사용합니다.
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Shell의 경우 다음을 사용합니다.
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
속성 값
imageTemplates
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14" |
name | 리소스 이름 | string(필수) |
위치 | 리소스가 있는 지리적 위치 | string(필수) |
parent_id | 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. | string(필수) |
tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. |
identity | 구성된 경우 이미지 템플릿의 ID입니다. | ImageTemplateIdentity (필수) |
properties | 이미지 템플릿의 속성 | ImageTemplateProperties |
ImageTemplateIdentity
Name | Description | 값 |
---|---|---|
형식 | 이미지 템플릿에 사용되는 ID 유형입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다. | "UserAssigned" |
identity_ids | 이미지 템플릿과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. | 사용자 ID ID의 배열입니다. |
ImageTemplateProperties
Name | Description | 값 |
---|---|---|
buildTimeoutInMinutes | 이미지 템플릿을 빌드하는 동안 대기할 최대 기간입니다(모든 사용자 지정, 유효성 검사 및 배포 포함). 기본값(4시간)을 사용하도록 0을 생략하거나 지정합니다. | int |
사용자 지정 | 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. | ImageTemplateCustomizer[] |
배포(distribute) | 배포 대상은 이미지 출력을 이동해야 하는 위치입니다. | ImageTemplateDistributor[] (필수) |
source | 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. | ImageTemplateSource (필수) |
stagingResourceGroup | 이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 스테이징 리소스 그룹 ID입니다. 이 필드가 비어 있으면 임의 이름을 가진 리소스 그룹이 만들어집니다. 이 필드에 지정된 리소스 그룹이 없으면 동일한 이름으로 만들어집니다. 지정된 리소스 그룹이 있는 경우 비어 있어야 하며 이미지 템플릿과 동일한 지역에 있어야 합니다. 이 필드가 비어 있거나 지정된 리소스 그룹이 없는 경우 템플릿을 삭제하는 동안 만든 리소스 그룹이 삭제되지만 지정된 리소스 그룹이 있는 경우 템플릿을 삭제하는 동안 리소스 그룹에서 만든 리소스가 삭제되고 리소스 그룹 자체가 유지됩니다. | string |
validate | 결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다. | ImageTemplatePropertiesValidate |
vmProfile | 가상 머신이 이미지를 빌드하도록 설정되는 방법을 설명합니다. | ImageTemplateVmProfile |
ImageTemplateCustomizer
Name | Description | 값 |
---|---|---|
name | 이 사용자 지정 단계가 수행하는 작업을 컨텍스트를 제공하는 이름 | 문자열 |
type | 개체 형식 설정 | 최근에 사용한 파일 PowerShell 셸 WindowsRestart WindowsUpdate (필수) |
ImageTemplateFileCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | "파일"(필수) |
destination | sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)입니다. | 문자열 |
sha256Checksum | 위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬 | 문자열 |
sourceUri | VM을 사용자 지정하기 위해 업로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등일 수 있습니다. | string |
ImageTemplatePowerShellCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | "PowerShell"(필수) |
inline | 실행할 PowerShell 명령의 배열 | string[] |
runAsSystem | 지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다. | bool |
runElevated | 지정된 경우 PowerShell 스크립트는 관리자 권한으로 실행됩니다. | bool |
scriptUri | 사용자 지정을 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등일 수 있습니다. | 문자열 |
sha256Checksum | 위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬 | 문자열 |
validExitCodes | PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] | int[] |
ImageTemplateShellCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | "Shell"(필수) |
inline | 실행할 셸 명령의 배열 | string[] |
scriptUri | 사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등일 수 있습니다. | 문자열 |
sha256Checksum | scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬 | 문자열 |
ImageTemplateRestartCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | "WindowsRestart"(필수) |
restartCheckCommand | 다시 시작에 성공하면 검사 명령 [기본값: ''] | 문자열 |
restartCommand | 다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"'] | 문자열 |
restartTimeout | 크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(2시간) [기본값: '5m'] | 문자열 |
ImageTemplateWindowsUpdateCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | "WindowsUpdate"(필수) |
filters | 적용할 업데이트를 선택할 필터의 배열입니다. 기본값(필터 없음)을 사용하도록 빈 배열을 생략하거나 지정합니다. 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요. | string[] |
searchCriteria | 업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요. | string |
updateLimit | 한 번에 적용할 최대 업데이트 수입니다. 기본값을 사용하려면 0을 생략하거나 지정합니다(1000). | int |
ImageTemplateDistributor
Name | Description | 값 |
---|---|---|
artifactTags | 배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에서 적용되는 태그입니다. | object |
runOutputName | 연결된 RunOutput에 사용할 이름입니다. | string(필수) |
형식 | 개체 유형 설정 | ManagedImage SharedImage VHD (필수) |
ImageTemplateManagedImageDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | "ManagedImage"(필수) |
imageId | Managed Disk 이미지의 리소스 ID | string(필수) |
위치 | 이미지의 Azure 위치는 이미지가 이미 있는 경우 일치해야 합니다. | string(필수) |
ImageTemplateSharedImageDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | "SharedImage"(필수) |
excludeFromLatest | 만든 이미지 버전을 최신 버전에서 제외할지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하려면 생략합니다. | bool |
galleryImageId | Shared Image Gallery 이미지의 리소스 ID | string(필수) |
replicationRegions | 이미지가 복제될 지역 목록 | string[] (필수) |
storageAccountType | 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
Name | Description | 값 |
---|---|---|
형식 | 배포 유형입니다. | "VHD"(필수) |
ImageTemplateSource
Name | Description | 값 |
---|---|---|
형식 | 개체 유형 설정 | ManagedImage PlatformImage SharedImageVersion (필수) |
ImageTemplateManagedImageSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | "ManagedImage"(필수) |
imageId | 고객 구독에서 관리되는 이미지의 ARM 리소스 ID | string(필수) |
ImageTemplatePlatformImageSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | "PlatformImage"(필수) |
제품 | Azure 갤러리 이미지의 이미지 제품입니다. | 문자열 |
planInfo | 플랫폼 이미지에 대한 구매 플랜의 선택적 구성입니다. | PlatformImagePurchasePlan |
publisher | Azure 갤러리 이미지의 이미지 게시자입니다. | 문자열 |
sku | Azure 갤러리 이미지의 이미지 sku입니다. | string |
버전 | Azure 갤러리 이미지의 이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿이 제출될 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다. | string |
PlatformImagePurchasePlan
Name | Description | 값 |
---|---|---|
planName | 구매 플랜의 이름입니다. | string(필수) |
planProduct | 구매 플랜의 제품입니다. | string(필수) |
planPublisher | 구매 플랜의 게시자입니다. | string(필수) |
ImageTemplateSharedImageVersionSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | "SharedImageVersion"(필수) |
imageVersionId | 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID | string(필수) |
ImageTemplatePropertiesValidate
Name | Description | 값 |
---|---|---|
continueDistributeOnFailure | 유효성 검사에 실패하고 이 필드를 false로 설정하면 출력 이미지가 배포되지 않습니다. 기본 동작입니다. 유효성 검사에 실패하고 이 필드가 true로 설정된 경우 출력 이미지는 계속 배포됩니다. 이 옵션을 사용하면 잘못된 이미지가 배포될 수 있으므로 주의해서 사용하세요. 두 경우 모두(true 또는 false) 유효성 검사 실패 시 종단 간 이미지 실행이 실패한 것으로 보고됩니다. [참고: 유효성 검사에 성공하면 이 필드는 효과가 없습니다.] | bool |
inVMValidations | 수행할 유효성 검사 목록입니다. | ImageTemplateInVMValidator[] |
sourceValidationOnly | 이 필드를 true로 설정하면 'source' 섹션에 지정된 이미지의 유효성이 직접 검사됩니다. 사용자 지정 이미지를 생성한 다음, 유효성을 검사하기 위해 별도의 빌드가 실행되지 않습니다. | bool |
ImageTemplateInVMValidator
Name | Description | 값 |
---|---|---|
name | 이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 이름 | 문자열 |
type | 개체 유형 설정 | PowerShell 셸 (필수) |
ImageTemplatePowerShellValidator
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다. | "PowerShell"(필수) |
inline | 실행할 PowerShell 명령의 배열 | string[] |
runAsSystem | 지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다. | bool |
runElevated | 지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다. | bool |
scriptUri | 유효성 검사를 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage URI 등이 될 수 있습니다. | string |
sha256Checksum | 위의 scriptUri 필드에 제공된 전원 셸 스크립트의 SHA256 체크섬 | 문자열 |
validExitCodes | PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] | int[] |
ImageTemplateShellValidator
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다. | "Shell"(필수) |
inline | 실행할 셸 명령의 배열 | string[] |
scriptUri | 유효성 검사를 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage URI 등이 될 수 있습니다. | 문자열 |
sha256Checksum | scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬 | 문자열 |
ImageTemplateVmProfile
Name | Description | 값 |
---|---|---|
osDiskSizeGB | OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. | int |
userAssignedIdentities | 빌드 VM 및 유효성 검사 VM에서 구성할 사용자 할당 관리 ID의 리소스 ID의 선택적 배열입니다. 여기에는 이미지 템플릿의 ID가 포함될 수 있습니다. | string[] |
vmSize | 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). | string |
vnetConfig | 빌드 VM 및 유효성 검사 VM을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. | VirtualNetworkConfig |
VirtualNetworkConfig
Name | Description | 값 |
---|---|---|
proxyVmSize | 빌드 VM 및 유효성 검사 VM에 트래픽을 전달하는 데 사용되는 프록시 가상 머신의 크기입니다. 기본값(Standard_A1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다. | 문자열 |
subnetId | 기존 서브넷의 리소스 ID입니다. | string |