Freigeben über

PackerBuild@0 – Build machine image v0 task

  • Artikel

Verwenden Sie diese Aufgabe, um ein Computerimage mithilfe von Packer zu erstellen, das für die Bereitstellung von Skalierungsgruppen für virtuelle Azure-Computer verwendet werden kann.

Diese Version der Aufgabe ist veraltet; verwenden Sie PackerBuild@1, um die neuesten Features wie Workload Identity Federationzu nutzen.

Hinweis

Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit Workflowidentitätsverbund.

Verwenden Sie diese Aufgabe, um ein Computerimage mithilfe von Packer zu erstellen, das für die Bereitstellung von Skalierungsgruppen für virtuelle Azure-Computer verwendet werden kann.

Hinweis

Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit Workflowidentitätsverbund.

Syntax

# Build machine image v0
# Build a machine image using Packer, which may be used for Azure Virtual machine scale set deployment.
- task: PackerBuild@0
  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. 
    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' | '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: '{}' # string. Optional. Use when templateType = builtin. Additional Builder parameters. Default: {}.
    #skipTempFileCleanupDuringVMDeprovision: true # boolean. Optional. Use when templateType = builtin. Skip temporary file cleanup during deprovision. Default: true.
  # Output
    #imageUri: # string. Image URL.

Eingänge

templateType - Packer-Vorlage
string. Erforderlich. Zulässige Werte: builtin (automatisch generiert), custom (vom Benutzer bereitgestellt). Standardwert: builtin.

Gibt an, ob die Aufgabe automatisch eine Packer-Vorlage generieren oder eine von Ihnen bereitgestellte benutzerdefinierte Vorlage verwenden soll.


customTemplateLocation - Packer-Vorlagenspeicherort
string. Erforderlich, wenn templateType = custom.

Gibt den Pfad zu einer benutzerdefinierten vom Benutzer bereitgestellten Vorlage an.


customTemplateParameters - Vorlagenparameter
string. Wahlfrei. Wird verwendet, wenn templateType = custom. Standardwert: {}.

Gibt Parameter an, die zum Erstellen einer benutzerdefinierten Vorlage an Packer übergeben werden. Dies sollte dem Abschnitt variables in Ihrer benutzerdefinierten Vorlage zugeordnet werden. Wenn die Vorlage beispielsweise eine Variable namens drop-locationhat, fügen Sie hier einen Parameter mit dem Namen drop-location und einem Wert hinzu, den Sie verwenden möchten. Sie können den Wert auch mit einer Releasevariable verknüpfen. Wenn Sie die zusätzlichen Parameter in einem Raster anzeigen/bearbeiten möchten, klicken Sie neben dem Textfeld auf ….


ConnectedServiceName - Azure-Abonnement
string. Erforderlich, wenn templateType = builtin.

Gibt das Azure Resource Manager-Abonnement zum Backen und Speichern des Computerimages an.


location - Speicherort
string. Erforderlich, wenn templateType = builtin.

Gibt den Speicherort zum Speichern des integrierten Computerimages an. Dieser Speicherort wird auch verwendet, um einen temporären virtuellen Computer zum Erstellen eines Images zu erstellen.


storageAccountName - Speicherkonto
string. Erforderlich, wenn templateType = builtin.

Gibt das Speicherkonto zum Speichern des integrierten Computerimages an. Dieses Speicherkonto muss bereits an dem ausgewählten Speicherort vorhanden sein.


azureResourceGroup - Ressourcengruppe
string. Erforderlich, wenn templateType = builtin.

Gibt die Azure-Ressourcengruppe an, die das ausgewählte Speicherkonto enthält.


baseImageSource - Basisbildquelle
string. Erforderlich, wenn templateType = builtin. Zulässige Werte: default (Katalog), customVhd (Benutzerdefiniert). Standardwert: default.

Gibt die Quelle eines Basisimages an. Sie können entweder aus einem kuratierten Katalog mit Betriebssystemimages auswählen oder eine URL Ihres benutzerdefinierten Bilds angeben.


baseImage - Basisimage
string. Erforderlich, wenn baseImageSource = default && templateType = builtin. Zulässige Werte: 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), RedHat:RHEL:7.2:linux (RHE)L 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). Standardwert: MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:windows.

Wählen Sie aus einer kuratierten Liste der Betriebssystemimages aus. Dies wird zum Installieren von Voraussetzungen und Anwendungen verwendet, bevor ein Computerimage erfasst wird.


customImageUrl - Basisbild-URL
string. Erforderlich, wenn baseImageSource = customVhd && templateType = builtin.

Gibt die URL eines Basisimages an. Dies wird zum Installieren von Voraussetzungen und Anwendungen verwendet, bevor ein Computerimage erfasst wird.


customImageOSType - Basisimage-Betriebssystem-
string. Erforderlich, wenn baseImageSource = customVhd && templateType = builtin. Zulässige Werte: windows, linux. Standardwert: windows.


packagePath - Bereitstellungspaket-
string. Erforderlich, wenn templateType = builtin.

Gibt den Pfad für das Bereitstellungspaketverzeichnis relativ zu $(System.DefaultWorkingDirectory)an. Unterstützt ein Miniübereinstimmungsmuster. Beispielpfad: FrontendWebApp/**/GalleryApp.


deployScriptPath - Bereitstellungsskript
string. Erforderlich, wenn templateType = builtin.

Gibt den relativen Pfad zu einem PowerShell-Skript (für Windows) oder ein Shellskript (für Linux) an, das das Paket bereitstellt. Dieses Skript sollte im oben ausgewählten Paketpfad enthalten sein. Unterstützt ein Miniübereinstimmungsmuster. Beispielpfad: deploy/**/scripts/windows/deploy.ps1.


deployScriptArguments - Bereitstellungsskriptargumente
string. Wahlfrei. Wird verwendet, wenn templateType = builtin.

Gibt die Argumente an, die an das Bereitstellungsskript übergeben werden sollen.


additionalBuilderParameters - Zusätzliche Generator-Parameter
string. Wahlfrei. Wird verwendet, wenn templateType = builtin. Standardwert: {}.

In einem automatisch generierten Packer-Vorlagenmodus erstellt die Aufgabe eine Packer-Vorlage mit einem Azure-Generator. Dieser Generator wird verwendet, um ein Computerimage zu generieren. Sie können dem Azure-Generator Schlüssel hinzufügen, um die generierte Packer-Vorlage anzupassen. Wenn Sie z. B. ssh_tty=true festlegen, wenn Sie ein CentOS-Basisimage verwenden, und Sie müssen über einen Tty verfügen, um sudo auszuführen.

Wenn Sie die zusätzlichen Parameter in einem Raster anzeigen oder bearbeiten möchten, klicken Sie auf … neben dem Textfeld.


skipTempFileCleanupDuringVMDeprovision - Temporäre Dateibereinigung während der Deprovisions- überspringen
boolean. Wahlfrei. Wird verwendet, wenn templateType = builtin. Standardwert: true.

Während der Bereitstellung eines virtuellen Computers überspringt die Bereinigung temporärer Dateien, die auf den virtuellen Computer hochgeladen wurden. Weitere Informationen finden Sie unter Azure Virtual Machine Image Builders.


imageUri - Bild-URL
string.

Gibt einen Namen für die Ausgabevariable an, die die URL des generierten Computerimages speichert.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe, um ein Computerimage mithilfe von Packer zu erstellen. Dieses Image kann für die Bereitstellung von Skalierungsgruppen für virtuelle Azure-Computer verwendet werden.

Hinweis

Wenn Sie detaillierte Protokolle aktivieren möchten, navigieren Sie zu Pipelines>Edit>Variables, und fügen Sie dann eine neue Variable PACKER_LOG hinzu, und legen Sie den Wert auf 1 fest.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 2.0.0 oder höher
Vorgangskategorie Einsetzen