Criar Implementação

  • Artigo

A Create Deployment operação assíncrona carrega um novo pacote de serviço e cria uma nova implementação nos ambientes de teste ou de produção.

Antes de poder executar esta operação, tem de concluir as seguintes tarefas:

  • Crie uma subscrição e obtenha o identificador de subscrição. Pode obter o identificador de subscrição na página Definições do Portal de Gestão.

  • Crie e carregue um certificado de gestão para autorizar a operação.

  • Criar um serviço cloud.

  • Decida se a aplicação deve ser implementada em teste ou produção.

Pedir

O Create Deployment pedido é especificado da seguinte forma. Substitua <subscription-id> pelo seu ID de subscrição, <cloudservice-name> pelo nome do serviço cloud e <deployment-slot> por staging ou production.

Método URI do pedido
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>

Parâmetros do URI

Nenhum.

Cabeçalhos do Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido Description
Content-Type Obrigatório. Defina este cabeçalho como application/xml.
x-ms-version Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido como 2009-10-01 ou superior.

Corpo do Pedido

O formato do corpo do pedido é o seguinte:

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

A tabela seguinte descreve os elementos no corpo do pedido.

Nome do elemento Descrição
Nome Obrigatório. Especifica o nome da implementação.
PackageUrl Obrigatório. Especifica um URL que se refere à localização do pacote de serviço no serviço Blob. O pacote de serviço pode estar localizado numa conta de armazenamento abaixo da mesma subscrição ou num URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento.
Configuração Obrigatório. Especifica o ficheiro de configuração de serviço codificado base-64 para a implementação.
Etiqueta Obrigatório. Especifica um identificador para a implementação codificada com base 64. O identificador pode ter até 100 carateres de comprimento. Recomenda-se que a etiqueta seja exclusiva na subscrição. A etiqueta pode ser utilizada para as suas finalidades de controlo.
StartDeployment Opcional. Indica se deve iniciar a implementação imediatamente após a sua criação. O valor predefinido é false.

Se false, o modelo de serviço ainda estiver implementado, mas o código não for executado imediatamente. Em vez disso, o serviço é Suspended até chamar o Estado da Implementação de Atualização e definir o estado como Running, altura em que o serviço será iniciado. Um serviço implementado continua a ser cobrado, mesmo que esteja suspenso.

O StartDeployment elemento só está disponível com a versão 2010-04-01 ou superior.
TreatWarningsAsError Opcional. Indica se deve tratar os avisos de validação do pacote como erros. O valor predefinido é false. Se estiver definida como true, a Created Deployment operação falhará se existirem avisos de validação no pacote de serviço.

O TreatWarningsAsError elemento só está disponível com a versão 2011-04-01 ou superior.
Name Opcional. Especifica o nome de uma propriedade de implementação expandida. Cada propriedade expandida tem de ter um nome e um valor definidos. Pode ter um máximo de 25 pares de propriedades e valores expandidos.

O comprimento máximo do elemento Nome é de 64 carateres, apenas os carateres alfanuméricos e os carateres de sublinhado são válidos no Nome e o nome tem de começar com uma letra.

O Name elemento só está disponível com a versão 2012-03-01 ou superior.
Valor Opcional. Especifica o valor de uma propriedade de serviço cloud expandida. Cada propriedade expandida tem de ter um nome e um valor definidos. Pode ter um máximo de 25 pares de nomes de propriedades e valores expandidos e cada valor de propriedade expandida tem um comprimento máximo de 255 carateres.

O Value elemento só está disponível com a versão 2012-03-01 ou superior.
ExtensionConfiguration Opcional. Especifica uma extensão que é adicionada ao serviço cloud. No Azure, um processo pode ser executado como uma extensão de um serviço cloud. Tem de adicionar uma extensão ao serviço cloud utilizando Adicionar Extensão antes de poder ser adicionada à implementação.

O ExtensionConfiguration elemento só está disponível com a versão 2013-03-01 ou superior.

ExtensionConfiguration

Especifica uma extensão que é adicionada ao serviço cloud.

Nome do elemento Descrição
AllRoles Opcional. Especifica uma lista de extensões que são aplicadas a todas as funções numa implementação.
Extensão Obrigatório. Especifica uma extensão que deve ser implementada numa função num serviço cloud.
NamedRoles Opcional. Especifica uma lista de extensões que são aplicadas a funções específicas numa implementação.

Extensão

Especifica uma extensão que deve ser implementada numa função num serviço cloud.

Nome do elemento Descrição
Id Obrigatório. Especifica o identificador da extensão. O identificador é criado quando a extensão é adicionada ao serviço cloud. Pode encontrar o identificador de uma extensão que foi adicionada a um serviço cloud com Extensões de Lista.
Estado Opcional. Especifica o estado da extensão. Este elemento aplica-se apenas a extensões configuradas por JSON.

Os valores possíveis são:

- Enable
- Disable
- Uninstall

O valor predefinido é Enable.

O State elemento só está disponível através da versão 2014-06-01 ou superior.

NamedRoles

Especifica uma lista de extensões que são aplicadas a funções específicas numa implementação.

Nome do elemento Descrição
Função Obrigatório. Especifica uma função específica à qual a extensão é adicionada.
RoleName Obrigatório. Especifica o nome da função.
Extensão Obrigatório. Especifica uma extensão que deve ser implementada numa função num serviço cloud.

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Código de Estado

Uma operação bem-sucedida devolve o código de estado 200 (OK).

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais.

Cabeçalho de Resposta Description
x-ms-request-id Um valor que identifica exclusivamente um pedido feito relativamente ao serviço de gestão. Para uma operação assíncrona, pode chamar Obter Estado da Operação com o valor do cabeçalho para determinar se a operação está concluída, se falhou ou se ainda está em curso.

Corpo da Resposta

Nenhum.