Service Fabric bildirimleri görevini Güncelleştir

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Not

TFS 2017 ' de bu görevde güncelleştirme Service Fabric uygulama sürümleri görevi adı verilir.

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

Not

Bu görev için Windows PowerShell gereklidir.

Bu görev, yayın işlem hatları 'nda henüz kullanılamaz.

Erişim

Hiçbiri

YAML kod parçacığı

# Update Service Fabric manifests
# Automatically update portions of application and service manifests in a packaged Azure Service Fabric application
- task: ServiceFabricUpdateManifests@2
  inputs:
    #updateType: 'Manifest versions' # Options: manifest Versions, docker Image Settings
    applicationPackagePath: 
    #versionSuffix: '.$(Build.BuildNumber)' # Required when updateType == Manifest Versions
    #versionBehavior: 'Append' # Optional. Options: append, replace
    #updateOnlyChanged: false # Required when updateType == Manifest Versions
    #pkgArtifactName: # Required when updateType == Manifest versions && updateOnlyChanged == true
    #logAllChanges: true # Optional
    #compareType: 'LastSuccessful' # Optional. Options: lastSuccessful, specific
    #buildNumber: # Optional
    #overwriteExistingPkgArtifact: true # Optional
    #imageNamesPath: # Optional
    #imageDigestsPath: # Required when updateType == Docker Image Settings

Bağımsız değişkenler

Bağımsız Değişken Açıklama
Uygulama paketi Kümeye dağıtılacak Service Fabric uygulama paketinin konumu.
Örnek: $(system.defaultworkingdirectory)/**/drop/applicationpackage
Joker karakterler ve değişkenler içerebilir.
Sürüm değeri Bildirim dosyalarındaki sürümlere eklenen değer. .$(Build.BuildNumber) varsayılan değerdir.
İpucu: Yapı numarası biçimini doğrudan değiştirebilir veya bir günlük komutunu kullanarak bir değişkeni herhangi bir biçimde dinamik olarak ayarlayabilirsiniz. Örneğin, $(VersionSuffix) bir PowerShell görevinde tanımlı ' i kullanabilirsiniz:
$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"
Sürüm davranışı Sürüm değerinin bildirim dosyalarındaki mevcut değerlere eklenip eklenmeyeceğini belirtin veya onları değiştirin.
Yalnızca değiştirildiyse Güncelleştir Yeni sürüm son ekini yalnızca önceki derlemeden değiştirilmiş olan paketlere eklemek için bu onay kutusunu işaretleyin. Hiçbir değişiklik bulunamazsa, önceki derlemenin sürüm soneki eklenir.
Not: Varsayılan olarak, hiçbir değişiklik yapmış olsa bile derleyici farklı çıkışlar oluşturur. Aynı girişlere sahip derlemelerin aynı çıkışları üretmesini sağlamak için belirleyici derleyici bayrağını kullanın.
Paket Yapıt Adı Önceki derlemeden uygulama paketini içeren yapıt adı.
Tüm değişiklikleri günlüğe kaydedilir Dosya eklendi mi, kaldırıldı mı yoksa içeriği değişti mi? her paket ve günlükte yer alan tüm dosyaları karşılaştırmak için bu onay kutusunu işaretleyin. Aksi takdirde, bir pakette bulunan dosyaları yalnızca daha hızlı performans için ilk değişiklik bulunana kadar karşılaştırın.
Karşılaştırma Son tamamlanan, başarılı derlemeyle mi yoksa belirli bir derlemeyle mi karşılaştırılacaklarını belirtin.
Derleme Numarası Belirli bir derlemeyle karşılaştırıyorsanız, kullanmak için derleme numarası.
Denetim seçenekleri

Ayrıca bkz. Service Fabric Dağıtım görevi

Bu görev yalnızca bir derleme işlem hattında, paketlenmiş bir uygulamanın sürümlerini otomatik olarak Service Fabric kullanılabilir.

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

  1. Bildirim sürümü: Service Fabric uygulama paketinde bildirim dosyalarında belirtilen Hizmet ve Uygulama sürümlerini güncelleştirecek. Belirtilen, geçerli dosyaları önceki bir derleme ve güncelleştirme sürümüyle yalnızca değiştirilmiş hizmetler için karşılaştırıldığında.

  2. Docker görüntü ayarları: Service Fabric uygulama paketinde bildirim dosyalarında belirtilen docker kapsayıcı görüntüsü ayarlarını güncelleştirecek. Yerleştirilsin görüntü ayarları iki dosyadan seçilsin:

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

    b. Image dıgests dosyası: Bu dosya, görüntüleri kayıt defterine ilettiğinde Docker görevi tarafından oluşturulur

Görev girişleri

Parametre Ad Açıklama
updateType Güncelleştirme türü Istenir Bildirim dosyalarında yapılması gereken güncelleştirme türünü belirtin. Her iki güncelleştirme türünü kullanmak için, yürütülecek her güncelleştirme türü için derleme ardışık düzenine bu görevin bir örneğini ekleyin. Varsayılan değer: bildirim sürümleri
applicationPackagePath Uygulama paketi Istenir Uygulama paketinin yolu. Değişkenler ve joker karakterler yolda kullanılabilir
versionSuffix Sürüm değeri Istenir Bildirim dosyalarındaki sürümü belirtmek için kullanılan değer. Varsayılan değer. $ (Build. BuildNumber). Varsayılan değer:. $ (Build. BuildNumber)
versionBehavior Sürüm davranışı Sürüm değerinin bildirim dosyalarındaki mevcut değerlere eklenip eklenmeyeceğini belirtin veya onları değiştirin. Varsayılan değer: Append
updateOnlyChanged Yalnızca değiştirildiyse Güncelleştir Istenir Yalnızca değiştirilen paketleri artımlı olarak güncelleştirin. Aynı girdileri taşıyan derlemelerin aynı çıkışları üretmesi için belirleyici derleyici bayrağını kullanın. Varsayılan değer: false
pkgArtifactName Paket Yapıt Adı Karşılaştırma için uygulama paketini içeren yapıt adı
logAllChanges Tüm değişiklikleri günlüğe kaydedilir Dosya eklendi mi, kaldırıldı mı yoksa içeriği değişti mi her paket ve günlük dosyasındaki tüm dosyaları karşılaştırın. Aksi takdirde, daha hızlı performans için bir pakette yalnızca ilk değişiklik bulunana kadar dosyaları karşılaştırın. Varsayılan değer: true
compareType Karşılaştırma Karşılaştırma için derleme. Varsayılan değer: LastSuccessful
buildNumber Derleme Numarası Karşılaştırma için derleme numarası
overwriteExistingPkgArtifact Var Olan Paket Yapıtlarını Üzerine Yaz Yapının her zaman yeni bir kopyasını indirin. Aksi takdirde mevcut bir kopyayı (varsa) kullanın. Varsayılan değer: true
imageNamesPath Görüntü Adları Yolu Özetlerle güncelleştirilmesi gereken Service Fabric docker görüntülerinin adlarını içeren bir metin dosyasının yolu. Her görüntü adı kendi satırına ait olmalı ve Görüntü Özetleri dosyasındaki özetler ile aynı sırada yer aladır. Görüntüler Service Fabric projesi tarafından oluşturulursa, bu dosya Paket hedefinin bir parçası olarak oluşturulur ve çıkış konumu BuiltDockerImagesFilePath özelliği tarafından denetlenır
imageDigestsPath Görüntü Özetleri Yolu (Gerekli) Uygulamayla ilişkilendirilmiş Docker görüntülerinin özet değerlerini içeren bir metin dosyasının Service Fabric yolu. Bu dosya, push eylemi kullanılırken Docker görevi tarafından çıkış yapılabilir. Dosya ' ' biçiminde metin satırları içermelidir registry/image_name@digest_value

Örnek

Ayrıca bkz. uygulama dağıtım görevi Service Fabric

Açık kaynak

Bu görev GitHub 'daaçık kaynaktır. Geribildirim ve katılımlar hoş geldiniz.

SSS

Bir aracıya ihtiyacım var mı?

Yapınızı veya sürümünüzü çalıştırmak için en az bir aracınız olması gerekir.

Sorun yaşıyorum. Sorunları nasıl giderebilirim?

Bkz. derleme ve yayın sorunlarını giderme.

Varsayılan bir aracı havuzu seçemiyorum ve derleme veya yayınımı sıraya alamıyorum. Bu Nasıl yaparım? düzeltilsin mi?

Bkz. Aracı havuzları.

NuGet Push görevlerim şu hata ile başarısız oluyor: "hata: yerel veren sertifikası alınamıyor". Bunu nasıl giderebilirim?

Bu, güvenilen kök sertifika eklenerek düzeltilebilir. NODE_EXTRA_CA_CERTS=fileOrtam değişkenini yapı aracıya ekleyebilir veya NODE.EXTRA.CA.CERTS=file görev değişkenini işlem hattınızda ekleyebilirsiniz. Daha fazla ayrıntı için bkz. ortam değişkenleri .

TFS 'yi şirket içinde kullanıyorum ve bu özelliklerden bazılarını görmüyorum. Neden olmasın?

Bu özelliklerden bazıları yalnızca Azure Pipelines kullanılabilir ve şirket içinde henüz kullanılabilir değil. TFS 'nin en son sürümüne yükselttiysenizbazı özellikler şirket içinde kullanılabilir.