ServiceFabricUpdateManifests@2 - Service Fabric bildirimlerini güncelleştirme v2 görevi

Paketlenmiş Service Fabric uygulamasının sürümlerini otomatik olarak güncelleştirmek için bu görevi derleme işlem hattında kullanın. Bu görev, bir Azure Service Fabric uygulama paketinde bildirim dosyalarında belirtilen tüm hizmet ve uygulama sürümlerine bir sürüm son eki ekler.

Syntax

# Update Service Fabric manifests v2
# Automatically update portions of application and service manifests in a packaged Azure Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.
# Update Service Fabric Manifests v2
# Automatically updates portions of the application and service manifests within a packaged Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

Girişler

updateType - Güncelleştirme Türü
string. Gereklidir. İzin verilen değerler: Manifest versions, Docker image settings. Varsayılan değer: Manifest versions.

Bildirim dosyalarında yapılması gereken güncelleştirme türünü belirtir. Her iki güncelleştirme türünü de kullanmak için, yürütülecek her güncelleştirme türü için derleme işlem hattına bu görevin bir örneğini ekleyin.


applicationPackagePath - Uygulama Paketi
string. Gereklidir.

Uygulama paketinin yolunu belirtir. Değişkenler ve joker karakterler yolda kullanılabilir. applicationPackagePath veya sonunda eğik çizgi \/olmamalıdır.


versionSuffix - Sürüm Değeri
string. olduğunda updateType = Manifest versionsgereklidir. Varsayılan değer: .$(Build.BuildNumber).

Bildirim dosyalarındaki sürümü belirtir.

İpucu

Bir değişkeni bir biçimde dinamik olarak ayarlamak için derleme numarası biçimini doğrudan değiştirebilir veya günlük komutunu kullanabilirsiniz. Örneğin, bir PowerShell görevinde tanımlı seçeneğini kullanabilirsiniz $(VersionSuffix) :

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - Sürüm Davranışı
string. İsteğe bağlı. olduğunda updateType = Manifest versionskullanın. İzin verilen değerler: Append, Replace. Varsayılan değer: Append.

Sürüm değerinin bildirim dosyalarındaki mevcut değerlere eklenip eklenmeyeceğini veya değiştirilmeyeceğini belirtir.


updateOnlyChanged - Yalnızca değiştirildiğinde güncelleştir
boolean. İsteğe bağlı. olduğunda updateType = Manifest versionskullanın. Varsayılan değer: false.

Yeni sürüm son ekini yalnızca önceki derlemeden değiştirilmiş paketlere ekler. Hiçbir değişiklik bulunmazsa, önceki derlemenin sürüm soneki eklenir.

Not

Varsayılan olarak, hiçbir değişiklik yapılmamış olsa bile derleyici farklı çıkışlar oluşturur. Aynı girişlere sahip derlemelerin aynı çıkışları ürettiğinden emin olmak için deterministik derleyici bayrağını kullanın.


pkgArtifactName - Paket Yapıtı Adı
string. İsteğe bağlı. olduğunda updateType = Manifest versions && updateOnlyChanged = truekullanın.

Karşılaştırma için uygulama paketini içeren yapıtın adını belirtir.


logAllChanges - Tüm değişiklikleri günlüğe kaydet
boolean. İsteğe bağlı. olduğunda updateType = Manifest versions && updateOnlyChanged = truekullanın. Varsayılan değer: true.

Dosya eklendiyse, kaldırıldıysa veya içeriği değiştiyse, her paketteki ve günlükteki tüm dosyaları karşılaştırır. Aksi takdirde, bu boole değeri bir paketteki dosyaları yalnızca ilk değişiklik daha hızlı performans için bulunana kadar karşılaştırır.


compareType - Karşılaştırma
string. İsteğe bağlı. olduğunda updateType = Manifest versions && updateOnlyChanged = truekullanın. İzin verilen değerler: LastSuccessful (Son Başarılı Derleme), Specific (Belirli Derleme). Varsayılan değer: LastSuccessful.

Son tamamlanan ve başarılı derlemeyle mi yoksa belirli bir derlemeyle mi karşılaştırılmayacağını belirtir.


buildNumber - Derleme Numarası
string. İsteğe bağlı. olduğunda updateType = Manifest versions && compareType = Specifickullanın.

Karşılaştırma için derleme numarasını belirtir.


overwriteExistingPkgArtifact - Varolan Paket Yapıtı üzerine yazma
boolean. İsteğe bağlı. olduğunda updateType = Manifest versions && updateOnlyChanged = truekullanın. Varsayılan değer: true.

Yapıtın yeni bir kopyasını indirir. Aksi takdirde, bu boole varsa mevcut bir kopya kullanır.


imageNamesPath - Resim Adları Yolu
string. İsteğe bağlı. olduğunda updateType = Docker image settingskullanın.

Özetlerle güncelleştirilmesi gereken Service Fabric uygulamasıyla ilişkili Docker görüntülerinin adlarını içeren bir metin dosyasının yolunu belirtir. Her görüntü adı kendi satırında olmalı ve Görüntü Özetleri dosyasındaki özetlerle aynı sırada olmalıdır. Görüntüler Service Fabric projesi tarafından oluşturulduysa, bu dosya Paket hedefinin bir parçası olarak oluşturulur ve çıkış konumu özelliği BuiltDockerImagesFilePathtarafından denetlenir.


imageDigestsPath - Görüntü Özetleri Yolu
string. olduğunda updateType = Docker image settingsgereklidir.

Service Fabric uygulamasıyla ilişkili Docker görüntülerinin özet değerlerini içeren bir metin dosyasının yolunu belirtir. Bu dosya, gönderme eylemi kullanılırken Docker görevi tarafından çıkış olarak kullanılabilir. Dosya biçiminde metin registry/image_name@digest_valuesatırları içermelidir.


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

Paketlenmiş Service Fabric uygulamasının sürümlerini otomatik olarak güncelleştirmek için bu görevi derleme işlem hattında kullanın. Bu görev, bir Azure Service Fabric uygulama paketinde bildirim dosyalarında belirtilen tüm hizmet ve uygulama sürümlerine bir sürüm son eki ekler.

Not

Bu görev Windows PowerShell gerektirir.

Bu görev yayın işlem hatlarında kullanılamaz.

Bu görev yalnızca paketlenmiş Service Fabric uygulamasının sürümlerini otomatik olarak güncelleştirmek için derleme işlem hattında kullanılabilir.

Bu görev iki tür güncelleştirmesi destekler:

  1. Bildirim sürümü: Service fabric uygulama paketindeki bildirim dosyalarında belirtilen Hizmet ve Uygulama sürümlerini Güncelleştirmeler. Belirtilirse, manifest version geçerli dosyaları önceki bir derlemeyle karşılaştırır ve sürümü yalnızca değiştirilen hizmetler için güncelleştirir.

  2. Docker görüntü ayarları: Service fabric uygulama paketindeki bildirim dosyalarında belirtilen docker kapsayıcı görüntüsü ayarlarını Güncelleştirmeler. Yerleştirilecek görüntü ayarları iki dosyadan seçilir:

    a. Görüntü adları dosyası: Bu dosya derleme görevi tarafından oluşturulur.

    b. Görüntü özetleri dosyası: Bu dosya, görüntüleri kayıt defterine gönderirken docker görevi tarafından oluşturulur.

Örnekler

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme
Üzerinde çalıştırılır Agent, DeploymentGroup
Talep Şirket içinde barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: Cmd
Özellikler Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 1.95.0 veya üzeri
Görev kategorisi Yardımcı Program