Uaktualnianie wdrożenia

Artykuł
08/05/2023

Upgrade Deployment Operacja asynchroniczna inicjuje aktualizację wystąpień roli we wdrożeniu przy użyciu określonego pakietu i konfiguracji.

Żądanie

Żądanie Upgrade Deployment można określić w następujący sposób. Zastąp <subscription-id> ciąg identyfikatorem subskrypcji, <cloudservice-name> nazwą usługi <deployment-slot>staging w chmurze lub production<deployment-name> nazwą wdrożenia.

Metoda	Identyfikator URI żądania
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 identyfikatora URI

Parametr identyfikatora URI	Opis
`comp=upgrade`	Wymagane. Określa, że wdrożenie musi zostać zaktualizowane.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Opis
`Content-Type`	Wymagane. Ustaw ten nagłówek na `application/xml`wartość .
`x-ms-version`	Wymagane. Określa wersję operacji do użycia dla tego żądania. Ten nagłówek powinien być ustawiony na `2009-10-01` lub wyższy.

Treść żądania

Format treści żądania jest następujący:

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

W poniższej tabeli opisano elementy w treści żądania.

Nazwa elementu	Opis
Mode	Wymagane. Określa typ aktualizacji do zainicjowania. Wystąpienia ról są przydzielane do domen aktualizacji podczas wdrażania usługi. Aktualizacje można zainicjować ręcznie w każdej domenie aktualizacji lub inicjować automatycznie we wszystkich domenach aktualizacji. Możliwe wartości: - `Auto` - `Manual` - `Simultaneous` Jeśli nie zostanie określony, wartość domyślna to `Auto`. Jeśli jest ustawiona wartość `Manual`, należy wywołać metodę WalkUpgradeDomain , aby zastosować aktualizację. Jeśli jest ustawiona wartość `Auto`, aktualizacja zostanie automatycznie zastosowana do każdej domeny aktualizacji w sekwencji. Ustawienie `Simultaneous` jest dostępne tylko w wersji 2012-12-01 lub nowszej.
PackageUrl	Wymagane. Określa adres URL odwołujący się do lokalizacji pakietu usługi w usłudze Blob Service. Pakiet usługi może znajdować się na koncie magazynu poniżej tej samej subskrypcji lub identyfikatora URI sygnatury dostępu współdzielonego (SAS) z dowolnego konta magazynu. Aby uzyskać więcej informacji na temat sygnatur dostępu współdzielonego, zobacz Delegowanie dostępu za pomocą sygnatury dostępu współdzielonego.
Konfigurowanie	Wymagane. Określa plik konfiguracji usługi zakodowanej w formacie base-64 dla wdrożenia.
Etykieta	Wymagane. Określa nazwę usługi w chmurze, która jest zakodowana w formacie base-64. Nazwa może mieć długość maksymalnie 100 znaków. Zaleca się, aby etykieta była unikatowa w ramach subskrypcji. Nazwa może służyć do identyfikowania usługi w chmurze na potrzeby śledzenia.
RoleToUpgrade	Opcjonalny. Określa nazwę określonego wystąpienia roli do zaktualizowania. W przypadku uaktualnienia pojedynczej roli wszystkie inne role mogą nadal przetwarzać, jeśli zaplanowano wewnętrzne uaktualnienie platformy Azure. Domena aktualizacji jest gwarantowana w tym scenariuszu.
Force	Wymagane. Wskazuje, czy aktualizacja powinna być kontynuowana nawet wtedy, gdy spowoduje to utratę danych lokalnych z niektórych wystąpień roli. `True` jeśli aktualizacja powinna być kontynuowana; w przeciwnym razie `false`. Element `Force` jest dostępny tylko w wersji 2011-10-01 lub nowszej.
Nazwa	Opcjonalny. Określa nazwę rozszerzonej właściwości usługi w chmurze. Każda właściwość rozszerzona musi mieć zarówno zdefiniowaną nazwę, jak i wartość. Możesz mieć maksymalnie 25 rozszerzonych par nazw właściwości i wartości. Maksymalna długość `Name` elementu to 64 znaki, tylko znaki alfanumeryczne i podkreślenia są prawidłowe w nazwie, a nazwa musi zaczynać się literą. Próba użycia innych znaków, rozpoczynając od znaku innego niż litera lub wprowadzenie nazwy identycznej z inną rozszerzoną właściwością należącą do tej samej usługi w chmurze, spowoduje błąd o kodzie stanu 400 (nieprawidłowe żądanie). Element `Name` jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Wartość	Opcjonalny. Określa wartość rozszerzonej właściwości usługi w chmurze. Każda właściwość rozszerzona musi mieć zarówno zdefiniowaną nazwę, jak i wartość. Można mieć maksymalnie 25 rozszerzonych par nazw właściwości i wartości, a każda rozszerzona wartość właściwości ma maksymalną długość 255 znaków. Usuń właściwość rozszerzoną, ustawiając wartość na NULL. Element `Value` jest dostępny tylko w wersji 2012-03-01 lub nowszej.
ExtensionConfiguration	Opcjonalny. Określa rozszerzenie dodawane do usługi w chmurze. Na platformie Azure proces może działać jako rozszerzenie usługi w chmurze. Przed dodaniem rozszerzenia do usługi w chmurze należy użyć polecenia Dodaj rozszerzenie , aby można je było dodać do wdrożenia podczas aktualizacji. Element `ExtensionConfiguration` jest dostępny tylko w wersji 2013-03-01 lub nowszej.

ExtensionConfiguration

Określa rozszerzenie dodawane do usługi w chmurze.

Nazwa elementu	Opis
AllRole	Opcjonalny. Określa listę rozszerzeń, które są stosowane do wszystkich ról we wdrożeniu.
Rozszerzenie	Wymagane. Określa rozszerzenie, które ma zostać wdrożone w roli w usłudze w chmurze.
Nazwanerole	Opcjonalny. Określa listę rozszerzeń, które są stosowane do określonych ról we wdrożeniu.

Rozszerzenie

Określa rozszerzenie, które ma zostać wdrożone w roli w usłudze w chmurze.

Nazwa elementu	Opis
Id	Wymagane. Określa identyfikator rozszerzenia. Identyfikator jest tworzony po dodaniu rozszerzenia do usługi w chmurze. Identyfikator rozszerzenia dodanego do usługi w chmurze można znaleźć przy użyciu rozszerzeń listy.
Stan	Opcjonalny. Określa stan rozszerzenia. Ten element dotyczy tylko rozszerzeń skonfigurowanych w formacie JSON. Możliwe wartości: - `Enable` - `Disable` - `Uninstall` Wartość domyślna to `Enable`. Element `State` jest dostępny tylko w wersji 2014-06-01 lub nowszej.

Nazwanerole

Określa listę rozszerzeń, które są stosowane do określonych ról we wdrożeniu.

Nazwa elementu	Opis
Rola	Wymagane. Określa określoną rolę, do której dodano rozszerzenie.
RoleName	Wymagane. Określa nazwę roli.
Rozszerzenie	Wymagane. Określa rozszerzenie, które ma zostać wdrożone w roli w usłudze w chmurze.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP.

Nagłówek odpowiedzi	Opis
`x-ms-request-id`	Wartość, która jednoznacznie identyfikuje żądanie wykonane względem usługi zarządzania. W przypadku operacji asynchronicznej można wywołać metodę Get Operation Status z wartością nagłówka, aby określić, czy operacja została ukończona, nie powiodła się, czy nadal trwa.

Treść odpowiedzi

Brak.

Uwagi

Aby przeprowadzić automatyczną aktualizację wdrożenia, wywołaj metodę Wdrażanie uaktualnienia lub Zmień konfigurację wdrożenia z elementem ustawionym na Modeautomatic. Aktualizacja jest kontynuowana od tego momentu bez konieczności dalszego wprowadzania danych wejściowych. Możesz wywołać metodę Pobierz stan operacji , aby określić, kiedy aktualizacja została ukończona.

Aby przeprowadzić ręczną aktualizację, najpierw wywołaj polecenie Upgrade Deployment z elementem ustawionym Mode na manual. Następnie wywołaj metodę WalkUpgradeDomain , aby zaktualizować każdą domenę we wdrożeniu. Upewnij się, że operacja została ukończona, wywołując polecenie Pobierz stan operacji przed zaktualizowaniem następnej domeny.

Aktualizacja, która dodaje lub usuwa wystąpienia ról, spowoduje aktualizację konfiguracji do wszystkich ról wdrożonych w usłudze w chmurze. Istniejące wystąpienia ról muszą być powiadamiane o nowych wystąpieniach roli, aby wszystkie wystąpienia ról mogły komunikować się razem w usłudze w chmurze.

Domyślnie usługa w chmurze jest wdrażana z pięcioma domenami aktualizacji, które są aktualizowane pojedynczo podczas aktualizacji w miejscu.

Aby określić domenę aktualizacji, w której jest uruchomione określone wystąpienie, użyj UpdateDomain właściwości RoleInstance klasy .

Udostępnij za pośrednictwem