Udostępnij za pośrednictwem

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

  • Artykuł

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.

Uwaga

To zadanie nie obsługuje uwierzytelniania przy użyciu usługi Azure Resource Manager z federacją 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

pakietu aplikacji applicationPackagePath -
string. To jest 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łączenia z usługą klastra
string. To jest wymagane.

Określa połączenie usługi Azure Service Fabric, które ma być używane do nawiązywania połączenia z klastrem. Ustawienia zdefiniowane w tym odwołaniu do połączenia usługi zastępują te zdefiniowane w profilu publikowania. Wybierz Manage, aby zarejestrować nowe połączenie 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 oczyszczony, co wpłynie na drugą wersję.


publikowania profilu publishProfilePath -
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 na temat tworzenia profilów publikowania w programie Visual Studio.


parametrów aplikacji applicationParameterPath -
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 tym, jak utworzyć plik parametrów aplikacji w programie Visual Studio.


overrideApplicationParameter - przesłanianie parametrów aplikacji
boolean. Wartość domyślna: false.

Opcjonalny. Określa zmienne zdefiniowane w potoku kompilacji lub wydania są dopasowywane do wpisów Parameter Name w pliku manifestu aplikacji. Dowiedz się więcej o tym, jak utworzyć plik 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 być 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 rejestracji lub wyrejestrowania pakietu aplikacji.


overwriteBehavior - zachowanie zastępowania
string. To jest wymagane. Dozwolone wartości: Always, Never, SameAppTypeAndVersion. Wartość domyślna: SameAppTypeAndVersion.

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

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

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

SameAppTypeAndVersion usunie istniejącą aplikację tylko wtedy, gdy jej typ i wersja 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. W przypadku włączenia ponowne wdrożenia są idempotentne.


skipPackageValidation - pomiń sprawdzanie poprawności pakietu
boolean. Wartość domyślna: false.

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


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

Opcjonalny. Uaktualnienia 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óżnic .


overridePublishProfileSettings - zastąpić 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 określono). 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 wartość 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 - limitu 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 - ConsiderWarningAsError
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 - MaxPercentUnhealthyDeployedApplications
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ła poświadczeń rejestru
string. Wymagane, gdy configureDockerSettings = true. Dozwolone wartości: AzureResourceManagerEndpoint (połączenie z usługą Azure Resource Manager), ContainerRegistryEndpoint (połączenie z usługą rejestru kontenerów), UsernamePassword (nazwa użytkownika i hasło). Wartość domyślna: AzureResourceManagerEndpoint.

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


dockerRegistryConnection - połączenia 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ć klucz 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, klucz tajny rejestru nie zostanie zaszyfrowany.


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

Określa subskrypcję platformy Azure.

Uwaga

Zadanie podejmie próbę zaszyfrowania wpisu tajnego 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, klucz 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.


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

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


passwordEncrypted - password Encrypted
boolean. Opcjonalny. Użyj polecenia , gdy configureDockerSettings = true && registryCredentials = UsernamePassword. Wartość domyślna: true.

Hasło należy zaszyfrować przy użyciu Invoke-ServiceFabricEncryptText. Jeśli nie, a certyfikat pasujący do odcisku palca certyfikatu serwera w połączeniu z usługą 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 zadaniami

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

Zmienne wyjściowe

Żaden.

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 się i wdrażania w klastrze usługi Service Fabric. Pobierz i zainstaluj usługi Service Fabric na agencie kompilacji.

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do 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ń Jakikolwiek
zmienne ustawiane Jakikolwiek
Wersja agenta 1.95.0 lub nowsza
Kategoria zadań Wdroż