ServiceFabricDeploy@1 — zadanie wdrażania aplikacji usługi Service Fabric w wersji 1

To zadanie służy do wdrażania aplikacji usługi Service Fabric w klastrze. To zadanie służy do wdrażania aplikacji usługi Azure Service Fabric w klastrze zgodnie z ustawieniami zdefiniowanymi w profilu publikowania.

Uwaga

To zadanie nie obsługuje uwierzytelniania usługi Azure Resource Manager za pomocą federacji tożsamości przepływu pracy.

Składnia

# Service Fabric application deployment v1
# Deploy an Azure Service Fabric application to a cluster.
- task: ServiceFabricDeploy@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    serviceConnectionName: # string. Required. Cluster Service Connection. 
    #publishProfilePath: # string. Publish Profile. 
    #applicationParameterPath: # string. Application Parameters. 
    #overrideApplicationParameter: false # boolean. Override Application Parameters. Default: false.
  # Advanced Settings
    #compressPackage: false # boolean. Compress Package. Default: false.
    #copyPackageTimeoutSec: # string. CopyPackageTimeoutSec. 
    #registerPackageTimeoutSec: # string. RegisterPackageTimeoutSec. 
    overwriteBehavior: 'SameAppTypeAndVersion' # 'Always' | 'Never' | 'SameAppTypeAndVersion'. Required. Overwrite Behavior. Default: SameAppTypeAndVersion.
    #skipUpgradeSameTypeAndVersion: false # boolean. Skip upgrade for same Type and Version. Default: false.
    #skipPackageValidation: false # boolean. Skip package validation. Default: false.
  # Upgrade Settings
    #useDiffPackage: false # boolean. Use Diff Package. Default: false.
    #overridePublishProfileSettings: false # boolean. Override All Publish Profile Upgrade Settings. Default: false.
    #isUpgrade: true # boolean. Optional. Use when overridePublishProfileSettings = true. Upgrade the Application. Default: true.
    #unregisterUnusedVersions: true # boolean. Unregister Unused Versions. Default: true.
    #upgradeMode: 'Monitored' # 'Monitored' | 'UnmonitoredAuto' | 'UnmonitoredManual'. Required when overridePublishProfileSettings = true && isUpgrade = true. Upgrade Mode. Default: Monitored.
    #FailureAction: 'Rollback' # 'Rollback' | 'Manual'. Required when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. FailureAction. Default: Rollback.
    #UpgradeReplicaSetCheckTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. UpgradeReplicaSetCheckTimeoutSec. 
    #TimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. TimeoutSec. 
    #ForceRestart: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. ForceRestart. Default: false.
    #HealthCheckRetryTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckRetryTimeoutSec. 
    #HealthCheckWaitDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckWaitDurationSec. 
    #HealthCheckStableDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckStableDurationSec. 
    #UpgradeDomainTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeDomainTimeoutSec. 
    #ConsiderWarningAsError: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ConsiderWarningAsError. Default: false.
    #DefaultServiceTypeHealthPolicy: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. DefaultServiceTypeHealthPolicy. 
    #MaxPercentUnhealthyDeployedApplications: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. MaxPercentUnhealthyDeployedApplications. 
    #UpgradeTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeTimeoutSec. 
    #ServiceTypeHealthPolicyMap: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ServiceTypeHealthPolicyMap. 
  # Docker Settings
    #configureDockerSettings: false # boolean. Configure Docker settings. Default: false.
    #registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword'. Required when configureDockerSettings = true. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Required when configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Password Encrypted. Default: true.

Dane wejściowe

applicationPackagePath - Pakiet aplikacji
string. Wymagane.

Określa ścieżkę do pakietu aplikacji, który ma zostać wdrożony. Zmienne i symbole wieloznaczne mogą być używane w ścieżce.

serviceConnectionName - Połączenie z usługą klastra
string. Wymagane.

Określa połączenie usługi Azure Service Fabric, które ma być używane do łączenia się z klastrem. Ustawienia zdefiniowane w tym odwołaniu do połączenia z usługą zastępują ustawienia zdefiniowane w profilu publikowania. Wybierz Manage opcję zarejestrowania nowego połączenia z usługą.

Aby nawiązać połączenie z klastrem, zadanie usługi Service Fabric używa magazynu certyfikatów maszyny do przechowywania informacji o certyfikacie. Jeśli dwie wersje są uruchamiane razem na jednej maszynie przy użyciu tego samego certyfikatu, zostaną one uruchomione prawidłowo. Jeśli jednak jedno z zadań zostanie ukończone, certyfikat z magazynu certyfikatów komputera zostanie wyczyszczony, co ma wpływ na drugą wersję.

publishProfilePath - Publikowanie profilu
string.

Opcjonalny. Określa ścieżkę do pliku profilu publikowania, który definiuje ustawienia do użycia. Zmienne i symbole wieloznaczne mogą być używane w ścieżce. Dowiedz się więcej o sposobie tworzenia profilów publikowania w programie Visual Studio.

applicationParameterPath - Parametry aplikacji
string.

Opcjonalny. Określa ścieżkę do pliku parametrów aplikacji. Zmienne i symbole wieloznaczne mogą być używane w ścieżce. Jeśli zostanie określony, spowoduje to zastąpienie wartości w profilu publikowania. Dowiedz się więcej o sposobie tworzenia pliku parametrów aplikacji w programie Visual Studio.

overrideApplicationParameter - Zastępowanie parametrów aplikacji
boolean. Wartość domyślna: false.

Opcjonalny. Określa zmienne zdefiniowane w potoku kompilacji lub wydania są dopasowywane do Parameter Name wpisów w pliku manifestu aplikacji. Dowiedz się więcej o sposobie tworzenia pliku parametrów aplikacji w programie Visual Studio. Przykład:

 <Parameters> 
 <Parameter Name="SampleApp_PartitionCount" Value="1" /> 
 <Parameter Name="SampleApp_InstanceCount" DefaultValue="-1" /> 
 </Parameters>

Jeśli aplikacja ma parametr zdefiniowany w powyższym przykładzie i chcesz zmienić liczbę partycji na 2, możesz zdefiniować potok wydania lub zmienną środowiskową SampleApp_PartitionCount i jej wartość jako 2.

Uwaga

Jeśli te same zmienne są zdefiniowane w potoku wydania i w środowisku, zmienne środowiskowe zastąpią zmienne potoku wydania.

compressPackage - Kompresuj pakiet
boolean. Wartość domyślna: false.

Opcjonalny. Określa, czy pakiet aplikacji powinien zostać skompresowany przed skopiowaniem do magazynu obrazów. Jeśli ta opcja jest włączona, spowoduje to zastąpienie wartości w profilu publikowania. Dowiedz się więcej o kompresowaniu pakietów.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Opcjonalny. Określa limit czasu w sekundach kopiowania pakietu aplikacji do magazynu obrazów. Jeśli zostanie określony, spowoduje to zastąpienie wartości w profilu publikowania.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Opcjonalny. Określa limit czasu w sekundach na potrzeby rejestrowania lub wyrejestrowania pakietu aplikacji.

overwriteBehavior - Zachowanie zastępowania
string. Wymagane. Dozwolone wartości: Always, Never, SameAppTypeAndVersion. Wartość domyślna: SameAppTypeAndVersion.

Zastępuje zachowanie, jeśli aplikacja istnieje w klastrze o tej samej nazwie i nie skonfigurowano uaktualnień.

Never program nie usunie istniejącej aplikacji. Jest to zachowanie domyślne.

Always Program usunie istniejącą aplikację, nawet jeśli jej typ i wersja różnią się od tworzonej aplikacji.

SameAppTypeAndVersion Program usunie istniejącą aplikację tylko wtedy, gdy jej typ i wersja aplikacji są takie same jak tworzona aplikacja.

skipUpgradeSameTypeAndVersion - Pomiń uaktualnianie dla tego samego typu i wersji
boolean. Wartość domyślna: false.

Opcjonalny. Określa, czy uaktualnienie zostanie pominięte, jeśli ten sam typ aplikacji i wersja już istnieje w klastrze; w przeciwnym razie uaktualnienie kończy się niepowodzeniem podczas walidacji. Jeśli to ustawienie jest włączone, ponowne wdrożenia są idempotentne.

skipPackageValidation - Pomiń walidację pakietu
boolean. Wartość domyślna: false.

Opcjonalny. Określa, czy pakiet powinien zostać zweryfikowany, czy nie przed wdrożeniem. Dowiedz się więcej o sprawdzaniu poprawności pakietu.

useDiffPackage - Korzystanie z pakietu różnicowego
boolean. Wartość domyślna: false.

Opcjonalny. Uaktualnia przy użyciu pakietu różnicowego zawierającego tylko zaktualizowane pliki aplikacji, zaktualizowany manifest aplikacji i pliki manifestu usługi.

Pakiet różnicowy jest tworzony przez porównanie pakietu określonego w danych wejściowych pakietu aplikacji z pakietem, który jest obecnie zarejestrowany w klastrze docelowym. Jeśli wersja usługi w bieżącym pakiecie klastra jest taka sama jak nowy pakiet, ten pakiet usługi zostanie usunięty z nowego pakietu aplikacji. Dowiedz się więcej o pakietach różnicowych.

overridePublishProfileSettings - Zastąpij wszystkie ustawienia uaktualniania profilu publikowania
boolean. Wartość domyślna: false.

Opcjonalny. Zastępuje wszystkie ustawienia uaktualniania z określonymi wartościami lub wartością domyślną (jeśli nie zostanie określona). Dowiedz się więcej o ustawieniach uaktualniania.

isUpgrade - Uaktualnianie aplikacji
boolean. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true. Wartość domyślna: true.

Zastępuje aplikację, jeśli wartość jest ustawiona na false.

unregisterUnusedVersions - Wyrejestrowywanie nieużywanych wersji
boolean. Wartość domyślna: true.

Opcjonalny. Wskazuje, czy wszystkie nieużywane wersje typu aplikacji zostaną usunięte po uaktualnieniu.

upgradeMode - Tryb uaktualniania
string. Wymagane, gdy overridePublishProfileSettings = true && isUpgrade = true. Dozwolone wartości: Monitored, UnmonitoredAuto, UnmonitoredManual. Wartość domyślna: Monitored.

FailureAction - FailureAction
string. Wymagane, gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Dozwolone wartości: Rollback, Manual. Wartość domyślna: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - Limit czasuSec
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true. Wartość domyślna: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - RozważwarningAsError
boolean. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Wartość domyślna: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercent W złej kondycjiDeployedApplications
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Opcjonalny. Użyj polecenia , gdy overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Konfigurowanie ustawień platformy Docker
boolean. Wartość domyślna: false.

Konfiguruje aplikację przy użyciu określonych ustawień platformy Docker.

registryCredentials - Źródło poświadczeń rejestru
string. Wymagane, gdy configureDockerSettings = true. Dozwolone wartości: AzureResourceManagerEndpoint (Połączenie usługi Azure Resource Manager), ContainerRegistryEndpoint (połączenie usługi Container Registry), UsernamePassword (nazwa użytkownika i hasło). Wartość domyślna: AzureResourceManagerEndpoint.

Określa sposób podania poświadczeń dla rejestru platformy Docker.

dockerRegistryConnection - Połączenie usługi rejestru platformy Docker
Alias wejściowy: dockerRegistryEndpoint. string. Wymagane, gdy configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Określa połączenie usługi rejestru platformy Docker. Wymagane w przypadku poleceń, które muszą być uwierzytelniane w rejestrze.

Uwaga

Zadanie próbuje zaszyfrować wpis tajny rejestru przed przesłaniem go do klastra usługi Service Fabric. Jednak zadanie wymaga zainstalowania certyfikatu serwera klastra na maszynie agenta. Jeśli certyfikat nie jest obecny, wpis tajny rejestru nie zostanie zaszyfrowany.

azureSubscription - Subskrypcja platformy Azure
Alias wejściowy: azureSubscriptionEndpoint. string. Wymagane, gdy configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Określa subskrypcję platformy Azure.

Uwaga

Zadanie spróbuje zaszyfrować wpis tajny rejestru przed przesłaniem go do klastra usługi Service Fabric. Jednak zadanie wymaga zainstalowania certyfikatu serwera klastra na maszynie agenta. Jeśli certyfikat nie jest obecny, wpis tajny rejestru nie zostanie zaszyfrowany.

registryUserName - Nazwa użytkownika rejestru
string. Opcjonalny. Użyj polecenia , gdy configureDockerSettings = true && registryCredentials = UsernamePassword.

Określa nazwę użytkownika rejestru platformy Docker.

registryPassword - Hasło rejestru
string. Opcjonalny. Użyj polecenia , gdy configureDockerSettings = true && registryCredentials = UsernamePassword.

Określa hasło rejestru platformy Docker. Jeśli hasło nie jest zaszyfrowane, należy użyć niestandardowej zmiennej tajnej potoku wydania do przechowywania.

passwordEncrypted - Zaszyfrowane hasło
boolean. Opcjonalny. Użyj polecenia , gdy configureDockerSettings = true && registryCredentials = UsernamePassword. Wartość domyślna: true.

Hasło należy zaszyfrować przy użyciu polecenia Invoke-ServiceFabricEncryptText. Jeśli nie, a certyfikat pasujący do odcisku palca certyfikatu serwera w połączeniu usługi klastra jest zainstalowany na agencie kompilacji, ten certyfikat będzie używany do szyfrowania hasła; w przeciwnym razie wystąpi błąd.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

To zadanie służy do wdrażania aplikacji usługi Service Fabric w klastrze. To zadanie wdraża aplikację usługi Azure Service Fabric w klastrze zgodnie z ustawieniami zdefiniowanymi w profilu publikowania.

Service Fabric

To zadanie używa instalacji usługi Service Fabric do łączenia i wdrażania w klastrze usługi Service Fabric. Pobierz i zainstaluj usługę Service Fabric w agencie kompilacji.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: Cmd
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	1.95.0 lub nowsza
Kategoria zadania	Wdrażanie