Tworzenie wdrożenia

Artykuł
07/19/2023

Create Deployment Operacja asynchroniczna przekazuje nowy pakiet usługi i tworzy nowe wdrożenie w środowiskach przejściowych lub produkcyjnych.

Przed uruchomieniem tej operacji należy wykonać następujące zadania:

Utwórz subskrypcję i uzyskaj identyfikator subskrypcji. Identyfikator subskrypcji można uzyskać na stronie Ustawienia portalu zarządzania.
Utwórz i przekaż certyfikat zarządzania, aby autoryzować operację.
Tworzenie usługi w chmurze.
Zdecyduj, czy aplikacja ma zostać wdrożona w środowisku przejściowym, czy produkcyjnym.

Żądanie

Żądanie Create Deployment jest określone w następujący sposób. Zastąp <subscription-id> ciąg identyfikatorem subskrypcji, <cloudservice-name> nazwą usługi w chmurze i <deployment-slot> ciągiem staging lub production.

Metoda	Identyfikator URI żądania
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>`

Parametry identyfikatora URI

Brak.

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"?>  
<CreateDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Name>deployment-name</Name>  
  <PackageUrl>package-url-in-blob-storage</PackageUrl>  
  <Label>base64-encoded-deployment-label</Label>  
  <Configuration>base64-encoded-configuration-file</Configuration>  
  <StartDeployment>start-deployment</StartDeployment>  
  <TreatWarningsAsError>prioritize-warnings</TreatWarningsAsError>  
  <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>  
</CreateDeployment>

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

Nazwa elementu	Opis
Nazwa	Wymagane. Określa nazwę wdrożenia.
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.
Konfigurowanie	Wymagane. Określa plik konfiguracji usługi zakodowanej w formacie base-64 dla wdrożenia.
Etykieta	Wymagane. Określa identyfikator wdrożenia, który jest zakodowany w formacie base-64. Identyfikator może mieć długość do 100 znaków. Zaleca się, aby etykieta była unikatowa w ramach subskrypcji. Etykieta może być używana do celów śledzenia.
StartDeployment	Opcjonalny. Wskazuje, czy wdrożenie ma być uruchamiane natychmiast po jego utworzeniu. Wartość domyślna to `false`. Jeśli `false`model usługi jest nadal wdrażany, ale kod nie jest uruchamiany natychmiast. Zamiast tego usługa jest `Suspended` dostępna do momentu wywołania stanu wdrożenia aktualizacji i ustawienia stanu na `Running`, w którym momencie usługa zostanie uruchomiona. Wdrożona usługa nadal ponosi opłaty, nawet jeśli jest zawieszona. Element `StartDeployment` jest dostępny tylko w wersji 2010-04-01 lub nowszej.
TreatWarningsAsError	Opcjonalny. Wskazuje, czy ostrzeżenia weryfikacji pakietu mają być traktowane jako błędy. Wartość domyślna to `false`. Jeśli ustawiono wartość `true`, operacja zakończy się niepowodzeniem, `Created Deployment` jeśli w pakiecie usługi występują ostrzeżenia dotyczące walidacji. Element `TreatWarningsAsError` jest dostępny tylko w wersji 2011-04-01 lub nowszej.
Nazwa	Opcjonalny. Określa nazwę właściwości wdrożenia rozszerzonego. 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ść elementu Name wynosi 64 znaki, tylko znaki alfanumeryczne i podkreślenia są prawidłowe w polu Nazwa, a nazwa musi zaczynać się literą. 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. 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 wdrożenia należy dodać rozszerzenie do usługi w chmurze przy użyciu polecenia Dodaj rozszerzenie . 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 podczas dodawania rozszerzenia do usługi w chmurze. Identyfikator rozszerzenia, który został dodany 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 dodawane jest 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

Pomyślna operacja 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 skierowane do 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, zakończyła się niepowodzeniem, czy nadal jest w toku.

Treść odpowiedzi