Microsoft.VirtualMachineImages imageTemplates
Bicep-erőforrásdefiníció
Az imageTemplates erőforrástípus üzembe helyezhető a következőre:
- Erőforráscsoportok – Lásd : erőforráscsoport üzembehelyezési parancsai
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban találja.
Erőforrás formátuma
Microsoft.VirtualMachineImages/imageTemplates erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.
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-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
Fájl esetén használja a következőt:
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
PowerShell esetén használja a következőt:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
A Shell esetében használja a következőt:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
WindowsRestart esetén használja a következőt:
type: 'WindowsRestart'
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
WindowsUpdate esetén használja a következőt:
type: 'WindowsUpdate'
filters: [
'string'
]
searchCriteria: 'string'
updateLimit: int
ImageTemplateDistributor-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
A ManagedImage esetében használja a következőt:
type: 'ManagedImage'
imageId: 'string'
location: 'string'
A SharedImage esetében használja a következőt:
type: 'SharedImage'
excludeFromLatest: bool
galleryImageId: 'string'
replicationRegions: [
'string'
]
storageAccountType: 'string'
VHD esetén használja a következőt:
type: 'VHD'
ImageTemplateSource-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
A ManagedImage esetében használja a következőt:
type: 'ManagedImage'
imageId: 'string'
A PlatformImage esetében használja a következőt:
type: 'PlatformImage'
offer: 'string'
planInfo: {
planName: 'string'
planProduct: 'string'
planPublisher: 'string'
}
publisher: 'string'
sku: 'string'
version: 'string'
SharedImageVersion esetén használja a következőt:
type: 'SharedImageVersion'
imageVersionId: 'string'
ImageTemplateInVMValidator objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
PowerShell esetén használja a következőt:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
A Shell esetében használja a következőt:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Tulajdonságértékek
imageTemplates
Név | Leírás | Érték |
---|---|---|
name | Az erőforrás neve | sztring (kötelező) |
location | Az a földrajzi hely, ahol az erőforrás él | sztring (kötelező) |
tags | Erőforráscímkék. | Címkenevek és -értékek szótára. Címkék megtekintése sablonokban |
identity | A képsablon identitása, ha konfigurálva van. | ImageTemplateIdentity (kötelező) |
properties | A képsablon tulajdonságai | ImageTemplateProperties |
ImageTemplateIdentity
Név | Leírás | Érték |
---|---|---|
típus | A képsablonhoz használt identitás típusa. A "Nincs" típus eltávolítja az identitásokat a képsablonból. | "Nincs" "UserAssigned" |
userAssignedIdentities | A képsablonhoz társított felhasználói identitások listája. A felhasználói identitás szótárának kulcshivatkozásai a következő űrlapon található ARM-erőforrás-azonosítók: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | object |
ImageTemplateProperties
Név | Leírás | Érték |
---|---|---|
buildTimeoutInMinutes | A képsablon létrehozása során a várakozás maximális időtartama (beleértve az összes testreszabást, ellenőrzést és disztribúciót). Kihagyhatja vagy megadhatja a 0 értéket az alapértelmezett (4 óra) használatához. | int |
Testreszabása | Meghatározza a kép testreszabási lépéseinek leírására használt tulajdonságokat, például a képforrást stb. | ImageTemplateCustomizer[] |
Terjeszteni | A terjesztési célok, amelyekre a képkimenetnek mennie kell. | ImageTemplateDistributor[] (kötelező) |
source | Megadja a forráskép leírásához használt tulajdonságokat. | ImageTemplateSource (kötelező) |
stagingResourceGroup | Az előkészítési erőforráscsoport azonosítója ugyanabban az előfizetésben, mint a rendszerképsablon, amelyet a rendszerkép létrehozásához használnak. Ha ez a mező üres, a rendszer létrehoz egy véletlenszerű nevű erőforráscsoportot. Ha az ebben a mezőben megadott erőforráscsoport nem létezik, ugyanazzal a névvel jön létre. Ha a megadott erőforráscsoport létezik, annak üresnek kell lennie, és ugyanabban a régióban kell lennie, mint a képsablon. A létrehozott erőforráscsoport törlődik a sablon törlésekor, ha ez a mező üres, vagy a megadott erőforráscsoport nem létezik, de ha a megadott erőforráscsoport létezik, az erőforráscsoportban létrehozott erőforrások törlődnek a sablon törlésekor, és maga az erőforráscsoport is megmarad. | sztring |
érvényesítés | Konfigurációs beállítások és az eredményként kapott lemezképen végrehajtandó érvényesítések listája. | ImageTemplatePropertiesValidate |
vmProfile | A virtuális gép rendszerképek készítésére való beállítását ismerteti | ImageTemplateVmProfile |
ImageTemplateCustomizer
Név | Leírás | Érték |
---|---|---|
name | Rövid név a testreszabási lépéssel kapcsolatos kontextus megadásához | sztring |
típus | Az objektum típusának beállítása | Fájl PowerShell Felület WindowsRestart WindowsUpdate (kötelező) |
ImageTemplateFileCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "Fájl" (kötelező) |
destination | A fájl abszolút elérési útja (már létrehozott beágyazott könyvtárstruktúrákkal) ahol a fájl (sourceUri-ból) fel lesz töltve a virtuális gépre | sztring |
sha256Checksum | A fenti sourceUri mezőben megadott fájl SHA256-ellenőrzőösszege | sztring |
sourceUri | A virtuális gép testreszabásához feltöltendő fájl URI-ja. Ez lehet egy GitHub-hivatkozás, sas URI az Azure Storage-hoz stb. | sztring |
ImageTemplatePowerShellCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "PowerShell" (kötelező) |
inline | Végrehajtandó PowerShell-parancsok tömbje | sztring[] |
runAsSystem | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni a helyi rendszer felhasználójának használatával. Csak akkor lehet igaz, ha a fenti runElevated mező igaz értékre van állítva. | logikai |
runElevated | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni | logikai |
scriptUri | A testreszabáshoz futtatandó PowerShell-szkript URI-ja. Ez lehet egy GitHub-hivatkozás, sas URI az Azure Storage-hoz stb. | sztring |
sha256Checksum | A fenti scriptUri mezőben megadott Power Shell-szkript SHA256-ellenőrzőösszege | sztring |
validExitCodes | Érvényes kilépési kódok a PowerShell-szkripthez. [Alapértelmezett: 0] | int[] |
ImageTemplateShellCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "Shell" (kötelező) |
inline | Végrehajtandó rendszerhéjparancsok tömbje | sztring[] |
scriptUri | A testreszabáshoz futtatandó rendszerhéjszkript URI-ja. Ez lehet egy GitHub-hivatkozás, sas URI az Azure Storage-hoz stb. | sztring |
sha256Checksum | A scriptUri mezőben megadott rendszerhéjszkript SHA256-ellenőrzőösszege | sztring |
ImageTemplateRestartCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "WindowsRestart" (kötelező) |
restartCheckCommand | Parancs annak ellenőrzéséhez, hogy az újraindítás sikeres volt-e [Alapértelmezett: "] | sztring |
restartCommand | Parancs az újraindítás végrehajtásához [Alapértelmezett: 'shutdown /r /f /t 0 /c "packer restart"] | sztring |
restartTimeout | Újraindítási időtúllépés nagyságrendi és egységsztringként megadva, például "5 perc" (5 perc) vagy "2 óra" (2 óra) [Alapértelmezett: '5m] | sztring |
ImageTemplateWindowsUpdateCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "WindowsUpdate" (kötelező) |
szűrők | Szűrők tömbje az alkalmazni kívánt frissítések kiválasztásához. Hagyja ki vagy adja meg az üres tömböt az alapértelmezett (nincs szűrő) beállításhoz. Példákért és a mező részletes leírásáért tekintse meg a fenti hivatkozást. | sztring[] |
searchCriteria | A frissítések keresésének feltételei. Hagyja ki vagy adja meg az üres sztringet az alapértelmezett (keresés az összesben) használatához. Példákért és a mező részletes leírásáért tekintse meg a fenti hivatkozást. | sztring |
updateLimit | Egyszerre alkalmazható frissítések maximális száma. Kihagyás vagy 0 megadása az alapértelmezett (1000) használatához | int |
ImageTemplateDistributor
Név | Leírás | Érték |
---|---|---|
artifactTags | Az összetevőre a terjesztő által létrehozott/frissített címkék lesznek alkalmazva. | object |
runOutputName | A társított RunOutputhoz használandó név. | sztring (kötelező) |
típus | Az objektum típusának beállítása | ManagedImage SharedImage VHD (kötelező) |
ImageTemplateManagedImageDistributor
Név | Leírás | Érték |
---|---|---|
típus | Az eloszlás típusa. | "ManagedImage" (kötelező) |
imageId | A felügyelt lemezkép erőforrás-azonosítója | sztring (kötelező) |
location | A rendszerkép Azure-helyének egyeznie kell, ha a rendszerkép már létezik | sztring (kötelező) |
ImageTemplateSharedImageDistributor
Név | Leírás | Érték |
---|---|---|
típus | Az eloszlás típusa. | "SharedImage" (kötelező) |
excludeFromLatest | Jelző, amely azt jelzi, hogy a létrehozott rendszerképverziót ki kell-e zárni a legújabb verzióból. Kihagyás az alapértelmezett (hamis) beállítás használatához. | logikai |
galleryImageId | A Shared Image Gallery rendszerkép erőforrás-azonosítója | sztring (kötelező) |
replicationRegions | Azon régiók listája, amelyekbe a rendszerképet replikálni fogja | string[] (kötelező) |
storageAccountType | A megosztott lemezkép tárolásához használandó tárfiók típusa. Kihagyja az alapértelmezett (Standard_LRS) használatát. | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
Név | Leírás | Érték |
---|---|---|
típus | Az eloszlás típusa. | "VHD" (kötelező) |
ImageTemplateSource
Név | Leírás | Érték |
---|---|---|
típus | Az objektum típusának beállítása | ManagedImage PlatformImage SharedImageVersion (kötelező) |
ImageTemplateManagedImageSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja a forráskép típusát, amellyel kezdeni szeretné. | "ManagedImage" (kötelező) |
imageId | A felügyelt rendszerkép ARM-erőforrás-azonosítója az ügyfél-előfizetésben | sztring (kötelező) |
ImageTemplatePlatformImageSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja, hogy milyen típusú forrásképpel szeretne kezdeni. | "PlatformImage" (kötelező) |
offer | Képajánlat az Azure Gallery Images szolgáltatásból. | sztring |
planInfo | A platformrendszerképhez tartozó vásárlási csomag opcionális konfigurációja. | PlatformImagePurchasePlan |
közzétevő | Image Publisher az Azure Gallery Imagesben. | sztring |
Sku | Képváltozat az Azure Gallery-rendszerképekből. | sztring |
version | Az Azure Gallery-rendszerképek képverziója. Ha itt a "legújabb" érték van megadva, a rendszer a rendszer a rendszerkép összeállításakor értékeli ki a verziót, nem pedig a sablon elküldésekor. | sztring |
PlatformImagePurchasePlan
Név | Leírás | Érték |
---|---|---|
planName | A vásárlási csomag neve. | sztring (kötelező) |
planProduct | A vásárlási csomag terméke. | sztring (kötelező) |
planPublisher | A vásárlási csomag közzétevője. | sztring (kötelező) |
ImageTemplateSharedImageVersionSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja, hogy milyen típusú forrásképpel szeretne kezdeni. | "SharedImageVersion" (kötelező) |
imageVersionId | A megosztott képkatalógus képverziójának ARM-erőforrás-azonosítója | sztring (kötelező) |
ImageTemplatePropertiesValidate
Név | Leírás | Érték |
---|---|---|
continueDistributeOnFailure | Ha az ellenőrzés sikertelen, és ez a mező hamis értékre van állítva, a kimeneti kép(ek) nem lesznek elosztva. Ez az alapértelmezett viselkedés. Ha az ellenőrzés sikertelen, és ez a mező igaz értékre van állítva, a kimeneti kép(ek) továbbra is el lesznek terjesztve. Óvatosan használja ezt a beállítást, mert az hibás képek terjesztését eredményezheti. Mindkét esetben (igaz vagy hamis) a rendszer a teljes képfuttatást sikertelennek fogja jelenteni érvényesítési hiba esetén. [Megjegyzés: Ennek a mezőnek nincs hatása, ha az ellenőrzés sikeres.] | logikai |
inVMValidations | A végrehajtandó érvényesítések listája. | ImageTemplateInVMValidator[] |
sourceValidationOnly | Ha ez a mező igaz értékre van állítva, a rendszer közvetlenül érvényesíti a "forrás" szakaszban megadott képet. A rendszer nem futtat külön buildet a testreszabott rendszerkép létrehozásához és érvényesítéséhez. | logikai |
ImageTemplateInVMValidator
Név | Leírás | Érték |
---|---|---|
name | Rövid név, amely kontextust biztosít az érvényesítési lépéssel kapcsolatban | sztring |
típus | Az objektumtípus beállítása | PowerShell Shell (kötelező) |
ImageTemplatePowerShellValidator
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt ellenőrzés típusa. A "Shell" lehet például a rendszerhéj ellenőrzése | "PowerShell" (kötelező) |
inline | Végrehajtandó PowerShell-parancsok tömbje | sztring[] |
runAsSystem | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni a helyi rendszer felhasználójával. Csak akkor lehet igaz, ha a fenti RunElevated mező igaz értékre van állítva. | logikai |
runElevated | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni | logikai |
scriptUri | Az ellenőrzéshez futtatandó PowerShell-szkript URI-ja. Ez lehet github-hivatkozás, Azure Storage URI stb. | sztring |
sha256Checksum | A fenti scriptUri mezőben megadott Power Shell-szkript SHA256-ellenőrzőösszege | sztring |
validExitCodes | Érvényes kilépési kódok a PowerShell-szkripthez. [Alapértelmezett: 0] | int[] |
ImageTemplateShellValidator
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt ellenőrzés típusa. A "Shell" lehet például a rendszerhéj ellenőrzése | "Shell" (kötelező) |
inline | A végrehajtandó rendszerhéj-parancsok tömbje | sztring[] |
scriptUri | Az ellenőrzéshez futtatandó rendszerhéj-szkript URI-ja. Ez lehet github-hivatkozás, Azure Storage URI stb. | sztring |
sha256Checksum | A scriptUri mezőben megadott rendszerhéjszkript SHA256-ellenőrzőösszege | sztring |
ImageTemplateVmProfile
Név | Leírás | Érték |
---|---|---|
osDiskSizeGB | Az operációsrendszer-lemez mérete GB-ban. Kihagyhatja vagy megadhatja a 0 értéket az Azure alapértelmezett operációsrendszer-lemezméretének használatához. | int |
userAssignedIdentities | A felhasználó által hozzárendelt felügyelt identitások erőforrás-azonosítóinak opcionális tömbje, amely konfigurálható a virtuális gép összeállítása és az érvényesítési virtuális gépen. Ez magában foglalhatja a képsablon identitását is. | sztring[] |
vmSize | A képek készítéséhez, testreszabásához és rögzítéséhez használt virtuális gép mérete. Kihagyhatja vagy megadhatja az alapértelmezett sztringet (gen1-rendszerképek esetén Standard_D1_v2, Gen2-rendszerképek esetén pedig Standard_D2ds_v4). | sztring |
vnetConfig | A virtuális hálózat opcionális konfigurációja a virtuális gép buildjének és érvényesítési virtuális gépének üzembe helyezéséhez. Kihagyhatja, ha nincs szükség konkrét virtuális hálózatra. | VirtualNetworkConfig |
VirtualNetworkConfig
Név | Leírás | Érték |
---|---|---|
proxyVmSize | Annak a proxy virtuális gépnek a mérete, amely a buildelési virtuális gép és az érvényesítési virtuális gép felé történő adatforgalom továbbítására szolgál. Üres sztring kihagyása vagy megadása az alapértelmezett (Standard_A1_v2) használatához. | sztring |
alhálózati azonosító | Egy meglévő alhálózat erőforrás-azonosítója. | sztring |
Gyorssablonok
Az alábbi rövid útmutatósablonok ezt az erőforrástípust helyezik üzembe.
Sablon | Description |
---|---|
Azure Image Builder az Azure Windows alapkonfigurációjával |
Létrehoz egy Azure Image Builder-környezetet, és létrehoz egy Windows Server-rendszerképet a legújabb Windows Frissítések és az Azure Windows Alapterv alkalmazásával. |
A Dev Box szolgáltatás konfigurálása |
Ez a sablon minden Dev Box-rendszergazdai erőforrást létrehozna a Dev Box gyors üzembe helyezési útmutatójának megfelelően. Megtekintheti az összes létrehozott erőforrást, vagy közvetlenül a DevPortal.microsoft.com az első Dev Box létrehozásához. |
ARM-sablon erőforrásdefiníciója
Az imageTemplates erőforrástípus üzembe helyezhető a következőre:
- Erőforráscsoportok – Lásd : erőforráscsoport üzembehelyezési parancsai
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban találja.
Erőforrás formátuma
Microsoft.VirtualMachineImages/imageTemplates erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.
{
"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-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
Fájl esetén használja a következőt:
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
PowerShell esetén használja a következőt:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
A Shell esetében használja a következőt:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
WindowsRestart esetén használja a következőt:
"type": "WindowsRestart",
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string"
WindowsUpdate esetén használja a következőt:
"type": "WindowsUpdate",
"filters": [ "string" ],
"searchCriteria": "string",
"updateLimit": "int"
ImageTemplateDistributor-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
A ManagedImage esetében használja a következőt:
"type": "ManagedImage",
"imageId": "string",
"location": "string"
A SharedImage esetében használja a következőt:
"type": "SharedImage",
"excludeFromLatest": "bool",
"galleryImageId": "string",
"replicationRegions": [ "string" ],
"storageAccountType": "string"
VHD esetén használja a következőt:
"type": "VHD"
ImageTemplateSource-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
A ManagedImage esetében használja a következőt:
"type": "ManagedImage",
"imageId": "string"
A PlatformImage esetében használja a következőt:
"type": "PlatformImage",
"offer": "string",
"planInfo": {
"planName": "string",
"planProduct": "string",
"planPublisher": "string"
},
"publisher": "string",
"sku": "string",
"version": "string"
SharedImageVersion esetén használja a következőt:
"type": "SharedImageVersion",
"imageVersionId": "string"
ImageTemplateInVMValidator objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
PowerShell esetén használja a következőt:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
A Shell esetében használja a következőt:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Tulajdonságértékek
imageTemplates
Név | Leírás | Érték |
---|---|---|
típus | Az erőforrás típusa | "Microsoft.VirtualMachineImages/imageTemplates" |
apiVersion | Az erőforrás API-verziója | '2022-02-14' |
name | Az erőforrás neve | sztring (kötelező) |
location | A földrajzi hely, ahol az erőforrás él | sztring (kötelező) |
tags | Erőforráscímkék. | Címkenevek és -értékek szótára. Címkék megtekintése sablonokban |
identity | A képsablon identitása, ha konfigurálva van. | ImageTemplateIdentity (kötelező) |
properties | A képsablon tulajdonságai | ImageTemplateProperties |
ImageTemplateIdentity
Név | Leírás | Érték |
---|---|---|
típus | A képsablonhoz használt identitás típusa. A "Nincs" típus eltávolítja az identitásokat a képsablonból. | "Nincs" "UserAssigned" |
userAssignedIdentities | A rendszerképsablonhoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai ARM-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | object |
ImageTemplateProperties
Név | Leírás | Érték |
---|---|---|
buildTimeoutInMinutes | A képsablon létrehozása során a várakozás maximális időtartama (beleértve az összes testreszabást, érvényesítést és disztribúciót). Hagyja ki vagy adja meg a 0 értéket az alapértelmezett (4 óra) használatához. | int |
Testreszabása | Megadja a kép testreszabási lépéseinek leírásához használt tulajdonságokat, például a képforrást stb. | ImageTemplateCustomizer[] |
Terjeszteni | Az a terjesztési cél, amelyre a rendszerkép kimenetének el kell mennie. | ImageTemplateDistributor[] (kötelező) |
source | Megadja a forráskép leírásához használt tulajdonságokat. | ImageTemplateSource (kötelező) |
stagingResourceGroup | Az átmeneti erőforráscsoport azonosítója ugyanabban az előfizetésben, mint a rendszerképsablon, amelyet a rendszerkép létrehozásához használni fog. Ha ez a mező üres, egy véletlenszerű névvel rendelkező erőforráscsoport jön létre. Ha a mezőben megadott erőforráscsoport nem létezik, ugyanazzal a névvel jön létre. Ha a megadott erőforráscsoport létezik, üresnek kell lennie, és ugyanabban a régióban kell lennie, mint a rendszerképsablonnak. A létrehozott erőforráscsoport törlődik a sablon törlésekor, ha ez a mező üres, vagy a megadott erőforráscsoport nem létezik, de ha a megadott erőforráscsoport létezik, az erőforráscsoportban létrehozott erőforrások törlődnek a sablon törlésekor, és maga az erőforráscsoport is megmarad. | sztring |
érvényesítés | Az eredményként kapott lemezképen végrehajtandó konfigurációs beállítások és érvényesítések listája. | ImageTemplatePropertiesValidate |
vmProfile | A virtuális gép rendszerképek készítésére való beállítását ismerteti | ImageTemplateVmProfile |
ImageTemplateCustomizer
Név | Leírás | Érték |
---|---|---|
name | Rövid név a testreszabási lépéssel kapcsolatos kontextus megadásához | sztring |
típus | Az objektum típusának beállítása | Fájl PowerShell Felület WindowsRestart WindowsUpdate (kötelező) |
ImageTemplateFileCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "Fájl" (kötelező) |
destination | A fájl abszolút elérési útja (már létrehozott beágyazott könyvtárstruktúrákkal) ahol a fájl (sourceUri-ból) fel lesz töltve a virtuális gépre | sztring |
sha256Checksum | A fenti sourceUri mezőben megadott fájl SHA256-ellenőrzőösszege | sztring |
sourceUri | A virtuális gép testreszabásához feltöltendő fájl URI-ja. Ez lehet egy GitHub-hivatkozás, sas URI az Azure Storage-hoz stb. | sztring |
ImageTemplatePowerShellCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "PowerShell" (kötelező) |
inline | Végrehajtandó PowerShell-parancsok tömbje | sztring[] |
runAsSystem | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni a helyi rendszer felhasználójának használatával. Csak akkor lehet igaz, ha a fenti runElevated mező igaz értékre van állítva. | logikai |
runElevated | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni | logikai |
scriptUri | A testreszabáshoz futtatandó PowerShell-szkript URI-ja. Ez lehet egy GitHub-hivatkozás, sas URI az Azure Storage-hoz stb. | sztring |
sha256Checksum | A fenti scriptUri mezőben megadott Power Shell-szkript SHA256-ellenőrzőösszege | sztring |
validExitCodes | Érvényes kilépési kódok a PowerShell-szkripthez. [Alapértelmezett: 0] | int[] |
ImageTemplateShellCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "Shell" (kötelező) |
inline | Végrehajtandó rendszerhéjparancsok tömbje | sztring[] |
scriptUri | A testreszabáshoz futtatandó rendszerhéjszkript URI-ja. Ez lehet egy GitHub-hivatkozás, sas URI az Azure Storage-hoz stb. | sztring |
sha256Checksum | A scriptUri mezőben megadott rendszerhéjszkript SHA256-ellenőrzőösszege | sztring |
ImageTemplateRestartCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "WindowsRestart" (kötelező) |
restartCheckCommand | Parancs annak ellenőrzéséhez, hogy az újraindítás sikeres volt-e [Alapértelmezett: "] | sztring |
restartCommand | Parancs az újraindítás végrehajtásához [Alapértelmezett: 'shutdown /r /f /t 0 /c "packer restart"] | sztring |
restartTimeout | Újraindítási időtúllépés nagyságrendi és egységsztringként megadva, például "5 perc" (5 perc) vagy "2 óra" (2 óra) [Alapértelmezett: '5m] | sztring |
ImageTemplateWindowsUpdateCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képhez használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "WindowsUpdate" (kötelező) |
szűrők | Szűrők tömbje az alkalmazni kívánt frissítések kiválasztásához. Hagyja ki vagy adja meg az üres tömböt az alapértelmezett (nincs szűrő) beállításhoz. Példákért és a mező részletes leírásáért tekintse meg a fenti hivatkozást. | sztring[] |
searchCriteria | A frissítések keresésének feltételei. Hagyja ki vagy adja meg az üres sztringet az alapértelmezett (keresés az összesben) használatához. Példákért és a mező részletes leírásáért tekintse meg a fenti hivatkozást. | sztring |
updateLimit | Egyszerre alkalmazható frissítések maximális száma. Kihagyás vagy 0 megadása az alapértelmezett (1000) használatához | int |
ImageTemplateDistributor
Név | Leírás | Érték |
---|---|---|
artifactTags | Az összetevőre a terjesztő által létrehozott/frissített címkék lesznek alkalmazva. | object |
runOutputName | A társított RunOutputhoz használandó név. | sztring (kötelező) |
típus | Az objektum típusának beállítása | ManagedImage SharedImage VHD (kötelező) |
ImageTemplateManagedImageDistributor
Név | Leírás | Érték |
---|---|---|
típus | Az eloszlás típusa. | "ManagedImage" (kötelező) |
imageId | A felügyelt lemezkép erőforrás-azonosítója | sztring (kötelező) |
location | A rendszerkép Azure-helyének meg kell egyeznie, ha a rendszerkép már létezik | sztring (kötelező) |
ImageTemplateSharedImageDistributor
Név | Leírás | Érték |
---|---|---|
típus | A terjesztés típusa. | "SharedImage" (kötelező) |
excludeFromLatest | Jelző, amely azt jelzi, hogy a létrehozott rendszerkép-verziót ki kell-e zárni a legújabb verzióból. Kihagyás az alapértelmezett (hamis) beállítás használatához. | logikai |
galleryImageId | A Shared Image Gallery rendszerkép erőforrás-azonosítója | sztring (kötelező) |
replicationRegions | Azoknak a régióknak a listája, amelyekbe a rendszerképet replikálni fogja | sztring[] (kötelező) |
storageAccountType | A megosztott lemezkép tárolásához használandó tárfiók típusa. Kihagyás az alapértelmezett (Standard_LRS) használatához. | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
Név | Leírás | Érték |
---|---|---|
típus | A terjesztés típusa. | "VHD" (kötelező) |
ImageTemplateSource
Név | Leírás | Érték |
---|---|---|
típus | Az objektumtípus beállítása | ManagedImage PlatformImage SharedImageVersion (kötelező) |
ImageTemplateManagedImageSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja, hogy milyen típusú forrásképpel szeretne kezdeni. | "ManagedImage" (kötelező) |
imageId | A felügyelt lemezkép ARM-erőforrás-azonosítója az ügyfél-előfizetésben | sztring (kötelező) |
ImageTemplatePlatformImageSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja, hogy milyen típusú forrásképpel szeretne kezdeni. | "PlatformImage" (kötelező) |
offer | Képajánlat az Azure Gallery Images szolgáltatásból. | sztring |
planInfo | A platformrendszerképhez tartozó vásárlási csomag opcionális konfigurációja. | PlatformImagePurchasePlan |
közzétevő | Image Publisher az Azure Gallery Imagesben. | sztring |
Sku | Képváltozat az Azure Gallery-rendszerképekből. | sztring |
version | Az Azure Gallery-rendszerképek képverziója. Ha itt a "legújabb" érték van megadva, a rendszer a rendszer a rendszerkép összeállításakor értékeli ki a verziót, nem pedig a sablon elküldésekor. | sztring |
PlatformImagePurchasePlan
Név | Leírás | Érték |
---|---|---|
planName | A vásárlási csomag neve. | sztring (kötelező) |
planProduct | A vásárlási csomag terméke. | sztring (kötelező) |
planPublisher | A vásárlási csomag közzétevője. | sztring (kötelező) |
ImageTemplateSharedImageVersionSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja, hogy milyen típusú forrásképpel szeretne kezdeni. | "SharedImageVersion" (kötelező) |
imageVersionId | A megosztott képkatalógus képverziójának ARM-erőforrás-azonosítója | sztring (kötelező) |
ImageTemplatePropertiesValidate
Név | Leírás | Érték |
---|---|---|
continueDistributeOnFailure | Ha az ellenőrzés sikertelen, és ez a mező hamis értékre van állítva, a kimeneti kép(ek) nem lesznek elosztva. Ez az alapértelmezett viselkedés. Ha az ellenőrzés sikertelen, és ez a mező igaz értékre van állítva, a kimeneti kép(ek) továbbra is el lesznek terjesztve. Óvatosan használja ezt a beállítást, mert az hibás képek terjesztését eredményezheti. Mindkét esetben (igaz vagy hamis) a rendszer a teljes képfuttatást sikertelennek fogja jelenteni érvényesítési hiba esetén. [Megjegyzés: Ennek a mezőnek nincs hatása, ha az ellenőrzés sikeres.] | logikai |
inVMValidations | A végrehajtandó érvényesítések listája. | ImageTemplateInVMValidator[] |
sourceValidationOnly | Ha ez a mező igaz értékre van állítva, a rendszer közvetlenül érvényesíti a "forrás" szakaszban megadott képet. A rendszer nem futtat külön buildet a testreszabott rendszerkép létrehozásához és érvényesítéséhez. | logikai |
ImageTemplateInVMValidator
Név | Leírás | Érték |
---|---|---|
name | Rövid név, amely kontextust biztosít az érvényesítési lépéssel kapcsolatban | sztring |
típus | Az objektumtípus beállítása | PowerShell Shell (kötelező) |
ImageTemplatePowerShellValidator
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt ellenőrzés típusa. A "Shell" lehet például a rendszerhéj ellenőrzése | "PowerShell" (kötelező) |
inline | Végrehajtandó PowerShell-parancsok tömbje | sztring[] |
runAsSystem | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni a helyi rendszer felhasználójával. Csak akkor lehet igaz, ha a fenti RunElevated mező igaz értékre van állítva. | logikai |
runElevated | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni | logikai |
scriptUri | Az ellenőrzéshez futtatandó PowerShell-szkript URI-ja. Ez lehet github-hivatkozás, Azure Storage URI stb. | sztring |
sha256Checksum | A fenti scriptUri mezőben megadott Power Shell-szkript SHA256-ellenőrzőösszege | sztring |
validExitCodes | Érvényes kilépési kódok a PowerShell-szkripthez. [Alapértelmezett: 0] | int[] |
ImageTemplateShellValidator
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt ellenőrzés típusa. A "Shell" lehet például a rendszerhéj ellenőrzése | "Shell" (kötelező) |
inline | A végrehajtandó rendszerhéj-parancsok tömbje | sztring[] |
scriptUri | Az ellenőrzéshez futtatandó rendszerhéj-szkript URI-ja. Ez lehet github-hivatkozás, Azure Storage URI stb. | sztring |
sha256Checksum | A scriptUri mezőben megadott rendszerhéjszkript SHA256-ellenőrzőösszege | sztring |
ImageTemplateVmProfile
Név | Leírás | Érték |
---|---|---|
osDiskSizeGB | Az operációsrendszer-lemez mérete GB-ban. Kihagyhatja vagy megadhatja a 0 értéket az Azure alapértelmezett operációsrendszer-lemezméretének használatához. | int |
userAssignedIdentities | A felhasználó által hozzárendelt felügyelt identitások erőforrás-azonosítóinak opcionális tömbje, amely konfigurálható a virtuális gép összeállítása és az érvényesítési virtuális gépen. Ez magában foglalhatja a képsablon identitását is. | sztring[] |
vmSize | A képek készítéséhez, testreszabásához és rögzítéséhez használt virtuális gép mérete. Kihagyhatja vagy megadhatja az alapértelmezett sztringet (gen1-rendszerképek esetén Standard_D1_v2, Gen2-rendszerképek esetén pedig Standard_D2ds_v4). | sztring |
vnetConfig | A virtuális hálózat opcionális konfigurációja a virtuális gép buildjének és érvényesítési virtuális gépének üzembe helyezéséhez. Kihagyhatja, ha nincs szükség konkrét virtuális hálózatra. | VirtualNetworkConfig |
VirtualNetworkConfig
Név | Leírás | Érték |
---|---|---|
proxyVmSize | Annak a proxy virtuális gépnek a mérete, amellyel a forgalmat a build virtuális géphez és az érvényesítési virtuális géphez továbbítja. Üres sztring kihagyása vagy megadása az alapértelmezett (Standard_A1_v2) használatához. | sztring |
alhálózat-azonosító | Egy már meglévő alhálózat erőforrás-azonosítója. | sztring |
Gyorssablonok
Az alábbi rövid útmutatósablonok üzembe helyezik ezt az erőforrástípust.
Sablon | Description |
---|---|
Azure Image Builder az Azure Windows alapkonfigurációjával |
Létrehoz egy Azure Image Builder-környezetet, és létrehoz egy Windows Server-rendszerképet a legújabb Windows Frissítések és Az Azure Windows alapkonfigurációjának alkalmazásával. |
A Dev Box szolgáltatás konfigurálása |
Ez a sablon a Dev Box összes rendszergazdai erőforrását a Dev Box rövid útmutatójának megfelelően hozza létre. Megtekintheti az összes létrehozott erőforrást, vagy közvetlenül a DevPortal.microsoft.com-ra léphet az első Dev Box létrehozásához. |
Terraform -erőforrásdefiníció (AzAPI-szolgáltató)
Az imageTemplates erőforrástípus üzembe helyezhető a következőre:
- Erőforráscsoportok
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban találja.
Erőforrás formátuma
Microsoft.VirtualMachineImages/imageTemplates erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.
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 objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
Fájl esetén használja a következőt:
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
A PowerShellhez használja a következőt:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
A Shell esetében használja a következőt:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
WindowsRestart esetén használja a következőt:
type = "WindowsRestart"
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
WindowsUpdate esetén használja a következőt:
type = "WindowsUpdate"
filters = [
"string"
]
searchCriteria = "string"
updateLimit = int
ImageTemplateDistributor-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
ManagedImage esetén használja a következőt:
type = "ManagedImage"
imageId = "string"
location = "string"
SharedImage esetén használja a következőt:
type = "SharedImage"
excludeFromLatest = bool
galleryImageId = "string"
replicationRegions = [
"string"
]
storageAccountType = "string"
VHD esetén használja a következőt:
type = "VHD"
ImageTemplateSource-objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
ManagedImage esetén használja a következőt:
type = "ManagedImage"
imageId = "string"
A PlatformImage esetében használja a következőt:
type = "PlatformImage"
offer = "string"
planInfo = {
planName = "string"
planProduct = "string"
planPublisher = "string"
}
publisher = "string"
sku = "string"
version = "string"
A SharedImageVersion esetében használja a következőt:
type = "SharedImageVersion"
imageVersionId = "string"
ImageTemplateInVMValidator objektumok
Állítsa be a type tulajdonságot az objektum típusának megadásához.
A PowerShellhez használja a következőt:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
A Shell esetében használja a következőt:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Tulajdonságértékek
imageTemplates
Név | Leírás | Érték |
---|---|---|
típus | Az erőforrás típusa | "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14" |
name | Az erőforrás neve | sztring (kötelező) |
location | A földrajzi hely, ahol az erőforrás él | sztring (kötelező) |
parent_id | Az erőforráscsoportban való üzembe helyezéshez használja az erőforráscsoport azonosítóját. | sztring (kötelező) |
tags | Erőforráscímkék. | Címkenevek és -értékek szótára. |
identity | A képsablon identitása, ha konfigurálva van. | ImageTemplateIdentity (kötelező) |
properties | A képsablon tulajdonságai | ImageTemplateProperties |
ImageTemplateIdentity
Név | Leírás | Érték |
---|---|---|
típus | A képsablonhoz használt identitás típusa. A "Nincs" típus eltávolítja az identitásokat a képsablonból. | "UserAssigned" |
identity_ids | A rendszerképsablonhoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai ARM-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | Felhasználói identitásazonosítók tömbje. |
ImageTemplateProperties
Név | Leírás | Érték |
---|---|---|
buildTimeoutInMinutes | A képsablon létrehozása során a várakozás maximális időtartama (beleértve az összes testreszabást, érvényesítést és disztribúciót). Hagyja ki vagy adja meg a 0 értéket az alapértelmezett (4 óra) használatához. | int |
Testreszabása | Megadja a kép testreszabási lépéseinek leírásához használt tulajdonságokat, például a képforrást stb. | ImageTemplateCustomizer[] |
Terjeszteni | Az a terjesztési cél, amelyre a rendszerkép kimenetének el kell mennie. | ImageTemplateDistributor[] (kötelező) |
source | Megadja a forráskép leírásához használt tulajdonságokat. | ImageTemplateSource (kötelező) |
stagingResourceGroup | Az előkészítési erőforráscsoport azonosítója ugyanabban az előfizetésben, mint a rendszerképsablon, amelyet a rendszerkép létrehozásához használnak. Ha ez a mező üres, a rendszer létrehoz egy véletlenszerű nevű erőforráscsoportot. Ha az ebben a mezőben megadott erőforráscsoport nem létezik, ugyanazzal a névvel jön létre. Ha a megadott erőforráscsoport létezik, annak üresnek kell lennie, és ugyanabban a régióban kell lennie, mint a képsablon. A létrehozott erőforráscsoport törlődik a sablon törlésekor, ha ez a mező üres, vagy a megadott erőforráscsoport nem létezik, de ha a megadott erőforráscsoport létezik, az erőforráscsoportban létrehozott erőforrások törlődnek a sablon törlésekor, és maga az erőforráscsoport is megmarad. | sztring |
érvényesítés | Konfigurációs beállítások és az eredményként kapott lemezképen végrehajtandó érvényesítések listája. | ImageTemplatePropertiesValidate |
vmProfile | Leírja, hogyan van beállítva a virtuális gép a rendszerképek létrehozásához | ImageTemplateVmProfile |
ImageTemplateCustomizer
Név | Leírás | Érték |
---|---|---|
name | Rövid név, amely kontextust biztosít a testreszabási lépéssel kapcsolatban | sztring |
típus | Az objektumtípus beállítása | Fájl PowerShell Felület WindowsRestart WindowsUpdate (kötelező) |
ImageTemplateFileCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "Fájl" (kötelező) |
destination | A fájl abszolút elérési útja (már létrehozott beágyazott könyvtárstruktúrákkal), ahová a (sourceUri-ból származó) fájl fel lesz töltve a virtuális gépen | sztring |
sha256Checksum | A fenti sourceUri mezőben megadott fájl SHA256-ellenőrzőösszege | sztring |
sourceUri | A virtuális gép testreszabásához feltöltendő fájl URI-ja. Ez lehet github-hivatkozás, SAS URI az Azure Storage-hoz stb. | sztring |
ImageTemplatePowerShellCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "PowerShell" (kötelező) |
inline | Végrehajtandó PowerShell-parancsok tömbje | sztring[] |
runAsSystem | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni a helyi rendszer felhasználójával. Csak akkor lehet igaz, ha a fenti RunElevated mező igaz értékre van állítva. | logikai |
runElevated | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni | logikai |
scriptUri | A testreszabáshoz futtatandó PowerShell-szkript URI-ja. Ez lehet github-hivatkozás, SAS URI az Azure Storage-hoz stb. | sztring |
sha256Checksum | A fenti scriptUri mezőben megadott Power Shell-szkript SHA256-ellenőrzőösszege | sztring |
validExitCodes | Érvényes kilépési kódok a PowerShell-szkripthez. [Alapértelmezett: 0] | int[] |
ImageTemplateShellCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "Shell" (kötelező) |
inline | A végrehajtandó rendszerhéj-parancsok tömbje | sztring[] |
scriptUri | A testreszabáshoz futtatandó rendszerhéjszkript URI-ja. Ez lehet github-hivatkozás, SAS URI az Azure Storage-hoz stb. | sztring |
sha256Checksum | A scriptUri mezőben megadott rendszerhéjszkript SHA256-ellenőrzőösszege | sztring |
ImageTemplateRestartCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "WindowsRestart" (kötelező) |
restartCheckCommand | Parancs annak ellenőrzéséhez, hogy sikeres volt-e az újraindítás [Alapértelmezett: '] | sztring |
restartCommand | Az újraindítás végrehajtásának parancsa [Alapértelmezett: "shutdown /r /f /t 0 /c "packer restart"] | sztring |
restartTimeout | Újraindítási időtúllépés nagyság és egység sztringként megadva, például 5m (5 perc) vagy "2 óra" (2 óra) [Alapértelmezett: '5m] | sztring |
ImageTemplateWindowsUpdateCustomizer
Név | Leírás | Érték |
---|---|---|
típus | A képen használni kívánt testreszabási eszköz típusa. A "Shell" például lehet rendszerhéj-testreszabó | "WindowsUpdate" (kötelező) |
szűrők | Szűrők tömbje az alkalmazni kívánt frissítések kiválasztásához. Üres tömb kihagyása vagy megadása az alapértelmezett (nincs szűrő) használatához. A fenti hivatkozáson példákat és a mező részletes leírását találja. | sztring[] |
searchCriteria | A frissítések keresésének feltételei. Üres sztring kihagyása vagy megadása az alapértelmezett beállítás használatához (keresés az összesben). A fenti hivatkozáson példákat és a mező részletes leírását találja. | sztring |
updateLimit | Egyszerre alkalmazható frissítések maximális száma. Kihagyás vagy 0 megadása az alapértelmezett (1000) használatához | int |
ImageTemplateDistributor
Név | Leírás | Érték |
---|---|---|
artifactTags | Az összetevőre a terjesztő által létrehozott/frissített címkék lesznek alkalmazva. | object |
runOutputName | A társított RunOutputhoz használandó név. | sztring (kötelező) |
típus | Az objektumtípus beállítása | ManagedImage SharedImage VHD (kötelező) |
ImageTemplateManagedImageDistributor
Név | Leírás | Érték |
---|---|---|
típus | A terjesztés típusa. | "ManagedImage" (kötelező) |
imageId | A felügyelt lemezkép erőforrás-azonosítója | sztring (kötelező) |
location | A rendszerkép Azure-helyének meg kell egyeznie, ha a rendszerkép már létezik | sztring (kötelező) |
ImageTemplateSharedImageDistributor
Név | Leírás | Érték |
---|---|---|
típus | A terjesztés típusa. | "SharedImage" (kötelező) |
excludeFromLatest | Jelző, amely azt jelzi, hogy a létrehozott rendszerkép-verziót ki kell-e zárni a legújabb verzióból. Kihagyás az alapértelmezett (hamis) beállítás használatához. | logikai |
galleryImageId | A Shared Image Gallery rendszerkép erőforrás-azonosítója | sztring (kötelező) |
replicationRegions | Azoknak a régióknak a listája, amelyekbe a rendszerképet replikálni fogja | sztring[] (kötelező) |
storageAccountType | A megosztott lemezkép tárolásához használandó tárfiók típusa. Kihagyás az alapértelmezett (Standard_LRS) használatához. | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
Név | Leírás | Érték |
---|---|---|
típus | A terjesztés típusa. | "VHD" (kötelező) |
ImageTemplateSource
Név | Leírás | Érték |
---|---|---|
típus | Az objektumtípus beállítása | ManagedImage PlatformImage SharedImageVersion (kötelező) |
ImageTemplateManagedImageSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja a forráskép típusát, amellyel kezdeni szeretné. | "ManagedImage" (kötelező) |
imageId | A felügyelt rendszerkép ARM-erőforrás-azonosítója az ügyfél-előfizetésben | sztring (kötelező) |
ImageTemplatePlatformImageSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja a forráskép típusát, amellyel kezdeni szeretné. | "PlatformImage" (kötelező) |
offer | Képajánlat az Azure Gallery Images szolgáltatásból. | sztring |
planInfo | A platformrendszerkép vásárlási csomagjának opcionális konfigurációja. | PlatformImagePurchasePlan |
közzétevő | Image Publisher az Azure Gallery Images szolgáltatásban. | sztring |
Sku | Az Azure Gallery Images rendszerképeinek termékváltozata. | sztring |
version | Az Azure Gallery Images rendszerképverziója. Ha itt a "latest" (legújabb) érték van megadva, a rendszerkép buildelésekor értékeli ki a verziót, nem pedig a sablon elküldésekor. | sztring |
PlatformImagePurchasePlan
Név | Leírás | Érték |
---|---|---|
planName | A vásárlási terv neve. | sztring (kötelező) |
planProduct | A vásárlási terv terméke. | sztring (kötelező) |
planPublisher | A vásárlási csomag közzétevője. | sztring (kötelező) |
ImageTemplateSharedImageVersionSource
Név | Leírás | Érték |
---|---|---|
típus | Megadja a forráskép típusát, amellyel kezdeni szeretné. | "SharedImageVersion" (kötelező) |
imageVersionId | A rendszerkép verziójának ARM-erőforrás-azonosítója a megosztott rendszerkép-katalógusban | sztring (kötelező) |
ImageTemplatePropertiesValidate
Név | Leírás | Érték |
---|---|---|
continueDistributeOnFailure | Ha az ellenőrzés sikertelen, és ez a mező false (hamis) értékre van állítva, a kimeneti kép(ek) nem lesznek elosztva. Ez az alapértelmezett viselkedés. Ha az ellenőrzés sikertelen, és ez a mező true (igaz) értékre van állítva, a kimeneti rendszerkép(ek) továbbra is el lesznek osztva. Ezt a beállítást körültekintően használja, mert az hibás képek terjesztését eredményezheti. Mindkét esetben (igaz vagy hamis) a rendszer a végpontok közötti rendszerképfuttatást sikertelennek fogja jelenteni egy érvényesítési hiba esetén. [Megjegyzés: Ennek a mezőnek nincs hatása, ha az ellenőrzés sikeres.] | logikai |
inVMValidations | Az elvégzendő ellenőrzések listája. | ImageTemplateInVMValidator[] |
sourceValidationOnly | Ha ez a mező igaz értékre van állítva, a rendszer közvetlenül ellenőrzi a "forrás" szakaszban megadott képet. A rendszer nem futtat külön buildet a testreszabott rendszerkép létrehozásához és ellenőrzéséhez. | logikai |
ImageTemplateInVMValidator
Név | Leírás | Érték |
---|---|---|
name | Rövid név, amely kontextust biztosít az érvényesítési lépéssel kapcsolatban | sztring |
típus | Az objektum típusának beállítása | PowerShell Rendszerhéj (kötelező) |
ImageTemplatePowerShellValidator
Név | Leírás | Érték |
---|---|---|
típus | A rendszerképen használni kívánt érvényesítés típusa. Például a "Rendszerhéj" lehet rendszerhéj-ellenőrzés | "PowerShell" (kötelező) |
inline | Végrehajtandó PowerShell-parancsok tömbje | sztring[] |
runAsSystem | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni a helyi rendszer felhasználójának használatával. Csak akkor lehet igaz, ha a fenti runElevated mező igaz értékre van állítva. | logikai |
runElevated | Ha meg van adva, a PowerShell-szkript emelt szintű jogosultságokkal fog futni | logikai |
scriptUri | Az ellenőrzéshez futtatandó PowerShell-szkript URI-ja. Ez lehet github-hivatkozás, Azure Storage URI stb. | sztring |
sha256Checksum | A fenti scriptUri mezőben megadott Power Shell-szkript SHA256-ellenőrzőösszege | sztring |
validExitCodes | Érvényes kilépési kódok a PowerShell-szkripthez. [Alapértelmezett: 0] | int[] |
ImageTemplateShellValidator
Név | Leírás | Érték |
---|---|---|
típus | A rendszerképen használni kívánt érvényesítés típusa. Például a "Rendszerhéj" lehet rendszerhéj-ellenőrzés | "Shell" (kötelező) |
inline | Végrehajtandó rendszerhéjparancsok tömbje | sztring[] |
scriptUri | Az ellenőrzéshez futtatandó rendszerhéjszkript URI-ja. Ez lehet github-hivatkozás, Azure Storage URI stb. | sztring |
sha256Checksum | A scriptUri mezőben megadott rendszerhéjszkript SHA256-ellenőrzőösszege | sztring |
ImageTemplateVmProfile
Név | Leírás | Érték |
---|---|---|
osDiskSizeGB | Az operációsrendszer-lemez mérete GB-ban. Hagyja ki vagy adja meg a 0 értéket az Azure alapértelmezett operációsrendszer-lemezméretének használatához. | int |
userAssignedIdentities | A build virtuális gépen és az érvényesítési virtuális gépen konfigurálni kívánt, felhasználó által hozzárendelt felügyelt identitások erőforrás-azonosítóinak opcionális tömbje. Ez magában foglalhatja a képsablon identitását is. | sztring[] |
vmSize | A képek létrehozásához, testreszabásához és rögzítéséhez használt virtuális gép mérete. Hagyja ki vagy adja meg az alapértelmezett sztringet (Standard_D1_v2 Gen1-képekhez és Standard_D2ds_v4 Gen2-képekhez). | sztring |
vnetConfig | A virtuális hálózat opcionális konfigurációja a virtuális gép buildjének üzembe helyezéséhez és a virtuális gép ellenőrzéséhez. Kihagyás, ha nincs szükség adott virtuális hálózatra. | VirtualNetworkConfig |
VirtualNetworkConfig
Név | Leírás | Érték |
---|---|---|
proxyVmSize | Annak a proxy virtuális gépnek a mérete, amellyel a forgalmat a build virtuális géphez és az érvényesítési virtuális géphez továbbítja. Üres sztring kihagyása vagy megadása az alapértelmezett (Standard_A1_v2) használatához. | sztring |
alhálózat-azonosító | Egy már meglévő alhálózat erőforrás-azonosítója. | sztring |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: