Exporter (0) Imprimer
Développer tout

Mettre à niveau un déploiement

Mis à jour: février 2015

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. Pour plus d'informations sur la mise à jour des instances de rôle, consultez Mettre à jour un service Azure.

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>/

Vous devez vous assurer que la demande adressée au service de gestion est sécurisée. Pour plus de détails, consultez Authentification des demandes de gestion des services.

 

Paramètre d'URI Description

comp=upgrade

Obligatoire. Spécifie que le déploiement doit être mis à jour.

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

 

En-tête de demande 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 devrait être défini sur 01.10.09 ou une version ultérieure. Pour plus d'informations sur les en-têtes du suivi de version, consultez Contrôle de version du service de gestion.

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

En l'absence de spécification, la valeur par défaut est Auto. Si la valeur Manual est spécifiée, WalkUpgradeDomain doit être appelé pour effectuer 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

Facultatif. Spécifie le nom de l'instance de rôle spécifique à mettre à jour.

Force

Obligatoire. Indique si la mise à jour doit continuer, même si elle entraîne une perte de données locales dans certaines instances de rôle. True si la mise à jour doit continuer ; sinon false.

L'élément Force est disponible uniquement si vous utilisez la version 01.10.11 ou une version 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 si vous utilisez la version 01.03.12 ou une version ultérieure.

Valeur

Facultatif. 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 si vous utilisez la version 01.03.12 ou une version ultérieure.

ExtensionConfiguration

Facultatif. 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 qu'il puisse être ajouté au déploiement pendant une mise à jour.

L'élément ExtensionConfiguration est disponible uniquement si vous utilisez la version 2013-03-01 ou une version ultérieure.

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

 

Nom de l'élément Description

AllRoles

Facultatif. 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

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

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 trouverez l'Id d'une extension ajoutée à un service cloud à l'aide de List Extensions.

État

Facultatif. 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 si vous utilisez la version 01.06.14 ou une version ultérieure.

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

Rôle

Obligatoire. Spécifie un rôle spécifique auquel l'extension est ajoutée.

RoleName

Obligatoire. Spécifie 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.

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

Une opération ayant réussi renvoie le code d'état 200 (OK). Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur de la gestion des services.

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. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

 

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 Obtention de l'état d'une opération avec la valeur de l'en-tête pour déterminer si l'opération est terminée, si elle a échoué ou si elle est toujours en cours.

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

Pour effectuer une mise à jour manuelle, appelez d'abord Mettre à niveau un déploiement avec l'élément Mode défini sur la valeur manual. Ensuite, appelez Consulter le domaine de mise à niveau 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.

ImportantImportant
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 plus d'informations sur la modification du nombre de domaines de mise à jour dans le fichier de définition de service, consultez Schéma de définition du service Azure (fichier .csdef).

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. Pour plus d'informations, consultez Microsoft Azure Managed Library Reference.

Afficher:
© 2015 Microsoft