Partager via


AzureCloudPowerShellDeployment@1 - Tâche de déploiement du service cloud Azure v1

Déployer un service cloud Azure.

Syntaxe

# Azure Cloud Service deployment v1
# Deploy an Azure Cloud Service.
- task: AzureCloudPowerShellDeployment@1
  inputs:
    azureClassicSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription (Classic). 
    #EnableAdvancedStorageOptions: false # boolean. Enable ARM storage support. Default: false.
    StorageAccount: # string. Required when EnableAdvancedStorageOptions = false. Storage account (Classic). 
    #ARMConnectedServiceName: # string. Required when EnableAdvancedStorageOptions = true. Azure subscription (ARM). 
    #ARMStorageAccount: # string. Required when EnableAdvancedStorageOptions = true. Storage account (ARM). 
    ServiceName: # string. Required. Service name. 
    ServiceLocation: # string. Required. Service location. 
    CsPkg: # string. Required. CsPkg. 
    CsCfg: # string. Required. CsCfg. 
    slotName: 'Production' # string. Alias: Slot. Required. Environment (Slot). Default: Production.
    #DeploymentLabel: '$(Build.BuildNumber)' # string. Deployment label. Default: $(Build.BuildNumber).
    #AppendDateTimeToLabel: false # boolean. Append current date and time. Default: false.
    #AllowUpgrade: true # boolean. Allow upgrade. Default: true.
    #SimultaneousUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Simultaneous upgrade. Default: false.
    #ForceUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Force upgrade. Default: false.
    #VerifyRoleInstanceStatus: false # boolean. Verify role instance status. Default: false.
  # Advanced Options For Creating New Service
    #DiagnosticStorageAccountKeys: # string. Diagnostic storage account keys. 
    #NewServiceCustomCertificates: # string. Custom certificates to import. 
    #NewServiceAdditionalArguments: # string. Additional arguments. 
    #NewServiceAffinityGroup: # string. Affinity group.
# Azure Cloud Service deployment v1
# Deploy an Azure Cloud Service.
- task: AzureCloudPowerShellDeployment@1
  inputs:
    azureClassicSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription (Classic). 
    StorageAccount: # string. Required. Storage account. 
    ServiceName: # string. Required. Service name. 
    ServiceLocation: # string. Required. Service location. 
    CsPkg: # string. Required. CsPkg. 
    CsCfg: # string. Required. CsCfg. 
    slotName: 'Production' # string. Alias: Slot. Required. Environment (Slot). Default: Production.
    #DeploymentLabel: '$(Build.BuildNumber)' # string. Deployment label. Default: $(Build.BuildNumber).
    #AppendDateTimeToLabel: false # boolean. Append current date and time. Default: false.
    #AllowUpgrade: true # boolean. Allow upgrade. Default: true.
    #SimultaneousUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Simultaneous upgrade. Default: false.
    #ForceUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Force upgrade. Default: false.
    #VerifyRoleInstanceStatus: false # boolean. Verify role instance status. Default: false.
  # Advanced Options For Creating New Service
    #DiagnosticStorageAccountKeys: # string. Diagnostic storage account keys. 
    #NewServiceCustomCertificates: # string. Custom certificates to import. 
    #NewServiceAdditionalArguments: # string. Additional arguments. 
    #NewServiceAffinityGroup: # string. Affinity group.
# Azure Cloud Service Deployment v1
# Deploy an Azure Cloud Service.
- task: AzureCloudPowerShellDeployment@1
  inputs:
    azureClassicSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription (Classic). 
    StorageAccount: # string. Required. Storage account. 
    ServiceName: # string. Required. Service name. 
    ServiceLocation: # string. Required. Service location. 
    CsPkg: # string. Required. CsPkg. 
    CsCfg: # string. Required. CsCfg. 
    slotName: 'Production' # string. Alias: Slot. Required. Environment (Slot). Default: Production.
    #DeploymentLabel: '$(Build.BuildNumber)' # string. Deployment label. Default: $(Build.BuildNumber).
    #AppendDateTimeToLabel: false # boolean. Append current date and time. Default: false.
    #AllowUpgrade: true # boolean. Allow upgrade. Default: true.
    #SimultaneousUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Simultaneous upgrade. Default: false.
    #ForceUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Force upgrade. Default: false.
    #VerifyRoleInstanceStatus: false # boolean. Verify role instance status. Default: false.
  # Advanced Options For Creating New Service
    #DiagnosticStorageAccountKeys: # string. Diagnostic storage account keys. 
    #NewServiceCustomCertificates: # string. Custom certificates to import. 
    #NewServiceAdditionalArguments: # string. Additional arguments. 
    #NewServiceAffinityGroup: # string. Affinity group.

Entrées

azureClassicSubscription - Abonnement Azure (Classique)
Alias d’entrée : ConnectedServiceName. string. Obligatoire.

Abonnement Azure à cibler pour le déploiement.


EnableAdvancedStorageOptions - Activer la prise en charge du stockage ARM
boolean. Valeur par défaut : false.

Active ou désactive la prise en charge du stockage ARM.


StorageAccount - Compte de stockage (classique)
string. Nécessaire lorsque EnableAdvancedStorageOptions = false.

Le compte de stockage doit exister avant le déploiement.


StorageAccount - Compte de stockage
string. Obligatoire.

Le compte de stockage doit exister avant le déploiement.


ARMConnectedServiceName - Abonnement Azure (ARM)
string. Nécessaire lorsque EnableAdvancedStorageOptions = true.

Abonnement ARM.


ARMStorageAccount - Compte de stockage (ARM)
string. Nécessaire lorsque EnableAdvancedStorageOptions = true.

Un compte de stockage ARM préexistant.


ServiceName - Nom du service
string. Obligatoire.

Un nom de service cloud existant.


ServiceLocation - Emplacement du service
string. Obligatoire.

Région pour le déploiement d’un nouveau service. Les options sont les suivantes : USA Est, USA Est 2, USA Centre, USA Centre Sud, USA Ouest, Europe Nord, Europe Ouest, etc.


CsPkg - CsPkg
string. Obligatoire.

Chemin d’accès au CsPkg dans le répertoire d’artefacts par défaut.


CsCfg - CsCfg
string. Obligatoire.

Chemin D’accès CsCfg dans le répertoire d’artefacts par défaut.


slotName - Environnement (emplacement)
Alias d’entrée : Slot. string. Obligatoire. Valeur par défaut : Production.

Définissez cette valeur sur « Préproduction » ou utilisez la valeur par défaut.


DeploymentLabel - Étiquette de déploiement
string. Valeur par défaut : $(Build.BuildNumber).

Spécifie le nom d’étiquette pour le nouveau déploiement. S’il n’est pas spécifié, est défini par défaut sur un identificateur global unique (GUID).


AppendDateTimeToLabel - Ajouter la date et l’heure actuelles
boolean. Valeur par défaut : false.

Ajoute la date et l’heure actuelles à l’étiquette de déploiement.


AllowUpgrade - Autoriser la mise à niveau
boolean. Valeur par défaut : true.

Autorise une mise à niveau vers le déploiement Microsoft Azure.


SimultaneousUpgrade - Mise à niveau simultanée
boolean. facultatif. Utilisez quand AllowUpgrade == true. Valeur par défaut : false.

Met à niveau toutes les instances à la fois. Votre service cloud n’est pas disponible pendant cette période.


ForceUpgrade - Forcer la mise à niveau
boolean. facultatif. Utilisez quand AllowUpgrade == true. Valeur par défaut : false.

Définit une mise à niveau forcée. Forcer une mise à niveau peut entraîner la perte de données locales.


VerifyRoleInstanceStatus - Vérifier les instance status de rôle
boolean. Valeur par défaut : false.

Provoque l’attente de la tâche jusqu’à ce que les instances de rôle soient à l’état prêt.


DiagnosticStorageAccountKeys - Clés de compte de stockage de diagnostic
string.

Mettez en forme la chaîne de clé de stockage en tant que Role:Storagekey. Le nom du compte de stockage diagnostics pour chaque rôle est récupéré à partir du fichier de configuration de diagnostic (.wadcfgx).

  • Si le fichier .wadcfgx d’un rôle est introuvable : l’extension de diagnostic n’est pas définie pour ce rôle.
  • Si le nom du compte de stockage est introuvable dans le fichier .wadcfgx : le compte de stockage par défaut est utilisé pour stocker les résultats de diagnostic et les paramètres de clé de stockage de la tâche de déploiement sont ignorés.

REMARQUE : S’il existe des informations sensibles dans les résultats de diagnostic pour votre environnement, enregistrez le storage_account_key en tant que variable secrète. Par exemple :

  • WebRole : WebRole_storage_account_key
  • WorkerRole : WorkerRole_stoarge_account_key

NewServiceCustomCertificates - Certificats personnalisés à importer
string.

Mettez en forme la chaîne de certificat personnalisée en tant que CertificatePfxBase64:CertificatePassword. Enregistrez le certificate_password en tant que variable secrète. Par exemple :

  • Certificate1 : Certificate1_password
  • Certificate2 : Certificate2_password

NewServiceAdditionalArguments - Arguments supplémentaires
string.

Transmet des arguments supplémentaires lors de la création d’un service. Les arguments sont passés à l’applet de New-AzureService commande . Par exemple : -Label 'MyTestService'.


NewServiceAffinityGroup - Groupe d’affinités
string.

Groupe d’affinités utilisé à la place de l’emplacement du service lors de la création d’un service.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche pour déployer un service cloud Azure.

Spécifications

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent
Demandes Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : azureps
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande Quelconque
Variables paramétrables Quelconque
Version de l’agent 1.103.0 ou version ultérieure
Catégorie de la tâche Déployer