PackerBuild@1 – Gépi rendszerkép v1-feladat létrehozása

Ezzel a feladattal gépi rendszerképet hozhat létre a Packer használatával, amely az Azure-beli virtuálisgép-méretezési csoportok üzembe helyezéséhez használható.

Megjegyzés

Ez a feladat nem támogatja az Azure Resource Manager-hitelesítést a munkafolyamat-identitások összevonásával.

Syntax

# Build machine image v1
# Build a machine image using Packer, which may be used for Azure Virtual machine scale set deployment.
- task: PackerBuild@1
  inputs:
    templateType: 'builtin' # 'builtin' | 'custom'. Required. Packer template. Default: builtin.
    #customTemplateLocation: # string. Required when templateType = custom. Packer template location. 
    #customTemplateParameters: '{}' # string. Optional. Use when templateType = custom. Template parameters. Default: {}.
  # Azure Details
    ConnectedServiceName: # string. Required when templateType = builtin. Azure subscription. 
    #isManagedImage: true # boolean. Optional. Use when templateType = builtin. Managed VM disk image. Default: true.
    #managedImageName: # string. Required when isManagedImage = true && templateType = builtin. Managed VM Disk Image Name. 
    location: # string. Required when templateType = builtin. Storage location. 
    storageAccountName: # string. Required when templateType = builtin. Storage account. 
    azureResourceGroup: # string. Required when templateType = builtin. Resource group. 
  # Deployment Inputs
    baseImageSource: 'default' # 'default' | 'customVhd'. Required when templateType = builtin. Base image source. Default: default.
    #baseImage: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:windows' # 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:windows' | 'MicrosoftWindowsServer:WindowsServer:2016-Datacenter:windows' | 'MicrosoftWindowsServer:WindowsServer:2012-Datacenter:windows' | 'MicrosoftWindowsServer:WindowsServer:2008-R2-SP1:windows' | 'Canonical:UbuntuServer:14.04.4-LTS:linux' | 'Canonical:UbuntuServer:16.04-LTS:linux' | 'Canonical:UbuntuServer:18.04-LTS:linux' | 'RedHat:RHEL:7.2:linux' | 'RedHat:RHEL:6.8:linux' | 'OpenLogic:CentOS:7.2:linux' | 'OpenLogic:CentOS:6.8:linux' | 'credativ:Debian:8:linux' | 'credativ:Debian:7:linux' | 'SUSE:openSUSE-Leap:42.2:linux' | 'SUSE:SLES:12-SP2:linux' | 'SUSE:SLES:11-SP4:linux'. Required when baseImageSource = default && templateType = builtin. Base image. Default: MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:windows.
    #customImageUrl: # string. Required when baseImageSource = customVhd && templateType = builtin. Base image URL. 
    #customImageOSType: 'windows' # 'windows' | 'linux'. Required when baseImageSource = customVhd && templateType = builtin. Base image OS. Default: windows.
    packagePath: # string. Required when templateType = builtin. Deployment Package. 
    deployScriptPath: # string. Required when templateType = builtin. Deployment script. 
    #deployScriptArguments: # string. Optional. Use when templateType = builtin. Deployment script arguments. 
  # Advanced
    #additionalBuilderParameters: '{"vm_size":"Standard_D3_v2"}' # string. Optional. Use when templateType = builtin. Additional Builder parameters. Default: {"vm_size":"Standard_D3_v2"}.
    #skipTempFileCleanupDuringVMDeprovision: true # boolean. Optional. Use when templateType = builtin. Skip temporary file cleanup during deprovision. Default: true.
    #packerVersion: # string. Optional. Use when templateType = custom. Packer Version. 
  # Output
    #imageUri: # string. Image URL or Name. 
    #imageId: # string. Azure Resource Id.

Bevitelek

templateType - Packer-sablon
string. Kötelező. Engedélyezett értékek: builtin (automatikusan generálva), custom (felhasználó által megadott). Alapértelmezett érték: builtin.

Meghatározza, hogy a tevékenység automatikusan létrehoz-e Packer-sablont, vagy ön által biztosított egyéni sablont használ-e.

customTemplateLocation - A Packer-sablon helye
string. Akkor szükséges, ha templateType = custom.

Megadja egy egyéni, felhasználó által megadott sablon elérési útját.

customTemplateParameters - Sablonparaméterek
string. Választható. Használja a következőt: templateType = custom. Alapértelmezett érték: {}.

Megadja azokat a paramétereket, amelyeket a rendszer átad a Packernek egy egyéni sablon létrehozásához. Ennek le kell képeznie az egyéni sablon egy variables szakaszát. Ha például a sablon egy nevű drop-locationváltozóval rendelkezik, adjon hozzá egy paramétert a névvel drop-location és egy használni kívánt értékkel. Az értéket egy kiadási változóhoz is csatolhatja. A rács további paramétereinek megtekintéséhez/szerkesztéséhez kattintson a … szövegdoboz melletti elemre.

ConnectedServiceName - Azure-előfizetés
string. Akkor szükséges, ha templateType = builtin.

Meghatározza az Azure Resource Manager-előfizetést a gép rendszerképének sütéshez és tárolásához.

isManagedImage - Felügyelt virtuálisgép-lemezkép
boolean. Választható. Használja a következőt: templateType = builtin. Alapértelmezett érték: true.

Ellenőrzi, hogy a létrehozott rendszerképnek felügyelt rendszerképnek kell-e lennie.

managedImageName - Felügyelt virtuális gép lemezképének neve
string. Akkor szükséges, ha isManagedImage = true && templateType = builtin.

Az automatikusan létrehozott sablonok felügyelt lemezképének nevét adja meg.

location - Tárolási hely
string. Akkor szükséges, ha templateType = builtin.

A beépített gép lemezképének tárolására szolgáló helyet adja meg. Ez a hely egy ideiglenes virtuális gép létrehozására is használható lemezkép készítése céljából.

storageAccountName - Tárfiók
string. Akkor szükséges, ha templateType = builtin.

A beépített gépi rendszerkép tárolására szolgáló tárfiókot adja meg. Ennek a tárfióknak már meglévőnek kell lennie a kiválasztott helyen.

azureResourceGroup - Erőforráscsoport
string. Akkor szükséges, ha templateType = builtin.

Megadja a kiválasztott tárfiókot tartalmazó Azure-erőforráscsoportot.

baseImageSource - Alaprendszerkép forrása
string. Akkor szükséges, ha templateType = builtin. Engedélyezett értékek: default (Katalógus), customVhd (Egyéni). Alapértelmezett érték: default.

Megadja az alaprendszerkép forrását. Választhat az operációsrendszer-rendszerképek válogatott gyűjteményéből, vagy megadhatja az egyéni VHD-rendszerkép URL-címét.

Megjegyzés

Ha bejelölte a Felügyelt rendszerkép létrehozásának lehetőségét a Managed VM disk image beállítás bejelölésével, akkor csak itt válassza ki a Gallery lehetőséget. Custom a forrás nem támogatott felügyelt rendszerképek létrehozásához.

baseImage - Alaprendszerkép
string. Akkor szükséges, ha baseImageSource = default && templateType = builtin. Engedélyezett értékek: MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:windows (Windows 2012-R2-Datacenter), MicrosoftWindowsServer:WindowsServer:2016-Datacenter:windows (Windows 2016-Datacenter), MicrosoftWindowsServer:WindowsServer:2012-Datacenter:windows (Windows 2012-Datacenter), MicrosoftWindowsServer:WindowsServer:2008-R2-SP1:windows (Windows 2008-R2-SP1), Canonical:UbuntuServer:14.04.4-LTS:linux (Ubuntu 14.04.4-LTS), Canonical:UbuntuServer:16.04-LTS:linux (Ubuntu 16.04-LTS), (Ubuntu 16.04-LTS), Canonical:UbuntuServer:18.04-LTS:linux (Ubuntu 18.04-LTS), RedHat:RHEL:7.2:linux (RHEL 7.2), RedHat:RHEL:6.8:linux (RHEL 6.8), OpenLogic:CentOS:7.2:linux (CentOS 7.2), OpenLogic:CentOS:6.8:linux (CentOS 6.8), credativ:Debian:8:linux (Debian 8), credativ:Debian:7:linux (Debian 7), SUSE:openSUSE-Leap:42.2:linux (openSUSE-Leap 42.2), SUSE:SLES:12-SP2:linux (SLES 12-SP2), SUSE:SLES:11-SP4:linux (SLES 11-SP4). Alapértelmezett érték: MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:windows.

Az operációsrendszer-rendszerképek válogatott listájából választhat. Ez az előfeltétel(ek) és alkalmazás(ok) telepítésére szolgál a gép lemezképének rögzítése előtt.

customImageUrl - Alaprendszerkép URL-címe
string. Akkor szükséges, ha baseImageSource = customVhd && templateType = builtin.

Egy alaprendszerkép URL-címét adja meg. Ez az előfeltétel(ek) és alkalmazás(ok) telepítésére szolgál a gép lemezképének rögzítése előtt.

customImageOSType - Alaprendszerkép operációs rendszere
string. Akkor szükséges, ha baseImageSource = customVhd && templateType = builtin. Engedélyezett értékek: windows, linux. Alapértelmezett érték: windows.

packagePath - Üzembehelyezési csomag
string. Akkor szükséges, ha templateType = builtin.

Az üzembehelyezési csomag könyvtárának elérési útját adja meg a következőhöz $(System.DefaultWorkingDirectory)viszonyítva: . Támogatja a minimatch mintát. Példa elérési útja: FrontendWebApp/**/GalleryApp

Megjegyzés

A csomag át lesz másolva egy ideiglenes virtuális gépre, amelyet a Packer hoz létre. Ha a csomag nagy számú fájlt tartalmaz, és/vagy a fájlok mérete nagyon nagy, a feltöltés hosszabb időt vehet igénybe (akár néhány óráig is eltarthat). A feltöltési idő optimalizálásához ellenőrizze, hogy a csomag mérete jelentősen csökkenthető-e. Egy másik alternatíva egy köztes Azure-tárfiók használata. A feladat futtatása előtt töltse fel a csomagot egy tárfiókba. Ehhez a feladathoz használjon egy szkriptet tartalmazó csomagot, amely letölti a szükséges csomagot a tárfiókból.

deployScriptPath - Üzembehelyezési szkript
string. Akkor szükséges, ha templateType = builtin.

Megadja a powershell-szkript (Windows) vagy a csomagot üzembe helyező rendszerhéjszkript (Linux esetén) relatív elérési útját. Ezt a szkriptet a fent kiválasztott csomagútvonalon kell tárolni. Támogatja a minimatch mintát. Példa elérési útja: deploy/**/scripts/windows/deploy.ps1.

deployScriptArguments - Üzembehelyezési szkript argumentumai
string. Választható. Használja a következőt: templateType = builtin.

Megadja az üzembehelyezési szkriptnek átadni kívánt argumentumokat.

additionalBuilderParameters - További Builder-paraméterek
string. Választható. Használja a következőt: templateType = builtin. Alapértelmezett érték: {"vm_size":"Standard_D3_v2"}.

Az automatikusan létrehozott Packer-sablon módban a feladat létrehoz egy Packer-sablont egy Azure Builderrel. Ez a szerkesztő egy gépi rendszerkép létrehozására szolgál. A létrehozott Packer-sablon testreszabásához kulcsokat adhat hozzá az Azure Builderhez. Például: Beállítás ssh_tty=true , ha CentOS alaprendszerképet használ, és a futtatásához sudotty-ra van szükség. A rács további paramétereinek megtekintéséhez/szerkesztéséhez kattintson a … szövegdoboz melletti elemre.

skipTempFileCleanupDuringVMDeprovision - Ideiglenes fájlkarbantartás kihagyása a megszüntetés során
boolean. Választható. Használja a következőt: templateType = builtin. Alapértelmezett érték: true.

A virtuális gép megszüntetése során kihagyja a virtuális gépre feltöltött ideiglenes fájlok törlését. További információ az Azure Virtual Machine Image Buildersről a Packerben.

packerVersion - Packer-verzió
string. Választható. Használja a következőt: templateType = custom.

Megadja a telepíteni kívánt Packer-verziót. Ez csak egyéni sablonokkal fog működni.

imageUri - Kép URL-címe vagy neve
string.

Megadja a kimeneti változó nevét, amely egy nem felügyelt virtuálisgép-rendszerkép generált virtuálisgép-VHD-URL-címét vagy egy felügyelt virtuálisgép-rendszerkép rendszerképének nevét tárolja.

imageId - Azure-erőforrás azonosítója
string.

Megadja a kimeneti változó nevét, amely az újonnan létrehozott rendszerkép Azure-erőforrás-azonosítóját fogja tárolni. Ez csak felügyelt rendszerképekhez használható.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladattal gépi rendszerképet hozhat létre a Packer használatával. Ez a rendszerkép használható az Azure-beli virtuálisgép-méretezési csoport üzembe helyezéséhez.

Megjegyzés

Ha részletes naplókat szeretne engedélyezni, lépjen a Folyamatok változók>szerkesztése>elemre, majd adjon hozzá egy új változót PACKER_LOG , és állítsa az értékét 1-re.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	2.0.0 vagy újabb
Feladatkategória	Üzembe helyezés