Microsoft.VirtualMachineImages imageTemplates 2020-02-14
Bicep 리소스 정의
imageTemplates 리소스 종류는 다음으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.VirtualMachineImages/imageTemplates 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2020-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
}
vmProfile: {
osDiskSizeGB: int
vmSize: 'string'
vnetConfig: {
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'
속성 값
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 (필수) |
vmProfile | 가상 머신이 이미지를 빌드하도록 설정되는 방법을 설명합니다. | ImageTemplateVmProfile |
ImageTemplateCustomizer
Name | Description | 값 |
---|---|---|
name | 이 사용자 지정 단계가 수행하는 작업을 컨텍스트를 제공하는 이름 | 문자열 |
type | 개체 형식 설정 | 최근에 사용한 파일 PowerShell 셸 WindowsRestart WindowsUpdate (필수) |
ImageTemplateFileCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'File'(필수) |
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 등이 될 수 있습니다. | 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 | 다시 시작에 성공하면 검사 명령 [기본값: ''] | 문자열 |
restartCommand | 다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"'] | 문자열 |
restartTimeout | 크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(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 갤러리 이미지의 이미지 제품입니다. | string |
planInfo | 플랫폼 이미지에 대한 구매 플랜의 선택적 구성입니다. | PlatformImagePurchasePlan |
publisher | Azure 갤러리 이미지의 이미지 게시자입니다. | string |
sku | Azure 갤러리 이미지의 이미지 sku입니다. | 문자열 |
버전 | Azure 갤러리 이미지의 이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿을 제출할 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다. '최신'을 지정하면 ROUNDTRIP_INCONSISTENT_PROPERTY 문제가 해결될 수 있습니다. | 문자열 |
PlatformImagePurchasePlan
Name | Description | 값 |
---|---|---|
planName | 구매 플랜의 이름입니다. | string(필수) |
planProduct | 구매 플랜의 제품입니다. | string(필수) |
planPublisher | 구매 플랜의 게시자입니다. | string(필수) |
ImageTemplateSharedImageVersionSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'SharedImageVersion'(필수) |
imageVersionId | 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID | string(필수) |
ImageTemplateVmProfile
Name | Description | 값 |
---|---|---|
osDiskSizeGB | OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. | int |
vmSize | 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). | string |
vnetConfig | 빌드 가상 머신을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. | VirtualNetworkConfig |
VirtualNetworkConfig
Name | Description | 값 |
---|---|---|
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": "2020-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
},
"vmProfile": {
"osDiskSizeGB": "int",
"vmSize": "string",
"vnetConfig": {
"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"
속성 값
imageTemplates
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | 'Microsoft.VirtualMachineImages/imageTemplates' |
apiVersion | 리소스 api 버전 | '2020-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 (필수) |
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 등일 수 있습니다. | 문자열 |
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 체크섬 | string |
validExitCodes | PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] | int[] |
ImageTemplateShellCustomizer
Name | Description | 값 |
---|---|---|
형식 | 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. | 'Shell'(필수) |
inline | 실행할 셸 명령의 배열 | string[] |
scriptUri | 사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다. | string |
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입니다. | 문자열 |
버전 | Azure 갤러리 이미지의 이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿을 제출할 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다. '최신'을 지정하면 ROUNDTRIP_INCONSISTENT_PROPERTY 문제가 해결될 수 있습니다. | 문자열 |
PlatformImagePurchasePlan
Name | Description | 값 |
---|---|---|
planName | 구매 플랜의 이름입니다. | string(필수) |
planProduct | 구매 플랜의 제품입니다. | string(필수) |
planPublisher | 구매 플랜의 게시자입니다. | string(필수) |
ImageTemplateSharedImageVersionSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | 'SharedImageVersion'(필수) |
imageVersionId | 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID | string(필수) |
ImageTemplateVmProfile
Name | Description | 값 |
---|---|---|
osDiskSizeGB | OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. | int |
vmSize | 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). | string |
vnetConfig | 빌드 가상 머신을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. | VirtualNetworkConfig |
VirtualNetworkConfig
Name | Description | 값 |
---|---|---|
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@2020-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
}
vmProfile = {
osDiskSizeGB = int
vmSize = "string"
vnetConfig = {
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"
속성 값
imageTemplates
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | "Microsoft.VirtualMachineImages/imageTemplates@2020-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 (필수) |
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 갤러리 이미지의 이미지 게시자입니다. | 문자열 |
sku | Azure 갤러리 이미지의 이미지 sku입니다. | 문자열 |
버전 | Azure 갤러리 이미지의 이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿을 제출할 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다. '최신'을 지정하면 ROUNDTRIP_INCONSISTENT_PROPERTY 문제가 해결될 수 있습니다. | 문자열 |
PlatformImagePurchasePlan
Name | Description | 값 |
---|---|---|
planName | 구매 플랜의 이름입니다. | string(필수) |
planProduct | 구매 플랜의 제품입니다. | string(필수) |
planPublisher | 구매 플랜의 게시자입니다. | string(필수) |
ImageTemplateSharedImageVersionSource
Name | Description | 값 |
---|---|---|
형식 | 시작하려는 원본 이미지의 형식을 지정합니다. | "SharedImageVersion"(필수) |
imageVersionId | 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID | string(필수) |
ImageTemplateVmProfile
Name | Description | 값 |
---|---|---|
osDiskSizeGB | OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. | int |
vmSize | 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). | string |
vnetConfig | 빌드 가상 머신을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. | VirtualNetworkConfig |
VirtualNetworkConfig
Name | Description | 값 |
---|---|---|
subnetId | 기존 서브넷의 리소스 ID입니다. | string |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기