Upgrade nasazení

Článek
08/05/2023

Asynchronní Upgrade Deployment operace zahájí aktualizaci instancí rolí v nasazení pomocí balíčku a konfigurace, kterou zadáte.

Žádost

Žádost Upgrade Deployment může být zadána následujícím způsobem. Nahraďte <subscription-id> ID předplatného, <cloudservice-name> názvem cloudové služby nebo production<deployment-slot>staging<deployment-name> nebo názvem nasazení.

Metoda	Identifikátor URI žádosti
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>/`

Parametry identifikátoru URI

Parametr identifikátoru URI	Description
`comp=upgrade`	Povinná hodnota. Určuje, že nasazení se musí aktualizovat.

Hlavičky požadavku

Následující tabulka popisuje hlavičky požadavku.

Hlavička požadavku	Description
`Content-Type`	Povinná hodnota. Nastavte toto záhlaví na `application/xml`.
`x-ms-version`	Povinná hodnota. Určuje verzi operace, která se má použít pro tento požadavek. Tato hlavička by měla být nastavená na `2009-10-01` hodnotu nebo vyšší.

Text požadavku

Text požadavku má následující formát:

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

Následující tabulka popisuje prvky v textu požadavku.

Název elementu	Popis
Mode	Povinná hodnota. Určuje typ aktualizace, která se má zahájit. Instance rolí se při nasazení služby přidělují k aktualizaci domén. Aktualizace je možné zahájit ručně v každé aktualizační doméně nebo automaticky ve všech aktualizačních doménách. Možné hodnoty: - `Auto` - `Manual` - `Simultaneous` Pokud není zadán, výchozí hodnota je `Auto`. Pokud je nastavená na `Manual`, Musí být volána WalkUpgradeDomain , aby se aktualizace použila. Pokud je tato možnost nastavená na `Auto`, aktualizace se postupně automaticky aplikuje na každou doménu aktualizace. Nastavení `Simultaneous` je k dispozici pouze ve verzi 2012-12-01 nebo vyšší.
PackageUrl	Povinná hodnota. Určuje adresu URL, která odkazuje na umístění balíčku služby ve službě Blob Service. Balíček služby se může nacházet buď v účtu úložiště pod stejným předplatným, nebo v identifikátoru URI sdíleného přístupového podpisu (SAS) z libovolného účtu úložiště. Další informace o sdílených přístupových podpisech najdete v tématu Delegování přístupu pomocí sdíleného přístupového podpisu.
Konfigurace	Povinná hodnota. Určuje konfigurační soubor služby s kódováním base-64 pro nasazení.
Popisek	Povinná hodnota. Určuje název cloudové služby, která má kódování base-64. Název může mít délku až 100 znaků. Doporučuje se, aby popisek byl v rámci předplatného jedinečný. Název se dá použít k určení cloudové služby pro účely sledování.
RoleToUpgrade	Nepovinný parametr. Určuje název konkrétní instance role, která se má aktualizovat. Při upgradu jedné role se všechny ostatní role můžou stále recyklovat, pokud je naplánovaný interní upgrade Azure. V tomto scénáři je aktualizační doména zaručená.
Force	Povinná hodnota. Určuje, jestli má aktualizace pokračovat, i když způsobí ztrátu místních dat z některých instancí rolí. `True` pokud by aktualizace měla pokračovat; jinak `false`. Element `Force` je k dispozici pouze ve verzi 2011-10-01 nebo vyšší.
Name	Nepovinný parametr. Určuje název vlastnosti rozšířené cloudové služby. Každá rozšířená vlastnost musí mít definovaný název i hodnotu. Můžete mít maximálně 25 dvojic rozšířených názvů vlastností a hodnot. Maximální délka elementu `Name` je 64 znaků, v názvu jsou platné pouze alfanumerické znaky a podtržítka a název musí začínat písmenem. Při pokusu o použití jiných znaků, počínaje znakem bez písmen, nebo zadáním názvu, který je shodný s názvem jiné rozšířené vlastnosti vlastněné stejnou cloudovou službou, se zobrazí stavový kód 400 (Chybný požadavek). Element `Name` je k dispozici pouze ve verzi 2012-03-01 nebo vyšší.
Hodnota	Nepovinný parametr. Určuje hodnotu vlastnosti rozšířené cloudové služby. Každá rozšířená vlastnost musí mít definovaný název i hodnotu. Můžete mít maximálně 25 dvojic s názvem rozšířené vlastnosti a hodnotou a každá hodnota rozšířené vlastnosti má maximální délku 255 znaků. Rozšířenou vlastnost odstraníte nastavením hodnoty na HODNOTU NULL. Element `Value` je k dispozici pouze ve verzi 2012-03-01 nebo vyšší.
Konfigurace rozšíření	Nepovinný parametr. Určuje rozšíření, které se přidá do cloudové služby. V Azure může proces běžet jako rozšíření cloudové služby. Před přidáním rozšíření do nasazení během aktualizace musíte do cloudové služby přidat rozšíření pomocí možnosti Přidat rozšíření . Element `ExtensionConfiguration` je k dispozici pouze ve verzi 2013-03-01 nebo vyšší.

Konfigurace rozšíření

Určuje rozšíření, které se přidá do cloudové služby.

Název elementu	Popis
AllRoles	Nepovinný parametr. Určuje seznam rozšíření, která se použijí pro všechny role v nasazení.
Rozšíření	Povinná hodnota. Určuje rozšíření, které se má nasadit do role v cloudové službě.
Pojmenované role	Nepovinný parametr. Určuje seznam rozšíření, která se použijí na konkrétní role v nasazení.

Rozšíření

Určuje rozšíření, které se má nasadit do role v cloudové službě.

Název elementu	Popis
Id	Povinná hodnota. Určuje identifikátor rozšíření. Identifikátor se vytvoří při přidání rozšíření do cloudové služby. ID rozšíření přidaného do cloudové služby můžete zjistit pomocí seznamu rozšíření.
Stav	Nepovinný parametr. Určuje stav rozšíření. Tento element platí jenom pro rozšíření nakonfigurovaná ve formátu JSON. Možné hodnoty: - `Enable` - `Disable` - `Uninstall` Výchozí hodnota je `Enable`. Element `State` je k dispozici pouze ve verzi 2014-06-01 nebo novější.

Pojmenované role

Určuje seznam rozšíření, která se použijí pro konkrétní role v nasazení.

Název elementu	Popis
Role	Povinná hodnota. Určuje konkrétní roli, do které se rozšíření přidá.
RoleName (Název role)	Povinná hodnota. Určuje název role.
Rozšíření	Povinná hodnota. Určuje rozšíření, které se má nasadit do role v cloudové službě.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP.

Hlavička odpovědi	Description
`x-ms-request-id`	Hodnota, která jednoznačně identifikuje požadavek provedený na službu správy. U asynchronní operace můžete voláním funkce Get Operation Status (Získat stav operace ) s hodnotou hlavičky zjistit, jestli je operace dokončená, selhala nebo stále probíhá.

Text odpovědi

Žádné

Poznámky

Pokud chcete provést automatickou aktualizaci nasazení, zavolejte metodu Upgrade nasazení nebo Změna konfigurace nasazení s elementem Mode nastaveným na automatic. Od tohoto okamžiku bude aktualizace pokračovat bez nutnosti dalšího zadávání. Pokud chcete zjistit, kdy je aktualizace dokončena, můžete volat funkci Get Operation Status (Získat stav operace ).

Pokud chcete provést ruční aktualizaci, nejprve volejte nasazení upgradu s elementem nastaveným Mode na manual. Dále volejte Metodu WalkUpgradeDomain a aktualizujte každou doménu v rámci nasazení. Před aktualizací další domény byste se měli ujistit, že je operace dokončená, zavoláním metody Get Operation Status (Získat stav operace).

Aktualizace, která přidá nebo odebere instance rolí, způsobí aktualizaci konfigurace pro všechny role nasazené v cloudové službě. Stávající instance rolí musí být upozorňovány na nové instance rolí, aby všechny instance rolí mohly v cloudové službě komunikovat.

Ve výchozím nastavení je cloudová služba nasazená s pěti aktualizačními doménami, které se během místní aktualizace aktualizují jednu po druhé.

Chcete-li určit aktualizační doménu, ve které je spuštěna konkrétní instance, použijte UpdateDomain vlastnost RoleInstance třídy .

Sdílet prostřednictvím