Esquema WebRole de Definição do Azure Serviços Cloud (clássico)

Artigo
06/15/2023

Importante

Serviços Cloud (clássico) é agora preterido para novos clientes e será descontinuado a 31 de agosto de 2024 para todos os clientes. As novas implementações devem utilizar o novo modelo de implementação baseado em Resource Manager do Azure Serviços Cloud (suporte alargado).

A função Web do Azure é uma função personalizada para a programação de aplicações Web, conforme suportado pelo IIS 7, como ASP.NET, PHP, Windows Communication Foundation e FastCGI.

A extensão predefinida para o ficheiro de definição de serviço é .csdef.

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

O formato básico de um ficheiro 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 ficheiro de definição de serviço inclui estes elementos, descritos em detalhe nas secções subsequentes deste tópico:

WebRole

ConfigurationSettings

InstanceInputEndpoint

AllocatePublicPortFrom

WebRole

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

A tabela seguinte descreve os atributos do WebRole elemento.

Atributo	Tipo	Descrição
name	string	Obrigatório. O nome da função Web. O nome da função tem de ser exclusivo.
enableNativeCodeExecution	boolean	Opcional. O valor predefinido é `true`; a execução de código nativo e a confiança total estão ativadas por predefinição. Defina este atributo para desativar a `false` execução de código nativo para a função Web e, em vez disso, utilize a confiança parcial do Azure.
vmsize	string	Opcional. Defina este valor para alterar o tamanho da máquina virtual atribuída à função. O valor predefinido é `Small`. Para obter mais informações, veja Tamanhos de Máquinas Virtuais para Serviços Cloud.

ConfigurationSettings

O ConfigurationSettings elemento descreve a coleção de definições de configuração para uma função Web. Este elemento é o elemento principal do Setting elemento.

Definições

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

A tabela seguinte descreve os atributos do Setting elemento.

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

As definições de configuração de uma função são pares de nomes e valores que são declarados no ficheiro de definição de serviço e definidos no ficheiro de configuração do serviço.

LocalResources

O LocalResources elemento descreve a coleção de recursos de armazenamento local para uma função Web. Este elemento é o elemento principal do LocalStorage elemento.

LocalStorage

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

Nota

O LocalStorage elemento pode aparecer como um elemento subordinado do WebRole elemento para suportar a compatibilidade com versões anteriores do SDK do Azure.

A tabela seguinte descreve os atributos do LocalStorage elemento.

Atributo	Tipo	Descrição
name	string	Obrigatório. Um nome exclusivo para o arquivo local.
cleanOnRoleRecycle	boolean	Opcional. Indica se o arquivo local deve ser limpo quando a função é reiniciada. O valor predefinido é `true`.
sizeInMb	int	Opcional. A quantidade pretendida de espaço de armazenamento a alocar para o arquivo local, em MB. Se não for especificado, o espaço de armazenamento predefinido alocado é de 100 MB. A quantidade mínima de espaço de armazenamento que pode ser alocado é de 1 MB. O tamanho máximo dos recursos locais depende do tamanho da máquina virtual. Para obter mais informações, veja Virtual Machine sizes for Serviços Cloud (Tamanhos das Máquinas Virtuais para Serviços Cloud).

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

Pontos Finais

O Endpoints elemento descreve a coleção de pontos finais de entrada (externos), internos e de entrada de instâncias para uma função. Este elemento é o elemento principal dos InputEndpointelementos , InternalEndpointe InstanceInputEndpoint .

Os pontos finais internos e de entrada são alocados separadamente. Um serviço pode ter um total de 25 pontos finais de entrada, internos e de instância que podem ser alocados nas 25 funções permitidas num serviço. Por exemplo, se tiver 5 funções, pode alocar 5 pontos finais de entrada por função ou pode alocar 25 pontos finais de entrada a uma única função ou pode alocar 1 ponto final de entrada a cada uma a 25 funções.

Nota

Cada função implementada requer uma instância por função. O aprovisionamento predefinido de uma subscrição está limitado a 20 núcleos e, portanto, está limitado a 20 instâncias de uma função. Se a sua aplicação precisar de mais instâncias do que as fornecidas pelo aprovisionamento predefinido , veja Faturação, Gestão de Subscrições e Suporte de Quota para obter mais informações sobre como aumentar a quota.

InputEndpoint

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

Pode definir vários pontos finais que são uma combinação de pontos finais HTTP, HTTPS, UDP e TCP. Pode especificar qualquer número de porta que escolher para um ponto final de entrada, mas os números de porta especificados para cada função no serviço têm de ser exclusivos. Por exemplo, se especificar que uma função Web utiliza a porta 80 para HTTP e a porta 443 para HTTPS, poderá especificar que uma segunda função Web utiliza a porta 8080 para HTTP e a porta 8043 para HTTPS.

A tabela seguinte descreve os atributos do InputEndpoint elemento .

Atributo	Tipo	Descrição
name	string	Obrigatório. Um nome exclusivo para o ponto final externo.
protocolo	string	Obrigatório. O protocolo de transporte para o ponto final externo. Para uma função da Web, os valores possíveis são `HTTP`, `HTTPS`, `UDP`ou `TCP`.
porta	int	Obrigatório. A porta para o ponto final externo. Pode especificar qualquer número de porta que escolher, mas os números de porta especificados para cada função no serviço têm de ser exclusivos. Os valores possíveis variam entre 1 e 65535, inclusive (versão 1.7 ou superior do SDK do Azure).
certificado	string	Necessário para um ponto final HTTPS. O nome de um certificado definido por um `Certificate` elemento.
localPort	int	Opcional. Especifica uma porta utilizada para ligações internas no ponto final. O `localPort` atributo mapeia a porta externa no ponto final para uma porta interna numa função. Isto é útil em cenários em que uma função tem de comunicar com um componente interno numa porta diferente daquela que é exposta externamente. Se não for especificado, o valor de `localPort` é igual ao `port` atributo . Defina o valor de `localPort` como "*" para atribuir automaticamente uma porta não alocada que é detetável com a API de runtime. Os valores possíveis variam entre 1 e 65535, inclusive (versão 1.7 ou superior do SDK do Azure). O `localPort` atributo só está disponível com a versão 1.3 ou superior do SDK do Azure.
ignoreRoleInstanceStatus	boolean	Opcional. Quando o valor deste atributo está definido como `true`, o estado de um serviço é ignorado e o ponto final não será removido pelo balanceador de carga. Definir este valor como `true` útil para depurar instâncias ocupadas de um serviço. O valor predefinido é `false`. Nota: Um ponto final ainda pode receber tráfego mesmo quando a função não está num estado Pronto.
loadBalancerProbe	string	Opcional. O nome da sonda do balanceador de carga associada ao ponto final de entrada. Para obter mais informações, veja LoadBalancerProbe Schema (Esquema LoadBalancerProbe).

InternalEndpoint

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

A tabela seguinte descreve os atributos do InternalEndpoint elemento .

Atributo	Tipo	Descrição
name	string	Obrigatório. Um nome exclusivo para o ponto final interno.
protocolo	string	Obrigatório. O protocolo de transporte para o ponto final 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 utilizada para ligações internas com balanceamento de carga no ponto final. Um ponto final com balanceamento de carga utiliza duas portas. A porta utilizada para o endereço IP público e a porta utilizada no endereço IP privado. Normalmente, estas são definidas como as mesmas, mas pode optar por utilizar portas diferentes. Os valores possíveis variam entre 1 e 65535, inclusive (versão 1.7 ou superior do SDK do Azure). O `Port` atributo só está disponível com a versão 1.3 ou superior do SDK do Azure.

InstanceInputEndpoint

O InstanceInputEndpoint elemento descreve um ponto final de entrada de instância para uma função Web. Um ponto final de entrada de instância está associado a uma instância de função específica através do reencaminhamento de portas no balanceador de carga. Cada ponto final de entrada de instância é mapeado para uma porta específica a partir de um intervalo de portas possíveis. Este elemento é o elemento principal do AllocatePublicPortFrom elemento.

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

A tabela seguinte descreve os atributos do InstanceInputEndpoint elemento.

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

AllocatePublicPortFrom

O AllocatePublicPortFrom elemento descreve o intervalo de portas públicas que pode ser utilizado por clientes externos para aceder a cada ponto final de entrada de instância. O número de porta pública (VIP) é atribuído a partir deste intervalo e atribuído a cada ponto final de instância de função individual durante a implementação e atualização do inquilino. Este elemento é o elemento principal do FixedPortRange elemento.

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

FixedPort

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

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

A tabela seguinte descreve os atributos do FixedPort elemento.

Atributo	Tipo	Descrição
porta	int	Obrigatório. A porta do ponto final interno. Isto tem o mesmo efeito que definir o `FixedPortRange` mínimo e o máximo para a mesma porta. Os valores possíveis variam entre 1 e 65535, inclusive (versão 1.7 ou superior do SDK do Azure).

FixedPortRange

O FixedPortRange elemento especifica o intervalo de portas que são atribuídas ao ponto final interno ou ao ponto final de entrada da instância e define a porta utilizada para ligações com balanceamento de carga no ponto final.

Nota

O FixedPortRange elemento funciona de forma diferente consoante o elemento em que reside. Quando o FixedPortRange elemento está no InternalEndpoint elemento, abre todas as portas no balanceador de carga dentro do intervalo dos atributos min e max para todas as máquinas virtuais nas quais a função é executada. Quando o FixedPortRange elemento está no InstanceInputEndpoint elemento, abre apenas uma porta dentro do intervalo dos atributos min e max em cada máquina virtual que executa a função.

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

A tabela seguinte descreve os atributos do FixedPortRange elemento.

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

Certificados

O Certificates elemento descreve a coleção de certificados para uma função Web. Este elemento é o elemento principal do Certificate elemento. Uma função pode ter qualquer número de certificados associados. Para obter mais informações sobre como utilizar o elemento certificados, veja Modificar o ficheiro definição de serviço com um certificado.

Certificado

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

A tabela seguinte descreve os atributos do Certificate elemento.

Atributo	Tipo	Descrição
name	string	Obrigatório. Um nome para este certificado, que é utilizado para fazer referência ao mesmo quando está associado a um elemento HTTPS `InputEndpoint` .
storeLocation	string	Obrigatório. A localização do arquivo de certificados onde este certificado pode ser encontrado no computador local. Os valores possíveis são `CurrentUser` e `LocalMachine`.
storeName	string	Obrigatório. O nome do arquivo de certificados onde este certificado reside no computador local. Os valores possíveis incluem os nomes `My`de arquivo incorporados , `Root`, `CA`, `Trust`, `Disallowed`, `TrustedPeople`, `TrustedPublisher`, `AuthRoot`, ou `AddressBook`qualquer nome de arquivo personalizado. Se for especificado um nome de arquivo personalizado, o arquivo é criado automaticamente.
permissionLevel	string	Opcional. Especifica as permissões de acesso dadas aos processos de função. Se quiser que apenas os processos elevados possam aceder à chave privada, especifique `elevated` a permissão. `limitedOrElevated` a permissão permite que todos os processos de função acedam à chave privada. Os valores possíveis são `limitedOrElevated` ou `elevated`. O valor predefinido é `limitedOrElevated`.

Importações

O Imports elemento descreve uma coleção de módulos de importação para uma função Web que adiciona componentes ao sistema operativo convidado. Este elemento é o elemento principal do Import elemento. Este elemento é opcional e uma função só pode ter um bloco de importações.

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

Importar

O Import elemento especifica um módulo a adicionar ao sistema operativo convidado.

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

A tabela seguinte descreve os atributos do Import elemento.

Atributo	Tipo	Descrição
moduleName	string	Obrigatório. O nome do módulo a importar. Os módulos de importação válidos são: - RemoteAccess - RemoteForwarder - Diagnósticos Os módulos RemoteAccess e RemoteForwarder permitem-lhe configurar a sua instância de função para ligações de ambiente de trabalho remoto. Para obter mais informações, veja Ativar Ligação ao Ambiente de Trabalho Remoto. O módulo Diagnóstico permite-lhe recolher dados de diagnóstico para uma instância de função.

Runtime

O Runtime elemento descreve uma coleção de definições de variáveis de ambiente para uma função Web que controla o ambiente de runtime do processo de anfitrião do Azure. Este elemento é o elemento principal do Environment elemento. Este elemento é opcional e uma função só pode ter um bloco de runtime.

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

A tabela seguinte descreve os atributos do Runtime elemento:

Atributo	Tipo	Descrição
executionContext	string	Opcional. Especifica o contexto no qual o Processo de Função é iniciado. O contexto predefinido é `limited`. - `limited` – O processo é iniciado sem privilégios de Administrador. - `elevated` – O processo é iniciado com privilégios de Administrador.

Ambiente

O Environment elemento descreve uma coleção de definições de variáveis de ambiente para uma função Web. Este elemento é o elemento principal do Variable elemento. Uma função pode ter qualquer número de variáveis de ambiente definidas.

Variável

O Variable elemento especifica uma variável de ambiente a definir na operação de convidado.

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

A tabela seguinte descreve os atributos do Variable elemento:

Atributo	Tipo	Descrição
name	string	Obrigatório. O nome da variável de ambiente a definir.
valor	string	Opcional. O valor a definir para a variável de ambiente. Tem de incluir um atributo de valor ou um `RoleInstanceValue` elemento.

RoleInstanceValue

O RoleInstanceValue elemento especifica o xPath a partir do qual obter o valor da variável.

A tabela seguinte descreve os atributos do RoleInstanceValue elemento.

Atributo	Tipo	Descrição
xpath	string	Opcional. Caminho de localização das definições de implementação da instância. Para obter mais informações, veja Configuration variables with XPath (Variáveis de configuração com XPath). Tem de incluir um atributo de valor ou um `RoleInstanceValue` elemento.

EntryPoint

O EntryPoint elemento especifica o ponto de entrada de uma função. Este elemento é o elemento principal dos NetFxEntryPoint elementos. Estes elementos permitem-lhe especificar uma aplicação que não seja a WaWorkerHost.exe predefinida para agir como o ponto de entrada de função.

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

NetFxEntryPoint

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

Nota

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

A tabela seguinte descreve os atributos do NetFxEntryPoint elemento.

Atributo	Tipo	Descrição
assemblyName	string	Obrigatório. O caminho e o nome do ficheiro da assemblagem que contém o ponto de entrada. O caminho é relativo à pasta \%ROLEROOT%\Approot (não especifique \%ROLEROOT%\Approot no `commandLine`, é assumido). %ROLEROOT% é uma variável de ambiente mantida pelo Azure e representa a localização da pasta raiz para a sua função. A pasta \%ROLEROOT%\Approot representa a pasta da aplicação para a sua função. Para funções HWC, o caminho é sempre relativo à pasta \%ROLEROOT%\Approot\bin . Para funções Web completas do IIS e IIS Express, se não for possível localizar a assemblagem relativamente à pasta \%ROLEROOT%\Approot, é pesquisada \%ROLEROOT%\Approot\bin. Este comportamento de contingência para o IIS completo não é uma melhor prática recomendada e talvez seja removido em versões futuras.
targetFrameworkVersion	string	Obrigatório. A versão do .NET Framework no qual a assemblagem foi criada. Por exemplo, `targetFrameworkVersion="v4.0"`.

Sites

O Sites elemento descreve uma coleção de sites e aplicações Web que estão alojados numa função Web. Este elemento é o elemento principal do Site elemento. Se não especificar um Sites elemento, a sua função Web é alojada como função Web legada e só pode ter um site alojado na sua função Web. Este elemento é opcional e uma função só pode ter um bloco de sites.

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

Site

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

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

A tabela seguinte descreve os atributos do Site elemento.

Atributo	Tipo	Descrição
name	string	Obrigatório. Nome do site ou da aplicação.
physicalDirectory	string	A localização do diretório de conteúdo para a raiz do site. A localização pode ser especificada como um caminho absoluto ou relativamente à localização .csdef.

VirtualApplication

O VirtualApplication elemento define que uma aplicação nos Serviços de Informação Internet (IIS) 7 é um agrupamento de ficheiros que fornece conteúdo ou fornece serviços através de protocolos, como HTTP. Quando cria uma aplicação no IIS 7, o caminho da aplicação torna-se parte do URL do site.

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

A tabela seguinte descreve os atributos do VirtualApplication elemento.

Atributo	Tipo	Descrição
name	string	Obrigatório. Especifica um nome para identificar a aplicação virtual.
physicalDirectory	string	Obrigatório. Especifica o caminho na máquina de desenvolvimento que contém a aplicação virtual. No emulador de computação, o IIS está configurado para obter conteúdo a partir desta localização. Ao implementar no Azure, os conteúdos do diretório físico são empacotados juntamente com o resto do serviço. Quando o pacote de serviço é implementado no Azure, o IIS é configurado com a localização dos conteúdos não embalados.

VirtualDirectory

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

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

A tabela seguinte descreve os atributos do VirtualDirectory elemento.

Atributo	Tipo	Descrição
name	string	Obrigatório. Especifica um nome para identificar o diretório virtual.
valor	physicalDirectory	Obrigatório. Especifica o caminho na máquina de desenvolvimento que contém o site ou o conteúdo do diretório virtual. No emulador de computação, o IIS está configurado para obter conteúdo a partir desta localização. Ao implementar no Azure, os conteúdos do diretório físico são empacotados juntamente com o resto do serviço. Quando o pacote de serviço é implementado no Azure, o IIS é configurado com a localização dos conteúdos não embalados.

Enlaces

O Bindings elemento descreve uma coleção de enlaces para um site. É o elemento principal do Binding elemento. O elemento é necessário para cada Site elemento. Para obter mais informações sobre como configurar pontos finais, veja Ativar a Comunicação para Instâncias de Função.

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

Enlace

O Binding elemento especifica as informações de configuração necessárias para que os pedidos comuniquem com um site ou aplicação Web.

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

Atributo	Tipo	Descrição
name	string	Obrigatório. Especifica um nome para identificar o enlace.
endpointName	string	Obrigatório. Especifica o nome do ponto final a que se vincular.
hostHeader	string	Opcional. Especifica um nome de anfitrião que lhe permite alojar vários sites, com nomes de anfitrião diferentes, numa única combinação de número de endereço IP/porta.

Arranque

O Startup elemento descreve uma coleção de tarefas que são executadas quando a função é iniciada. Este elemento pode ser o elemento principal do Variable elemento. Para obter mais informações sobre como utilizar as tarefas de arranque de funções, veja Como configurar tarefas de arranque. Este elemento é opcional e uma função só pode ter um bloco de arranque.

A tabela seguinte descreve o atributo do Startup elemento.

Atributo	Tipo	Descrição
prioridade	int	Apenas para utilização interna.

Tarefa

O Task elemento especifica a tarefa de arranque que ocorre quando a função é iniciada. As tarefas de arranque podem ser utilizadas para executar tarefas que preparem a função para executar esses componentes de software de instalação ou executar outras aplicações. As tarefas são executadas pela ordem pela qual aparecem no bloco de Startup elementos.

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

A tabela seguinte descreve os atributos do Task elemento.

Atributo	Tipo	Descrição
commandLine	string	Obrigatório. Um script, como um ficheiro CMD, que contém os comandos a executar. O comando de arranque e os ficheiros em lote têm de ser guardados no formato ANSI. Os formatos de ficheiro que definem um marcador de ordem de bytes no início do ficheiro não serão processados corretamente.
executionContext	string	Especifica o contexto em que o script é executado. - `limited` [Predefinição] – execute com os mesmos privilégios que a função que aloja o processo. - `elevated` – Execute com privilégios de administrador.
taskType	string	Especifica o comportamento de execução do comando. - `simple` [Predefinição] – o sistema aguarda que a tarefa saia antes de quaisquer outras tarefas serem iniciadas. - `background` – O sistema não aguarda a saída da tarefa. - `foreground` – Semelhante ao fundo, exceto que a função não é reiniciada até que todas as tarefas em primeiro plano saiam.

Conteúdos

O Contents elemento descreve a coleção de conteúdos para uma função Web. Este elemento é o elemento principal do Content elemento .

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

Conteúdo

O Content elemento define a localização de origem do conteúdo a copiar para a máquina virtual do Azure e o caminho de destino para o qual é copiado.

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

A tabela seguinte descreve os atributos do Content elemento .

Atributo	Tipo	Descrição
destino	string	Obrigatório. Localização na máquina virtual do Azure para a qual o conteúdo é colocado. Esta localização é relativa à pasta %ROLEROOT%\Approot.

Este elemento é o elemento principal do SourceDirectory elemento .

SourceDirectory

O SourceDirectory elemento define o diretório local a partir do qual o conteúdo é copiado. Utilize este elemento para especificar os conteúdos locais a copiar para a máquina virtual do Azure.

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

A tabela seguinte descreve os atributos do SourceDirectory elemento .

Atributo	Tipo	Descrição
caminho	cadeia (de carateres)	Obrigatório. Caminho relativo ou absoluto de um diretório local cujos conteúdos serão copiados para a máquina virtual do Azure. A expansão das variáveis de ambiente no caminho do diretório é suportada.

Consulte também

Esquema de Definição do Serviço Cloud (clássico)

Esquema WebRole de Definição do Azure Serviços Cloud (clássico)

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

Elementos de esquema

WebRole

ConfigurationSettings

Definições

LocalResources

LocalStorage

Pontos Finais

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Certificados

Certificado

Importações

Importar

Runtime

Ambiente

Variável

RoleInstanceValue

EntryPoint

NetFxEntryPoint

Sites

Site

VirtualApplication

VirtualDirectory

Enlaces

Enlace

Arranque

Tarefa

Conteúdos

Conteúdo

SourceDirectory

Consulte também

Recursos adicionais