PackerBuild@1 - Makine görüntüsü v1 görevi oluşturma

2025-06-24

Azure Sanal makine ölçek kümesi dağıtımı için kullanılabilecek Packer kullanarak makine görüntüsü oluşturmak için bu görevi kullanın.

Sözdizimi

# 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.

Girişler

templateType - Packer şablonu
string. Gerekli. İzin verilen değerler: builtin (Otomatik oluşturulan), custom (Kullanıcı tarafından sağlanır). Varsayılan değer: builtin.

Görevin otomatik olarak bir Paketleyici şablonu oluşturup oluşturmayacağını veya sizin tarafınızdan sağlanan özel bir şablon kullanıp kullanmayacağını belirtir.

customTemplateLocation - Packer şablon konumu
string. templateType = customgerekir.

Kullanıcı tarafından sağlanan özel bir şablonun yolunu belirtir.

customTemplateParameters - Şablon parametreleri
string. Opsiyonel. templateType = customolduğunda kullanın. Varsayılan değer: {}.

Özel şablon oluşturmak için Packer'a geçirilecek parametreleri belirtir. Bu, özel şablonunuzdaki bir variables bölümüne eşlenmelidir. Örneğin, şablonun drop-locationadlı bir değişkeni varsa, buraya drop-location adını ve kullanmak istediğiniz değeri içeren bir parametre ekleyin. Değeri bir yayın değişkenine de bağlayabilirsiniz. Kılavuzdaki ek parametreleri görüntülemek/düzenlemek için metin kutusunun yanındaki … tıklayın.

Azure aboneliği
string. templateType = builtingerekir.

Makine görüntüsünü pişirmek ve depolamak için Azure Resource Manager aboneliğini belirtir.

Yönetilen VM disk görüntüsünüisManagedImage -
boolean. Opsiyonel. templateType = builtinolduğunda kullanın. Varsayılan değer: true.

Oluşturulan görüntünün yönetilen görüntü olup olmadığını denetler.

Yönetilen VM Disk Görüntüsü AdımanagedImageName -
string. isManagedImage = true && templateType = builtingerekir.

Otomatik oluşturulan şablonlar için Yönetilen disk görüntüsünün adını belirtir.

depolama konumulocation -
string. templateType = builtingerekir.

Yerleşik makine görüntüsünü depolama konumunu belirtir. Bu konum, görüntü oluşturmak amacıyla geçici bir VM oluşturmak için de kullanılır.

depolama hesabıstorageAccountName -
string. templateType = builtingerekir.

Yerleşik makine görüntüsünü depolamak için depolama hesabını belirtir. Bu depolama hesabı, seçilen konumda önceden mevcut olmalıdır.

kaynak grubu
string. templateType = builtingerekir.

Seçili depolama hesabını içeren Azure Kaynak grubunu belirtir.

baseImageSource - Temel görüntü kaynağı
string. templateType = builtingerekir. İzin verilen değerler: default (Galeri), customVhd (Özel). Varsayılan değer: default.

Temel görüntünün kaynağını belirtir. Seçilen işletim sistemi görüntüleri galerisinden birini seçebilir veya özel VHD görüntünüzün URL'sini sağlayabilirsiniz.

Uyarı

Managed VM disk image seçeneğini işaretleyerek Yönetilen görüntü oluşturma seçeneğini belirlediyseniz, burada yalnızca Gallery seçeneğini belirlemeniz gerekir. Custom kaynağı yönetilen görüntü oluşturmak için desteklenmez.

baseImage - Temel görüntü
string. baseImageSource = default && templateType = builtingerekir. İzin verilen değerler: 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-SP1Canonical:UbuntuServer:14.04.4-LTS:linux (Ubuntu 14.04.4-LTS), Canonical:UbuntuServer:16.04-LTS:linux (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). Varsayılan değer: MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:windows.

seçilen işletim sistemi görüntüleri listesinden seçim yapın. Bu, bir makine görüntüsünü yakalamadan önce önkoşulları ve uygulamaları yüklemek için kullanılır.

customImageUrl - Temel görüntü URL'si
string. baseImageSource = customVhd && templateType = builtingerekir.

Temel görüntünün URL'sini belirtir. Bu, bir makine görüntüsünü yakalamadan önce önkoşulları ve uygulamaları yüklemek için kullanılır.

customImageOSType - Temel görüntü işletim sistemi
string. baseImageSource = customVhd && templateType = builtingerekir. İzin verilen değerler: windows, linux. Varsayılan değer: windows.

packagePath - Dağıtım Paketi
string. templateType = builtingerekir.

$(System.DefaultWorkingDirectory)göre dağıtım paketi dizininin yolunu belirtir. Minimatch deseni destekler. Örnek yol: FrontendWebApp/**/GalleryApp

Uyarı

Bu paket, Packer'ın oluşturduğu geçici bir sanal makineye kopyalanır. Paket çok fazla sayıda dosya içeriyorsa ve/veya dosyaların boyutu çok büyükse, karşıya yükleme uzun sürebilir (muhtemelen birkaç saat çalışır). Karşıya yükleme süresini iyileştirmek için lütfen paketin boyutunun anlamlı bir şekilde azaltılıp azaltılmadığını görün. Bir diğer alternatif de aracı bir Azure depolama hesabı kullanmaktır. Bu görevi çalıştırmadan önce paketi bir depolama hesabına yükleyin. Bu görev için, depolama hesabından gerekli paketi indirecek bir betik içeren bir paket kullanın.

deployScriptPath - Dağıtım betiği
string. templateType = builtingerekir.

Paketi dağıtan powershell betiğinin (Windows için) veya kabuk betiğinin (Linux için) göreli yolunu belirtir. Bu betik, yukarıda seçilen paket yolunda bulunmalıdır. Minimatch deseni destekler. Örnek yol: deploy/**/scripts/windows/deploy.ps1.

dağıtım betiği bağımsız değişkenlerinideployScriptArguments -
string. Opsiyonel. templateType = builtinolduğunda kullanın.

Dağıtım betiğine geçirilecek bağımsız değişkenleri belirtir.

additionalBuilderParameters - Ek Oluşturucu parametreleri
string. Opsiyonel. templateType = builtinolduğunda kullanın. Varsayılan değer: {"vm_size":"Standard_D3_v2"}.

Otomatik olarak oluşturulan Paketleyici şablonu modunda görev, Azure oluşturucusu ile bir Packer şablonu oluşturur. Bu oluşturucu bir makine görüntüsü oluşturmak için kullanılır. Oluşturulan Packer şablonunu özelleştirmek için Azure oluşturucusunun anahtarlarını ekleyebilirsiniz. Örneğin: CentOS temel görüntüsü kullanıyorsanız ve ssh_tty=trueçalıştırmak için bir tty'niz olması gerekiyorsa sudo ayarını yapma. Kılavuzdaki ek parametreleri görüntülemek/düzenlemek için metin kutusunun yanındaki … tıklayın.

skipTempFileCleanupDuringVMDeprovision - Sağlamayı kaldırma sırasında geçici dosya temizlemeyi atla
boolean. Opsiyonel. templateType = builtinolduğunda kullanın. Varsayılan değer: true.

Vm'nin sağlamasını kaldırma sırasında, VM'ye yüklenen geçici dosyaların temizlenmesini atlar. Packer Azure Sanal Makine Görüntü Oluşturucuları hakkında daha fazla bilgi edinin.

packerVersion - Packer Sürüm
string. Opsiyonel. templateType = customolduğunda kullanın.

Yüklenecek Packer sürümünü belirtir. Bu yalnızca özel şablonlarla çalışır.

imageUri - Resim URL'si veya Ad
string.

Yönetilmeyen bir VM görüntüsü için oluşturulan makine görüntüsü VHD URL'sini veya yönetilen bir VM görüntüsünün görüntü adını depolayacak çıkış değişkeninin adını belirtir.

Azure Kaynak KimliğiimageId -
string.

Yeni oluşturulan görüntünün Azure Kaynak Kimliğini depolayacak çıkış değişkeninin adını belirtir. Bu yalnızca yönetilen görüntüler içindir.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Packer kullanarak makine görüntüsü oluşturmak için bu görevi kullanın. Bu görüntü Azure Sanal makine ölçek kümesi dağıtımı için kullanılabilir.

Uyarı

Ayrıntılı günlükleri etkinleştirmek istiyorsanız, İşlem Hatları>>Değişkenlerini Düzenleadresine gidin ve ardından PACKER_LOG yeni bir değişken ekleyin ve değerini 1 olarak ayarlayın.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talepleri	Hiç kimse
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi bir
Ayarlanabilir değişkenleri	Herhangi bir
Aracı sürümü	2.0.0 veya üzeri
Görev kategorisi	Uygulamak

Aracılığıyla paylaş

PackerBuild@1 - Makine görüntüsü v1 görevi oluşturma

Sözdizimi

Girişler

Görev denetimi seçenekleri

Çıkış değişkenleri

Açıklamalar

Gereksinimler

Geri Bildirim

Ek kaynaklar