Compartilhar via

Esquema WebRole de definição dos Serviços de Nuvem do Azure (suporte estendido)

  • Artigo

A função web do Azure é uma função personalizada para programação de aplicativo Web conforme suporte do IIS 7, como ASP.NET, PHP, Windows Communication Foundation e FastCGI.

A extensão padrão do arquivo de definição de serviço é csdef.

Esquema básico de definição de serviço para uma função web

O formato básico de um arquivo de definição de serviço que contém uma função web é o seguinte.

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe="<load-balancer-probe-name>" />  
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">  
         <FixedPort port="<port-number>"/>  
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
      </InternalEndpoint>  
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">  
         <AllocatePublicPortFrom>  
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
         </AllocatePublicPortFrom>  
      </InstanceInputEndpoint>  
    </Endpoints>  
    <LocalResources>  
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    </LocalResources>  
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    <Runtime executionContext="[limited|elevated]">  
      <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
      </Environment>  
      <EntryPoint>  
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">  
        <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
        </Environment>  
      </Task>  
    </Startup>  
    <Contents>  
      <Content destination="<destination-folder-name>" >  
        <SourceDirectory path="<local-source-directory>" />  
      </Content>  
    </Contents>  
  </WebRole>  
</ServiceDefinition>

Elementos de esquema

O arquivo de definição de serviço inclui esses elementos, descritos detalhadamente nas seções subsequentes deste artigo:

WebRole

ConfigurationSettings

Configuração

LocalResources

LocalStorage

Pontos de extremidade

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Certificados

Certificado

Imports

Importaçãoação

Runtime

Ambiente

Variável

RoleInstanceValue

NetFxEntryPoint

Sites

Site

VirtualApplication

VirtualApplication

Associações

Associação

Inicialização

Tarefa

Contents

Conteúdo

SourceDirectory

WebRole

O elemento WebRole descreve uma função que é personalizada para programação de aplicativo Web, conforme o suporte do IIS 7 e ASP.NET. Um serviço pode conter zero ou mais funções web.

A tabela a seguir descreve os atributos do elemento WebRole.

Atributo Tipo Descrição
name string Obrigatórios. O nome para a função web. O nome da função deve ser exclusivo.
enableNativeCodeExecution booleano Opcional. O valor padrão é true; a execução de código nativo e a confiança total são habilitadas por padrão. Defina este atributo como false para desabilitar a execução de código nativo para a função web e usar a confiança parcial do Azure em vez da confiança total.
vmsize string Opcional. Defina esse valor para alterar o tamanho da máquina virtual que está alocada para a função. O valor padrão é Small. Para obter mais informações, consulte Tamanhos de máquina virtual para os Serviços de Nuvem.

ConfigurationSettings

O elemento ConfigurationSettings descreve a coleção de definições de configuração para uma função web. Esse elemento é o pai do elemento Setting.

Configuração

O elemento Setting descreve um par de nome e valor que especifica uma definição de configuração para uma instância de uma função.

A tabela a seguir descreve os atributos do elemento Setting.

Atributo Tipo Descrição
name string Obrigatórios. Um nome exclusivo para a definição de configuração.

As definições de configuração para uma função são pares de nome e valor declarados no arquivo de definição de serviço e definidos no arquivo de configuração de serviço.

LocalResources

O elemento LocalResources descreve a coleção de recursos de armazenamento local para uma função web. Esse elemento é o pai do elemento LocalStorage.

LocalStorage

O elemento LocalStorage identifica um recurso de armazenamento local que fornece espaço do sistema de arquivos para o serviço em runtime. Uma função pode definir zero ou mais recursos de armazenamento local.

Observação

O elemento LocalStorage pode ser exibido como um filho do elemento WebRole para dar suporte à compatibilidade com versões anteriores do SDK do Azure.

A tabela a seguir descreve os atributos do elemento LocalStorage.

Atributo Tipo Descrição
name string Obrigatórios. Um nome exclusivo para o repositório local.
cleanOnRoleRecycle booleano Opcional. Indica se o repositório local deve ser limpo quando a função é reiniciada. O valor padrão é true.
sizeInMb INT Opcional. A quantidade desejada de espaço de armazenamento a ser alocado para o repositório local, em MB. Se não estiver especificada, o espaço de armazenamento padrão alocado será 100 MB. A quantidade mínima de espaço de armazenamento que pode ser alocada é 1 MB.

O tamanho máximo dos recursos locais depende do tamanho da máquina virtual. Para obter mais informações, consulte Tamanhos de máquina virtual para os Serviços de Nuvem.

O nome do diretório alocado ao recurso de armazenamento local corresponde ao valor fornecido para o atributo de nome.

Pontos de extremidade

O elemento Endpoints descreve a coleção de pontos de extremidade de entrada (externo), interno e de entrada da instância para uma função. Esse elemento é o pai dos elementos InputEndpoint, InternalEndpoint e InstanceInputEndpoint.

Os pontos de extremidade de entrada e internos são alocados separadamente. Um serviço pode ter um total de 25 pontos de extremidade de entrada, internos e de instância, que podem ser alocados entre as 25 funções permitidas em um serviço. Por exemplo, se você tiver cinco funções, poderá alocar cinco pontos de extremidade de entrada por função, ou poderá alocar 25 pontos de extremidade de entrada para uma única função ou poderá alocar um ponto de extremidade de entrada para 25 funções.

Observação

Cada função implantada requer uma instância por função. O provisionamento padrão para uma assinatura é limitado a 20 núcleos e, portanto, é limitado a 20 instâncias de uma função. Se seu aplicativo exigir mais instâncias do que é fornecido pelo provisionamento padrão, consulte Billing, Subscription Management and Quota Support (Cobrança, Gerenciamento de assinatura e Suporte de cota) para obter mais informações sobre como aumentar a cota.

InputEndpoint

O elemento InputEndpoint descreve um ponto de extremidade externo para uma função web.

É possível definir vários pontos de extremidade que são uma combinação de pontos de extremidade HTTP, HTTPS, UDP e TCP. É possível especificar qualquer número da porta escolhido para um ponto de extremidade de entrada, mas os números da porta especificados para cada função no serviço devem ser exclusivos. Por exemplo, se você especificar que uma função web usa a porta 80 para HTTP e a porta 443 para HTTPS, você poderá, então, especificar que uma segunda função web usa a porta 8080 para HTTP e a porta 8043 para HTTPS.

A tabela a seguir descreve os atributos do elemento InputEndpoint.

Atributo Tipo Descrição
name string Obrigatórios. Um nome exclusivo para o ponto de extremidade externo.
protocolo string Obrigatórios. O protocolo de transporte para o ponto de extremidade externo. Para uma função web, os valores possíveis são HTTP, HTTPS, UDP ou TCP.
porta INT Obrigatórios. A porta do ponto de extremidade externo. É possível especificar qualquer número da porta escolhido, mas os números da porta especificados para cada função no serviço devem ser exclusivos.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).
certificado string Obrigatório para um ponto de extremidade HTTPS. O nome de um certificado definido por um elemento Certificate.
localPort INT Opcional. Especifica uma porta usada para conexões internas no ponto de extremidade. O atributo localPort mapeia a porta externa no ponto de extremidade para uma porta interna em uma função. Esse atributo é útil em cenários nos quais uma função deve se comunicar com um componente interno em uma porta diferente daquela exposta externamente.

Se não estiver especificado, o valor de localPort será o mesmo que o do atributo port. Defina o valor de localPort como "*" para atribuir automaticamente uma porta não alocada que pode ser descoberta usando a API de runtime.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).

O atributo localPort só está disponível usando o SDK do Azure versão 1.3 ou superior.
ignoreRoleInstanceStatus booleano Opcional. Quando o valor desse atributo é definido como true, o status de um serviço é ignorado e o balanceador de carga não removerá o ponto de extremidade. Definir esse valor como true é útil para depurar instâncias ocupadas de um serviço. O valor padrão é false. Observação: um ponto de extremidade ainda pode receber tráfego mesmo quando a função não está em um estado Pronto.
loadBalancerProbe string Opcional. O nome da sonda do balanceador de carga associada ao ponto de extremidade de entrada. Para obter mais informações, consulte o LoadBalancerProbe Schema (Esquema LoadBalancerProbe).

InternalEndpoint

O elemento InternalEndpoint descreve um ponto de extremidade interno para uma função web. Um ponto de extremidade interno está disponível apenas para outras instâncias de função em execução no serviço; ele não está disponível para clientes fora do serviço. As funções Web que não incluem o elemento Sites só podem ter um único ponto de extremidade interno HTTP, UDP ou TCP.

A tabela a seguir descreve os atributos do elemento InternalEndpoint.

Atributo Tipo Descrição
name string Obrigatórios. Um nome exclusivo para o ponto de extremidade interno.
protocolo string Obrigatórios. O protocolo de transporte para o ponto de extremidade interno. Os valores possíveis são HTTP, TCP, UDP ou ANY.

Um valor de ANY especifica que qualquer protocolo, qualquer porta é permitida.
porta INT Opcional. A porta usada para conexões internas com balanceamento de carga no ponto de extremidade. Um ponto de extremidade com balanceamento de carga usa duas portas. A porta usada para o endereço IP público e a porta usada no endereço IP privado. Normalmente, esses valores são definidos iguais, mas você pode optar por usar portas diferentes.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).

O atributo Port só está disponível usando o SDK do Azure versão 1.3 ou superior.

InstanceInputEndpoint

O elemento InstanceInputEndpoint descreve um ponto de extremidade de entrada de instância para uma função web. Um ponto de extremidade de entrada de instância está associado a uma instância de função específica usando o encaminhamento de porta no balanceador de carga. Cada ponto de extremidade de entrada de instância é mapeado para uma porta específica de um intervalo de portas possíveis. Esse elemento é o pai do elemento AllocatePublicPortFrom.

O elemento InstanceInputEndpoint só está disponível usando o SDK do Azure versão 1.7 ou superior.

A tabela a seguir descreve os atributos do elemento InstanceInputEndpoint.

Atributo Tipo Descrição
name string Obrigatórios. Um nome exclusivo para o ponto de extremidade.
localPort INT Obrigatória. Especifica a porta interna que todas as instâncias de função escutam para receber o tráfego de entrada encaminhado do balanceador de carga. Os valores possíveis variam entre 1 e 65535, inclusive.
protocolo string Obrigatórios. O protocolo de transporte para o ponto de extremidade interno. Os possíveis valores são udp ou tcp. Use tcp para tráfego baseado em http/https.

AllocatePublicPortFrom

O elemento AllocatePublicPortFrom descreve o intervalo de portas públicas que os clientes externos podem usar para acessar cada ponto de extremidade de entrada da instância. O número da porta pública (VIP) é alocado desse intervalo e atribuído a cada ponto de extremidade de instância de função individual durante a implantação e a atualização do locatário. Esse elemento é o pai do elemento FixedPortRange.

O elemento AllocatePublicPortFrom só está disponível usando o SDK do Azure versão 1.7 ou superior.

FixedPort

O elemento FixedPort especifica a porta para o ponto de extremidade interno, que permite conexões com balanceamento de carga no ponto de extremidade.

O elemento FixedPort só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento FixedPort.

Atributo Tipo Descrição
porta INT Obrigatórios. A porta do ponto de extremidade interno. Esse atributo tem o mesmo efeito que definir o FixedPortRange mínimo e máximo para a mesma porta.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).

FixedPortRange

O elemento FixedPortRange especifica o intervalo de portas atribuído ao ponto de extremidade interno ou de entrada de instância e define a porta usada para conexões com balanceamento de carga no ponto de extremidade.

Observação

O elemento FixedPortRange funciona de maneira diferente dependendo do elemento no qual ele reside. Quando o elemento FixedPortRange está no elemento InternalEndpoint, ele abre todas as portas no balanceador de carga dentro do intervalo dos atributos mín. e máx. para todas as máquinas virtuais em que a função é executada. Quando o elemento FixedPortRange está no elemento InstanceInputEndpoint, ele abre apenas uma porta dentro do intervalo dos atributos mín. e máx. em cada máquina virtual que executa a função.

O elemento FixedPortRange só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento FixedPortRange.

Atributo Tipo Descrição
min INT Obrigatórios. A porta mínima no intervalo. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).
max string Obrigatórios. A porta máxima no intervalo. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).

Certificados

O elemento Certificates descreve a coleção de certificados para uma função web. Esse elemento é o pai do elemento Certificate. Uma função pode ter qualquer número de certificados associados. Para obter mais informações sobre o uso do elemento certificates, consulte Modify the Service Definition file with a certificate (Modificar o arquivo de definição de serviço com um certificado).

Certificado

O elemento Certificate descreve um certificado associado a uma função web.

A tabela a seguir descreve os atributos do elemento Certificate.

Atributo Tipo Descrição
name string Obrigatória. Um nome para esse certificado, que é usado para se referir a ele quando está associado a um elemento HTTPS InputEndpoint.
storeLocation string Obrigatórios. O local do repositório de certificados em que esse certificado pode ser encontrado no computador local. Os valores possíveis são CurrentUser e LocalMachine.
storeName string Obrigatórios. O nome do repositório de certificados em que esse certificado reside no computador local. Os valores possíveis incluem os nomes de repositório interno My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook ou qualquer nome de repositório personalizado. Se um nome de repositório personalizado for especificado, ele será criado automaticamente.
permissionLevel string Opcional. Especifica as permissões de acesso fornecidas aos processos de função. Se você desejar que apenas processos com privilégios elevados possam acessar a chave privada, especifique a permissão elevated. A permissão limitedOrElevated permite que todos os processos de função acessem a chave privada. Os possíveis valores são limitedOrElevated ou elevated. O valor padrão é limitedOrElevated.

Importações

O elemento Imports descreve uma coleção de módulos de importação para uma função web que adicionam componentes ao sistema operacional convidado. Esse elemento é o pai do elemento Import. Esse elemento é opcional e uma função pode ter apenas um bloco de importações.

O elemento Imports só está disponível usando o SDK do Azure versão 1.3 ou superior.

Importar

O elemento Import especifica um módulo a ser adicionado ao sistema operacional convidado.

O elemento Import só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento Import.

Atributo Tipo Descrição
moduleName string Obrigatórios. O nome do módulo a ser importado. Os módulos de importação válidos são:

– RemoteAccess
– RemoteForwarder
– Diagnóstico

Os módulos RemoteAccess e RemoteForwarder permitem que você configure sua instância de função para conexões de área de trabalho remota. Para obter mais informações, consulte Extensões.

O módulo Diagnostics permite coletar dados de diagnóstico para uma instância de função.

Runtime

O elemento Runtime descreve uma coleção de configurações de variável de ambiente para uma função web que controlam o ambiente de runtime do processo de host do Azure. Esse elemento é o pai do elemento Environment. Esse elemento é opcional e uma função pode ter apenas um bloco de runtime.

O elemento Runtime só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento Runtime:

Atributo Tipo Descrição
executionContext string Opcional. Especifica o contexto no qual o Processo de função é iniciado. O contexto padrão é limited.

- limited – O processo é iniciado sem privilégios de administrador.
- elevated – O processo é iniciado com privilégios de administrador.

Ambiente

O elemento Environment descreve uma coleção de configurações de variável de ambiente para uma função web. Esse elemento é o pai do elemento Variable. Uma função pode ter qualquer número de conjunto de variáveis de ambiente.

Variável

O elemento Variable especifica uma variável de ambiente a ser definida no sistema operacional convidado.

O elemento Variable só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento Variable:

Atributo Tipo Descrição
name string Obrigatórios. O nome da variável de ambiente a ser definida.
value string Opcional. O valor a ser definido para a variável de ambiente. É necessário incluir um atributo de valor ou um elemento RoleInstanceValue.

RoleInstanceValue

O elemento RoleInstanceValue especifica o xPath do qual recuperar o valor da variável.

A tabela a seguir descreve os atributos do elemento RoleInstanceValue.

Atributo Tipo Descrição
xpath string Opcional. Caminho do local de configurações de implantação para a instância. Para obter mais informações, consulte Variáveis de configuração com o XPath.

É necessário incluir um atributo de valor ou um elemento RoleInstanceValue.

EntryPoint

O elemento EntryPoint especifica o ponto de entrada para uma função. Esse elemento é o pai dos elementos NetFxEntryPoint. Esses elementos permitem que você especifique um aplicativo diferente do WaWorkerHost.exe padrão para atuar como o ponto de entrada da função.

O elemento EntryPoint só está disponível usando o SDK do Azure versão 1.5 ou superior.

NetFxEntryPoint

O elemento NetFxEntryPoint especifica o programa a ser executado para uma função.

Observação

O elemento NetFxEntryPoint só está disponível usando o SDK do Azure versão 1.5 ou superior.

A tabela a seguir descreve os atributos do elemento NetFxEntryPoint.

Atributo Tipo Descrição
assemblyName string Obrigatórios. O caminho e o nome do arquivo do assembly que contém o ponto de entrada. O caminho é relativo à pasta \%ROLEROOT%\Approot (não especifique \%ROLEROOT%\Approot na linha de comando; é assumido). %ROLEROOT% é uma variável de ambiente mantida pelo Azure e ela representa o local da pasta raiz da sua função. A pasta \%ROLEROOT%\Approot representa a pasta do aplicativo da função.

Para as funções HWC, o caminho é sempre referente à pasta \%ROLEROOT%\Approot\bin.

Para funções Web IIS e IIS Express completas, se o assembly não puder ser encontrado em relação à pasta \%ROLEROOT%\Approot, a pasta \%ROLEROOT%\Approot\bin será pesquisada.

Esse comportamento de fallback para o IIS completo não é uma prática recomendada e pode ser removido em versões futuras.
targetFrameworkVersion string Obrigatórios. A versão do .NET Framework na qual esse assembly foi criado. Por exemplo, targetFrameworkVersion="v4.0".

Sites

O elemento Sites descreve uma coleção de sites e aplicativos Web hospedados em uma função web. Esse elemento é o pai do elemento Site. Se você não especificar um elemento Sites, sua função web será hospedada como função web herdada e você só poderá ter um site hospedado em sua função web. Esse elemento é opcional e uma função pode ter apenas um bloco de sites.

O elemento Sites só está disponível usando o SDK do Azure versão 1.3 ou superior.

Site

O elemento Site especifica um site ou aplicativo Web que faz parte da função web.

O elemento Site só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento Site.

Atributo Tipo Descrição
name string Obrigatórios. Nome do site ou aplicativo.
physicalDirectory string O local do diretório de conteúdo para a raiz do site. O local pode ser especificado como um caminho absoluto ou relativo ao local do csdef.

VirtualApplication

O elemento VirtualApplication define que um aplicativo em IIS (Serviços de Informações da Internet) 7 é um agrupamento de arquivos que entrega conteúdo ou fornece serviços através de protocolos, como HTTP. Quando você cria um aplicativo em IIS 7, o caminho do aplicativo se torna parte da URL do site.

O elemento VirtualApplication só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento VirtualApplication.

Atributo Tipo Descrição
name string Obrigatórios. Especifica um nome para identificar o aplicativo virtual.
physicalDirectory string Obrigatórios. Especifica o caminho no computador de desenvolvimento que contém o aplicativo virtual. No emulador de computação, o IIS é configurado para recuperar conteúdo deste local. Quando implantado no Azure, o conteúdo do diretório físico é empacotado junto com o restante do serviço. Quando o pacote do serviço é implantado no Azure, o IIS é configurado com o local do conteúdo descompactado.

VirtualDirectory

O elemento VirtualDirectory especifica um nome de diretório (também chamado de caminho) que você especifica no IIS e mapeia para um diretório físico em um servidor local ou remoto.

O elemento VirtualDirectory só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento VirtualDirectory.

Atributo Tipo Descrição
name string Obrigatórios. Especifica um nome para identificar o diretório virtual.
value physicalDirectory Obrigatórios. Especifica o caminho no computador de desenvolvimento que contém o site ou o conteúdo do diretório virtual. No emulador de computação, o IIS é configurado para recuperar conteúdo deste local. Quando implantado no Azure, o conteúdo do diretório físico é empacotado junto com o restante do serviço. Quando o pacote do serviço é implantado no Azure, o IIS é configurado com o local do conteúdo descompactado.

Associações

O elemento Bindings descreve uma coleção de associações para um site. É o elemento pai do elemento Binding. O elemento é necessário para cada elemento Site. Para obter mais informações sobre como configurar pontos de extremidade, consulte Habilitar comunicação para instâncias de função.

O elemento Bindings só está disponível usando o SDK do Azure versão 1.3 ou superior.

Associação

O elemento Binding especifica informações de configuração necessárias para solicitações de comunicação com um site ou aplicativo Web.

O elemento Binding só está disponível usando o SDK do Azure versão 1.3 ou superior.

Atributo Tipo Descrição
name string Obrigatórios. Especifica um nome para identificar a associação.
endpointName string Obrigatórios. Especifica o nome do ponto de extremidade ao qual se associar.
hostHeader string Opcional. Especifica um nome de host que permite hospedar vários sites, com nomes de host diferentes, em uma única combinação de Endereço IP/Número da porta.

Inicialização

O elemento Startup descreve uma coleção de tarefas que são executadas quando a função é iniciada. Esse elemento pode ser o pai do elemento Variable. Para obter mais informações sobre como usar as tarefas de inicialização de função, consulte How to configure startup tasks (Como configurar tarefas de inicialização). Esse elemento é opcional e uma função pode ter apenas um bloco de inicialização.

A tabela a seguir descreve o atributo do elemento Startup.

Atributo Tipo Descrição
priority INT Somente para uso interno.

Tarefa

O elemento Task especifica a tarefa de inicialização que ocorre quando a função é iniciada. As tarefas de inicialização podem ser usadas para executar tarefas que preparam a função a ser executada, como instalar componentes de software ou executar outros aplicativos. As tarefas são executadas na ordem em que aparecem dentro do bloco de elemento Startup.

O elemento Task só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do elemento Task.

Atributo Tipo Descrição
commandLine string Obrigatórios. Um script, como um arquivo CMD, que contém os comandos a serem executados. O comando de inicialização e os arquivos de lote devem ser salvos no formato ANSI. Formatos de arquivo que definem um marcador de ordem de bytes no início do arquivo são processados ​​incorretamente.
executionContext string Especifica o contexto no qual o script é executado.

- limited [Padrão] – Executa com os mesmos privilégios que a função que hospeda o processo.
- elevated – Executa com privilégios de administrador.
taskType string Especifica o comportamento de execução do comando.

- simple [Padrão] – O sistema aguarda a tarefa ser encerrada antes de iniciar outras tarefas.
- background – O sistema não espera a conclusão da tarefa.
- foreground – Semelhante ao segundo plano, exceto que a função não é reiniciada até que todas as tarefas em primeiro plano sejam encerradas.

Contents

O elemento Contents descreve a coleção de conteúdo para uma função web. Esse elemento é o pai do elemento Content.

O elemento Contents só está disponível usando o SDK do Azure versão 1.5 ou superior.

Sumário

O elemento Content define o local de origem do conteúdo a ser copiado para a máquina virtual do Azure e o caminho de destino para o qual ele copia.

O elemento Content só está disponível usando o SDK do Azure versão 1.5 ou superior.

A tabela a seguir descreve os atributos do elemento Content.

Atributo Tipo Descrição
destino string Obrigatórios. Local na máquina virtual do Azure no qual o conteúdo é colocado. Esse local é relativo à pasta %ROLEROOT%\Approot.

Esse elemento é o pai do elemento SourceDirectory.

SourceDirectory

O elemento SourceDirectory define o diretório local do qual o conteúdo é copiado. Use esse elemento para especificar o conteúdo local a ser copiado para a máquina virtual do Azure.

O elemento SourceDirectory só está disponível usando o SDK do Azure versão 1.5 ou superior.

A tabela a seguir descreve os atributos do elemento SourceDirectory.

Atributo Tipo Descrição
caminho string Obrigatória. Caminho relativo ou absoluto de um diretório local cujo conteúdo é copiado para a máquina virtual do Azure. Há suporte para a expansão de variáveis de ambiente no caminho de diretório.

Próximas etapas

Esquema de Definição do Serviço de Nuvem (suporte estendido).