Mise à niveau de déploiement

Article
08/05/2023

L'opération Upgrade Deployment asynchrone initialise une mise à jour des instances de rôle dans un déploiement à l'aide du package et de la configuration que vous spécifiez.

Requête

La demande Upgrade Deployment peut être spécifiée comme suit. Remplacez <subscription-id> par l'ID d'abonnement, <cloudservice-name> par le nom du service cloud, <deployment-slot> par staging ou production, ou <deployment-name> par le nom du déploiement.

Méthode	URI de demande
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/`
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/`

Paramètres URI

Paramètre d’URI	Description
`comp=upgrade`	Obligatoire. Spécifie que le déploiement doit être mis à jour.

En-têtes de requête

Le tableau suivant décrit les en-têtes de la demande.

En-tête de requête	Description
`Content-Type`	Obligatoire. Définissez cet en-tête sur la valeur `application/xml`.
`x-ms-version`	Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête doit être défini sur `2009-10-01` ou une valeur supérieure.

Corps de la requête

Le corps de la demande présente le format suivant :

  
<?xml version="1.0" encoding="utf-8"?>  
<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Mode>type-of-upgrade</Mode>  
  <PackageUrl>url-to-package</PackageUrl>  
  <Configuration>base64-encoded-config-file</Configuration>  
  <Label>base-64-encoded-label</Label>  
  <RoleToUpgrade>role-name</RoleToUpgrade>  
  <Force>true|false</Force>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>property-name</Name>  
      <Value>property-value</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
</UpgradeDeployment>

Le tableau suivant décrit les éléments du corps de la demande.

Nom de l'élément	Description
Mode	Obligatoire. Spécifie le type de mise à jour à initier. Les instances de rôle sont allouées aux domaines de mise à jour lorsque le service est déployé. Les mises à jour peuvent être appelées manuellement dans chaque domaine de mise à jour ou automatiquement dans tous les domaines de mise à jour. Les valeurs possibles sont les suivantes : - `Auto` - `Manual` - `Simultaneous` Si elle n’est pas spécifiée, la valeur par défaut est `Auto`. Si la valeur est `Manual`définie sur , WalkUpgradeDomain doit être appelé pour appliquer la mise à jour. Si la valeur `Auto` est spécifiée, la mise à jour est automatiquement appliquée à chaque domaine de mise à jour dans l'ordre. Le paramètre `Simultaneous` est uniquement disponible dans la version 2012-12-01 ou une version ultérieure.
PackageUrl	Obligatoire. Spécifie une URL qui fait référence à l'emplacement du package de service dans le service BLOB. Le package de service peut se trouver dans un compte de stockage sous le même abonnement ou dans un URI de signature d'accès partagé (SAS) d'un compte de stockage. Pour plus d’informations sur les signatures d’accès partagé, consultez Délégation d’accès avec une signature d’accès partagé.
Configuration	Obligatoire. Spécifie le fichier de configuration du service codé en base 64 pour le déploiement.
Étiquette	Obligatoire. Spécifie le nom du service cloud codé en base 64. Le nom peut être long de 100 caractères au maximum. Il est recommandé que l'étiquette soit unique au sein de l'abonnement. Il peut être utilisé pour identifier le service cloud à des fins de suivi.
RoleToUpgrade	Optionnel. Spécifie le nom de l'instance de rôle spécifique à mettre à jour. Dans la mise à niveau d’un seul rôle, tous les autres rôles peuvent toujours être recyclés s’il existe une mise à niveau Azure interne planifiée. Le domaine de mise à jour est garanti dans ce scénario.
Force	Obligatoire. Indique si la mise à jour doit continuer même si elle entraîne la perte de données locales de certaines instances de rôle. `True` si la mise à jour doit continuer ; sinon `false`, . L’élément `Force` est disponible uniquement à l’aide de la version 2011-10-01 ou ultérieure.
Nom	facultatif. Spécifie le nom d'une propriété étendue du service cloud. Chaque propriété étendue doit avoir un nom et une valeur définis. Il peut y avoir un maximum de 25 paires nom/valeur de propriété étendue. La longueur maximale de l'élément `Name` est de 64 caractères, seuls les caractères alphanumériques et les traits de soulignement sont valides dans le nom, et le nom doit commencer par une lettre. Toute tentative d'utiliser d'autres caractères, en commençant par un caractère autre qu'une lettre, ou en entrant un nom qui est identique à celui d'une autre propriété étendue détenue par le même service cloud, provoque une erreur de code d'état 400 (erreur de mauvaise demande). L’élément `Name` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
Valeur	Optionnel. Spécifie la valeur d'une propriété étendue du service cloud. Chaque propriété étendue doit avoir un nom et une valeur définis. Vous pouvez avoir 25 paires nom/valeur de propriété étendue au maximum, et chaque valeur de propriété étendue doit avoir une taille maximale de 255 caractères. Vous pouvez supprimer une propriété étendue en définissant la valeur NULL. L’élément `Value` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
ExtensionConfiguration	Optionnel. Spécifie une extension qui est ajoutée au service cloud. Dans Azure, un processus peut fonctionner comme une extension d'un service cloud. Vous devez ajouter une extension au service cloud en utilisant Ajouter une extension avant de pouvoir être ajoutée au déploiement pendant une mise à jour. L’élément `ExtensionConfiguration` est disponible uniquement à l’aide de la version 2013-03-01 ou ultérieure.

ExtensionConfiguration

Spécifie une extension qui est ajoutée au service cloud.

Nom de l'élément	Description
AllRoles	Optionnel. Spécifie une liste d'extensions qui sont appliquées à tous les rôles dans un déploiement.
Extension	Obligatoire. Spécifie une extension qui doit être déployée dans un rôle dans un service cloud.
NamedRoles	Optionnel. Spécifie une liste d'extensions qui sont appliquées aux rôles spécifiques dans un déploiement.

Extension

Spécifie une extension qui doit être déployée dans un rôle dans un service cloud.

Nom de l'élément	Description
Id	Obligatoire. Spécifie l'identificateur de l'extension. L'identificateur est créé lorsque l'extension est ajoutée au service cloud. Vous pouvez trouver l’ID d’une extension qui a été ajoutée à un service cloud à l’aide des extensions de liste.
État	Optionnel. Spécifie l'état de l'extension. Cet élément s'applique uniquement aux extensions JSON configurées. Les valeurs possibles sont les suivantes : - `Enable` - `Disable` - `Uninstall` La valeur par défaut est `Enable`. L’élément `State` est disponible uniquement à l’aide de la version 2014-06-01 ou ultérieure.

NamedRoles

Spécifie une liste d'extensions qui sont appliquées aux rôles spécifiques dans un déploiement.

Nom de l'élément	Description
Role	Obligatoire. Spécifie un rôle spécifique auquel l'extension est ajoutée.
RoleName	Obligatoire. Indique le nom du rôle.
Extension	Obligatoire. Spécifie une extension qui doit être déployée dans un rôle dans un service cloud.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Code d’état

Une opération réussie envoie le code d'état 200 (OK).

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires.

En-tête de réponse	Description
`x-ms-request-id`	Valeur qui identifie de façon unique une demande effectuée au service de gestion. Pour une opération asynchrone, vous pouvez appeler Obtenir l’état de l’opération avec la valeur de l’en-tête pour déterminer si l’opération est terminée, a échoué ou est toujours en cours.

Corps de la réponse

Aucun.

Notes

Pour effectuer une mise à jour automatique d’un déploiement, appelez Déploiement de mise à niveau ou Modifier la configuration de déploiement avec l’élément Mode défini sur automatic. La mise à jour est effectuée à partir de ce point sans qu'aucune autre entrée ne soit requise. Vous pouvez appeler Obtenir l’état de l’opération pour déterminer quand la mise à jour est terminée.

Pour effectuer une mise à jour manuelle, appelez d’abord Le déploiement de mise à niveau avec l’élément Mode défini sur manual. Ensuite, appelez WalkUpgradeDomain pour mettre à jour chaque domaine dans le déploiement. Vous devez vous assurer que l'opération est terminée en appelant l'état de l'opération avant de mettre à jour le domaine suivant.

Une mise à jour qui ajoute ou supprime des instances de rôle provoque une mise à jour de la configuration sur tous les rôles qui sont déployés dans le service cloud. Les instances de rôle existantes doivent être informées des nouvelles instances de rôle afin que toutes les instances de rôle puissent communiquer ensemble dans le service cloud.

Par défaut, un service cloud est déployé avec cinq domaines de mise à jour, qui sont mis à jour un par un pendant une mise à jour sur place.

Pour déterminer le domaine de mise à jour dans lequel une instance spécifique s'exécute, utilisez la propriété UpdateDomain de la classe RoleInstance.

Partager via