Compartilhar via

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

Importante

A partir de 31 de março de 2025, os Serviços de nuvem (suporte estendido) serão preteridos e serão totalmente desativados em 31 de março de 2027. Saiba mais sobre essa substituição e como migrar.

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

Importações

Importação

Runtime

Ambiente

Variável

RoleInstanceValue

NetFxEntryPoint

Sites

Local

VirtualApplication

VirtualApplication

Vinculações

Vinculação

Inicialização

Tarefa

Conteúdo

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
nome cadeia de caracteres Obrigatório. O nome para a função web. O nome da função deve ser exclusivo.
ativarExecuçãoDeCódigoNativo booliano 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 cadeia de caracteres 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.

Configurações

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
nome cadeia de caracteres Obrigatório. 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.

Recursos Locais

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

Armazenamento Local

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
nome cadeia de caracteres Obrigatório. Um nome exclusivo para a loja local.
cleanOnRoleRecycle booliano Opcional. Indica se o repositório local deve ser limpo quando a função é reiniciada. O valor padrão é true.
tamanhoEmMb 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.

Ponto de Entrada

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 de porta que você escolher para um ponto de extremidade de entrada, mas os números de porta especificados para cada função no serviço devem ser únicos. 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
nome cadeia de caracteres Obrigatório. Um nome exclusivo para o ponto de extremidade externo.
protocolo cadeia de caracteres Obrigatório. 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.
porto int Obrigatório. 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 cadeia de caracteres 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 dispositivo. 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 booliano 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 estiver em um estado Pronto.
loadBalancerProbe cadeia de caracteres Opcional. O nome da investigação 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 endpoint 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
nome cadeia de caracteres Obrigatório. Um nome exclusivo para o ponto de extremidade interno.
protocolo cadeia de caracteres Obrigatório. 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.
porto int Opcional. A porta usada para conexões internas com balanceamento de carga no ponto de extremidade. Um endpoint com balanceamento de carga utiliza 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
nome cadeia de caracteres Obrigatório. Um nome exclusivo para o ponto de extremidade.
localPort int Obrigatório. Especifica a porta interna que todas as instâncias de função escutam para receberem o tráfego de entrada encaminhado do balanceador de carga. Os valores possíveis variam entre 1 e 65535, inclusive.
protocolo cadeia de caracteres Obrigatório. 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.

AlocarPortaPúblicaDe

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.

Porta Fixa

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
porto int Obrigatório. 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
minutos int Obrigatório. 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).
máximo cadeia de caracteres Obrigatório. 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
nome cadeia de caracteres Obrigatório. Um nome para esse certificado, que é usado para se referir a ele quando está associado a um elemento HTTPS InputEndpoint.
localização da loja cadeia de caracteres Obrigatório. 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.
Nome da Loja cadeia de caracteres Obrigatório. 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.
nível de permissão cadeia de caracteres 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
nomeDoMódulo cadeia de caracteres Obrigatório. 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 Diagnóstico permite coletar dados de diagnóstico para uma instância de função.

Tempo de Execução

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
contexto de execução cadeia de caracteres 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
nome cadeia de caracteres Obrigatório. O nome da variável de ambiente a ser definida.
valor cadeia de caracteres 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 cadeia de caracteres 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.

Ponto de Entrada

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
nomeDoAssembly cadeia de caracteres Obrigatório. 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, o caminho \%ROLEROOT%\Approot\bin será pesquisado.

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

Sítios

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.

Sítio

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
nome cadeia de caracteres Obrigatório. Nome do site ou aplicativo.
physicalDirectory cadeia de caracteres 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.

Aplicativo Virtual

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
nome cadeia de caracteres Obrigatório. Especifica um nome para identificar o aplicativo virtual.
physicalDirectory cadeia de caracteres Obrigatório. 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.

Diretório Virtual

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
nome cadeia de caracteres Obrigatório. Especifica um nome para identificar o diretório virtual.
valor physicalDirectory Obrigatório. 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 terminais, consulte Habilitar comunicação para instâncias funcionais.

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
nome cadeia de caracteres Obrigatório. Especifica um nome para identificar a associação.
nome do ponto de extremidade cadeia de caracteres Obrigatório. Especifica o nome do ponto de extremidade ao qual se associar.
cabeçalho do host cadeia de caracteres 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
prioridade 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
linha de comando cadeia de caracteres Obrigatório. 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.
contexto de execução cadeia de caracteres 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.
tipoDeTarefa cadeia de caracteres 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.

Conteúdo

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 cadeia de caracteres Obrigatório. 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 cadeia de caracteres Obrigatório. 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).

  • Last updated on