Bereitstellung aktualisieren

Artikel
07/19/2023

Der asynchrone Upgrade Deployment-Vorgang initiiert eine Aktualisierung von Rolleninstanzen in einer Bereitstellung mithilfe des angegebenen Pakets und der angegebenen Konfiguration.

Anforderung

Die Upgrade Deployment-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch die Abonnement-ID, <cloudservice-name> durch den Namen des Cloud-Diensts und <deployment-slot> durch staging oder production und <deployment-name> durch den Namen der Bereitstellung.

Methode	Anforderungs-URI
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>/`

URI-Parameter

URI-Parameter	BESCHREIBUNG
`comp=upgrade`	Erforderlich. Gibt an, dass die Bereitstellung aktualisiert werden muss.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
`Content-Type`	Erforderlich. Legen Sie diesen Header auf `application/xml` fest.
`x-ms-version`	Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header sollte auf `2009-10-01` oder höher festgelegt werden.

Anforderungstext

Der Anforderungstext weist das folgende Format auf:

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

In der folgenden Tabelle werden die Elemente im Anforderungstext beschrieben.

Elementname	BESCHREIBUNG
Mode	Erforderlich. Gibt den Typ des zu initiierenden Updates an. Rolleninstanzen werden den Aktualisierungsdomänen zugeordnet, wenn der Dienst bereitgestellt wird. Updates können in jeder Aktualisierungsdomäne manuell initiiert oder in allen Updatedomänen automatisch initiiert werden. Mögliche Werte: - `Auto` - `Manual` - `Simultaneous` Wenn Sie hier nichts angeben, lautet der Standardwert `Auto`. Wenn diese Einstellung auf `Manual`festgelegt ist, muss WalkUpgradeDomain aufgerufen werden, um das Update anzuwenden. Wenn der Wert auf `Auto` festgelegt ist, wird das Update automatisch auf jede Aktualisierungsdomäne nacheinander angewendet. Die `Simultaneous`-Einstellung ist nur in Version 2012-12-01 oder höher verfügbar.
PackageUrl	Erforderlich. Gibt eine URL an, die auf den Speicherort des Dienstpakets im Blob-Dienst verweist. Das Dienstpaket kann sich in einem Speicherkonto unter demselben Abonnement oder einem SAS-URI (Freigegebene Zugriffssignatur) von jedem Speicherkonto befinden. Weitere Informationen zu Shared Access Signatures finden Sie unter Delegating Access with a Shared Access Signature( Delegating Access With a Shared Access Signature).
Konfiguration	Erforderlich. Gibt die Base-64-codierte Dienstkonfigurationsdatei für die Bereitstellung an.
Bezeichnung	Erforderlich. Gibt den Namen für den Cloud-Dienst an, der Base-64-codiert ist. Der Name kann bis zu 100 Zeichen lang sein. Die Bezeichnung sollte innerhalb des Abonnements eindeutig sein. Der Name kann verwendet werden, um den Cloud-Dienst für die Nachverfolgung zu identifizieren.
RoleToUpgrade	Optional. Gibt den Namen der zu aktualisierenden spezifischen Rolleninstanz an. Beim Upgrade einer einzelnen Rolle können alle anderen Rollen weiterhin wiederverwendet werden, wenn ein internes Azure-Upgrade geplant ist. Die Updatedomäne ist in diesem Szenario garantiert.
Force	Erforderlich. Gibt an, ob das Update auch dann fortgesetzt werden soll, wenn lokale Daten aus einigen Rolleninstanzen verloren gehen. `True` , wenn das Update fortgesetzt werden soll; andernfalls `false`. Das `Force` Element ist nur mit Version 2011-10-01 oder höher verfügbar.
Name	Optional. Gibt den Namen einer erweiterten Eigenschaft des Cloud-Diensts an. Jede erweiterte Eigenschaft muss sowohl einen definierten Namen als auch einen definierten Wert aufweisen. Sie können über maximal 25 erweiterte Eigenschaftsnamen und Wertpaare verfügen. Die maximale Länge des `Name`-Elements beträgt 64 Zeichen, nur alphanumerische Zeichen und Unterstriche im Namen sind gültig, und der Name muss mit einem Buchstaben beginnen. Der Versuch, andere Zeichen zu verwenden, mit einem anderen Zeichen als einem Buchstaben zu beginnen oder einen Namen einzugeben, der dem einer anderen erweiterten Eigenschaft desselben Cloud-Diensts entspricht, führt zu einem Fehler des Typs Statuscode 400 (ungültige Anforderung). Das `Name` Element ist nur mit Version 2012-03-01 oder höher verfügbar.
Wert	Optional. Gibt den Wert einer erweiterten Eigenschaft eines Cloud-Diensts an. Jede erweiterte Eigenschaft muss sowohl einen definierten Namen als auch einen definierten Wert aufweisen. Sie können über maximal 25 erweiterte Eigenschaftsnamen und Wertpaare verfügen, und jeder erweiterte Eigenschaftswert kann eine maximale Länge von 255 Zeichen aufweisen. Sie können eine erweiterte Eigenschaft löschen, indem Sie den Wert auf NULL festlegen. Das `Value` Element ist nur mit Version 2012-03-01 oder höher verfügbar.
ExtensionConfiguration	Optional. Gibt eine Erweiterung an, die dem Cloud-Dienst hinzugefügt wird. In Azure kann ein Prozess als Erweiterung eines Cloud-Diensts ausgeführt werden. Sie müssen dem Clouddienst mithilfe von Erweiterung hinzufügen eine Erweiterung hinzufügen, bevor sie während eines Updates zur Bereitstellung hinzugefügt werden kann. Das `ExtensionConfiguration` Element ist nur mit Version 2013-03-01 oder höher verfügbar.

ExtensionConfiguration

Gibt eine Erweiterung an, die dem Cloud-Dienst hinzugefügt wird.

Elementname	BESCHREIBUNG
AllRoles	Optional. Gibt eine Liste von Erweiterungen an, die auf alle Rollen in einer Bereitstellung angewendet werden.
Erweiterung	Erforderlich. Gibt eine Erweiterung an, die für eine Rolle in einem Cloud-Dienst bereitgestellt werden soll.
NamedRoles	Optional. Gibt eine Liste von Erweiterungen an, die auf bestimmte Rollen in einer Bereitstellung angewendet werden.

Durchwahl

Gibt eine Erweiterung an, die für eine Rolle in einem Cloud-Dienst bereitgestellt werden soll.

Elementname	BESCHREIBUNG
Id	Erforderlich. Gibt den Bezeichner der Erweiterung an. Der Bezeichner wird erstellt, wenn die Erweiterung dem Cloud-Dienst hinzugefügt wird. Sie finden die ID einer Erweiterung, die einem Clouddienst hinzugefügt wurde, mithilfe von Listenerweiterungen.
State	Optional. Gibt den Zustand der Erweiterung an. Dieses Element gilt nur für JSON-konfigurierte Erweiterungen. Mögliche Werte: - `Enable` - `Disable` - `Uninstall` Standardwert: `Enable`. Das `State` Element ist nur mit Version 2014-06-01 oder höher verfügbar.

NamedRoles

Gibt eine Liste von Erweiterungen an, die auf bestimmte Rollen in einer Bereitstellung angewendet werden.

Elementname	BESCHREIBUNG
Role	Erforderlich. Gibt eine bestimmte Rolle an, der die Erweiterung hinzugefügt wird.
RoleName	Erforderlich. Gibt den Namen der Rolle an.
Erweiterung	Erforderlich. Gibt eine Erweiterung an, die für eine Rolle in einem Cloud-Dienst bereitgestellt werden soll.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten.

Antwortheader	BESCHREIBUNG
`x-ms-request-id`	Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert. Bei einem asynchronen Vorgang können Sie Vorgangsstatus abrufen mit dem Wert des Headers aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen ist, fehlgeschlagen ist oder noch ausgeführt wird.

Antworttext

Keine.

Hinweise

Um eine automatische Aktualisierung einer Bereitstellung auszuführen, rufen Sie Upgrade Deployment (Bereitstellung aktualisieren) oder Change Deployment Configuration (Ändern der Bereitstellungskonfiguration ) auf, wobei das Mode -Element auf automaticfestgelegt ist. Das Update wird dann ohne weitere Eingaben fortgesetzt. Sie können Get Operation Status aufrufen, um zu bestimmen, wann das Update abgeschlossen ist.

Um ein manuelles Update durchzuführen, rufen Sie zuerst upgrade deployment auf, wobei das Mode Element auf manualfestgelegt ist. Rufen Sie als Nächstes WalkUpgradeDomain auf, um jede Domäne innerhalb der Bereitstellung zu aktualisieren. Stellen Sie vor dem Aktualisieren der nächsten Domäne durch Aufrufen von "Get Operation Status" sicher, dass der Vorgang abgeschlossen ist.

Ein Update, durch das Rolleninstanzen hinzugefügt oder entfernt werden, führt zu einem Konfigurationsupdate aller Rollen, die im Cloud-Dienst bereitgestellt sind. Vorhandene Rolleninstanzen müssen über neue Rolleninstanzen benachrichtigt werden, damit alle Rolleninstanzen im Cloud-Dienst miteinander kommunizieren können.

Standardmäßig wird ein Cloud-Dienst mit fünf Updatedomänen bereitgestellt, die während eines direkten Updates einzeln nacheinander aktualisiert werden.

Um die Updatedomäne zu bestimmen, in der eine bestimmte Instanz ausgeführt wird, verwenden Sie die UpdateDomain-Eigenschaft der RoleInstance-Klasse.

Freigeben über