Esquema WebRole de definição dos Serviços de Nuvem do Azure (suporte estendido)
A função Web do Azure é uma função personalizada para programação de aplicativos Web com suporte no IIS 7, como ASP.NET, PHP, Windows Communication Foundation e FastCGI.
A extensão padrão para o arquivo 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 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 do esquema
O arquivo de definição de serviço inclui esses elementos, descritos em detalhes nas seções subsequentes deste artigo:
WebRole
O WebRole
elemento descreve uma função personalizada para programação de aplicativos Web, conforme suportado pelo IIS 7 e ASP.NET. Um serviço pode conter zero ou mais funções Web.
A tabela a seguir descreve os atributos do WebRole
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. O nome da função Web. O nome da função deve ser exclusivo. |
enableNativeCodeExecution | boolean | Opcional. O valor padrão é true ; a execução de código nativo e a confiança total são ativadas por padrão. Defina esse atributo como false para desabilitar a execução de código nativo para a função Web e use a confiança parcial do Azure. |
vmsize | string | Opcional. Defina esse valor para alterar o tamanho da máquina virtual alocada à função. O valor predefinido é Small . Para obter mais informações, consulte Tamanhos de máquinas virtuais para serviços de nuvem. |
ConfiguraçõesDefinições
O ConfigurationSettings
elemento descreve a coleção de definições de configuração para uma função Web. Este elemento é o pai do Setting
elemento .
Definição
O Setting
elemento 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 Setting
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | 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 que são declarados no arquivo de definição de serviço e definidos no arquivo de configuração de serviço.
Recursos Locais
O LocalResources
elemento descreve a coleção de recursos de armazenamento local para uma função Web. Este elemento é o pai do LocalStorage
elemento .
Armazenamento local
O LocalStorage
elemento identifica um recurso de armazenamento local que fornece espaço do sistema de arquivos para o serviço em tempo de execução. Uma função pode definir zero ou mais recursos de armazenamento local.
Nota
O LocalStorage
elemento pode aparecer como um filho do WebRole
elemento para dar suporte à compatibilidade com versões anteriores do SDK do Azure.
A tabela a seguir descreve os atributos do LocalStorage
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Um nome exclusivo para a loja local. |
cleanOnRoleRecycle | boolean | Opcional. Indica se o armazenamento local deve ser limpo quando a função é reiniciada. O valor predefinido é true . |
tamanhoInMb | número inteiro | Opcional. A quantidade desejada de espaço de armazenamento para alocar para o armazenamento local, em MB. Se não for especificado, o espaço de armazenamento padrão alocado é de 100 MB. A quantidade mínima de espaço de armazenamento que pode ser alocada é de 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áquinas virtuais para serviços de nuvem. |
O nome do diretório alocado para o recurso de armazenamento local corresponde ao valor fornecido para o atributo name.
Pontos finais
O Endpoints
elemento descreve a coleção de pontos de extremidade de entrada (externos), internos e de instância para uma função. Este elemento é o pai dos InputEndpoint
elementos , InternalEndpoint
e InstanceInputEndpoint
.
Os pontos finais internos e de entrada 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, alocar 25 pontos de extremidade de entrada para uma única função ou alocar um ponto de extremidade de entrada cada para 25 funções.
Nota
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 o seu aplicativo exigir mais instâncias do que as fornecidas pelo provisionamento padrão, consulte Cobrança, gerenciamento de assinatura e suporte a cotas para obter mais informações sobre como aumentar sua cota.
InputEndpoint
O InputEndpoint
elemento descreve um ponto de extremidade externo para uma função Web.
Você pode definir vários pontos de extremidade que são uma combinação de pontos de extremidade HTTP, HTTPS, UDP e TCP. Você pode especificar qualquer número de porta escolhido para um ponto de extremidade de entrada, mas os números de 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, poderá especificar que uma segunda função Web use a porta 8080 para HTTP e a porta 8043 para HTTPS.
A tabela a seguir descreve os atributos do InputEndpoint
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Um nome exclusivo para o ponto de extremidade externo. |
protocolo | string | 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 . |
porta | número inteiro | Obrigatório. A porta para o ponto de extremidade externo. Você pode especificar qualquer número de porta escolhido, mas os números de 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 | Necessário para um ponto de extremidade HTTPS. O nome de um certificado definido por um Certificate elemento. |
localPort | número inteiro | Opcional. Especifica uma porta usada para conexões internas no ponto de extremidade. O localPort atributo mapeia a porta externa no ponto de extremidade para uma porta interna em uma função. Esse atributo é útil em cenários em que uma função deve se comunicar com um componente interno em uma porta diferente daquela que é exposta externamente.Se não for especificado, o valor de localPort é o mesmo que o port atributo. Defina o valor de "*" para atribuir automaticamente uma porta não alocada que possa ser detetada usando a API de tempo de localPort execução.Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior). O localPort atributo só está disponível usando o SDK do Azure versão 1.3 ou superior. |
ignoreRoleInstanceStatus | boolean | Opcional. Quando o valor desse atributo é definido como true , o status de um serviço é ignorado e o balanceador de carga não remove o ponto de extremidade. Definir esse valor como true útil para depurar instâncias ocupadas de um serviço. O valor predefinido é false . Observação: um ponto de extremidade ainda pode receber tráfego mesmo quando a função não está no 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 Esquema LoadBalancerProbe. |
InternalEndpoint
O InternalEndpoint
elemento 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; não está disponível para clientes fora do serviço. As funções Web que não incluem o Sites
elemento só podem ter um único ponto de extremidade interno HTTP, UDP ou TCP.
A tabela a seguir descreve os atributos do InternalEndpoint
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Um nome exclusivo para o ponto de extremidade interno. |
protocolo | string | 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 é permitido. |
porta | número inteiro | 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 como os mesmos, 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 Port atributo só está disponível usando o SDK do Azure versão 1.3 ou superior. |
InstanceInputEndpoint
O InstanceInputEndpoint
elemento descreve um ponto de extremidade de entrada de instância para uma função Web. Um ponto de extremidade de entrada de instância é 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 a partir de um intervalo de portas possíveis. Este elemento é o pai do AllocatePublicPortFrom
elemento .
O InstanceInputEndpoint
elemento só está disponível usando o SDK do Azure versão 1.7 ou superior.
A tabela a seguir descreve os atributos do InstanceInputEndpoint
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Um nome exclusivo para o ponto de extremidade. |
localPort | número inteiro | Obrigatório. 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ório. O protocolo de transporte para o ponto de extremidade interno. Os valores possíveis são udp ou tcp . Use tcp para tráfego baseado em http/https. |
AllocatePublicPortFrom
O AllocatePublicPortFrom
elemento 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 a partir desse intervalo e atribuído a cada ponto de extremidade de instância de função individual durante a implantação e atualização do locatário. Este elemento é o pai do FixedPortRange
elemento .
O AllocatePublicPortFrom
elemento só está disponível usando o SDK do Azure versão 1.7 ou superior.
Porta Fixa
O FixedPort
elemento especifica a porta para o ponto de extremidade interno, que permite conexões com balanceamento de carga no ponto de extremidade.
O FixedPort
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do FixedPort
elemento .
Atributo | Tipo | Description |
---|---|---|
porta | número inteiro | Obrigatório. A porta para o ponto de extremidade interno. Este atributo tem o mesmo efeito que definir o min e max FixedPortRange 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 FixedPortRange
elemento especifica o intervalo de portas atribuídas ao ponto de extremidade de entrada interno ou ao ponto de extremidade de entrada da instância e define a porta usada para conexões com balanceamento de carga no ponto de extremidade.
Nota
O FixedPortRange
elemento funciona de forma diferente dependendo do elemento em que reside. Quando o FixedPortRange
elemento está no InternalEndpoint
elemento , ele 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 , ele 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 usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do FixedPortRange
elemento .
Atributo | Tipo | Description |
---|---|---|
min | número inteiro | 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). |
max | string | 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 Certificates
elemento descreve a coleção de certificados para uma função Web. Este elemento é o pai do Certificate
elemento . Uma função pode ter qualquer número de certificados associados. Para obter mais informações sobre como usar o elemento certificates, consulte Modificar o arquivo de definição de serviço com um certificado.
Certificado
O Certificate
elemento descreve um certificado associado a uma função Web.
A tabela a seguir descreve os atributos do Certificate
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Um nome para esse certificado, que é usado para se referir a ele quando está associado a um elemento HTTPS InputEndpoint . |
storeLocalização | string | Obrigatório. O local do armazenamento de certificados onde esse certificado pode ser encontrado na máquina local. Os valores possíveis são CurrentUser e LocalMachine . |
nome_da_loja | string | Obrigatório. O nome do armazenamento de certificados onde esse certificado reside na máquina local. Os valores possíveis incluem os nomes My de loja internos , Root , , CA , Trust , Disallowed TrustedPeople , , TrustedPublisher AuthRoot , , AddressBook ou qualquer nome de loja personalizada. Se um nome de loja personalizado for especificado, o repositório será criado automaticamente. |
permissionLevel | string | Opcional. Especifica as permissões de acesso dadas aos processos de função. Se você quiser que apenas processos elevados possam acessar a chave privada, especifique elevated a permissão. limitedOrElevated permissão permite que todos os processos de função acessem a 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 adicionam componentes ao sistema operacional convidado. Este elemento é o pai do Import
elemento . Este elemento é opcional e uma função pode ter apenas um bloco de importações.
O Imports
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
Importar
O Import
elemento especifica um módulo a ser adicionado ao sistema operacional convidado.
O Import
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do Import
elemento .
Atributo | Tipo | Description |
---|---|---|
nome_do_módulo | string | Obrigatório. O nome do módulo a ser importado. Os módulos de importação válidos são: - Acesso Remoto - RemoteForwarder - Diagnósticos Os módulos RemoteAccess e RemoteForwarder permitem configurar 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. |
Runtime
O Runtime
elemento descreve uma coleção de configurações de variáveis de ambiente para uma função Web que controlam o ambiente de tempo de execução do processo de host do Azure. Este elemento é o pai do Environment
elemento . Esse elemento é opcional e uma função pode ter apenas um bloco de tempo de execução.
O Runtime
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do Runtime
elemento :
Atributo | Tipo | Description |
---|---|---|
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. |
Environment
O Environment
elemento descreve uma coleção de configurações de variáveis de ambiente para uma função Web. Este elemento é o pai 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 ser definida na operação convidada.
O Variable
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do Variable
elemento :
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. O nome da variável de ambiente a ser definida. |
valor | string | Opcional. O valor a ser definido para a variável de ambiente. Você deve incluir um atributo value ou um RoleInstanceValue elemento . |
RoleInstanceValue
O RoleInstanceValue
elemento especifica o xPath do qual recuperar o valor da variável.
A tabela a seguir descreve os atributos do RoleInstanceValue
elemento .
Atributo | Tipo | Description |
---|---|---|
XPath | string | Opcional. Caminho de local das configurações de implantação para a instância. Para obter mais informações, consulte Variáveis de configuração com XPath. Você deve incluir um atributo value ou um RoleInstanceValue elemento . |
EntryPoint
O EntryPoint
elemento especifica o ponto de entrada para uma função. Este elemento é o pai dos NetFxEntryPoint
elementos. 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 EntryPoint
elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.
NetFxEntryPoint
O NetFxEntryPoint
elemento especifica o programa a ser executado para uma função.
Nota
O NetFxEntryPoint
elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.
A tabela a seguir descreve os atributos do NetFxEntryPoint
elemento .
Atributo | Tipo | Description |
---|---|---|
assemblyName | string | 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; presume-se). %ROLEROOT% é uma variável de ambiente mantida pelo Azure e representa o local da pasta raiz para sua função. A pasta \%ROLEROOT%\Approot representa a pasta do aplicativo para sua função. Para funções HWC, o caminho é sempre relativo à pasta \%ROLEROOT%\Approot\bin . Para funções Web completas do IIS e do IIS Express, se o assembly não puder ser encontrado em relação à pasta \%ROLEROOT%\Approot , o \%ROLEROOT%\Approot\bin será pesquisado. Esse comportamento de fallback para o IIS completo não é uma prática recomendada e talvez seja removido em versões futuras. |
targetFrameworkVersion | string | Obrigatório. A versão do .NET Framework na qual o assembly foi criado. Por exemplo, targetFrameworkVersion="v4.0" . |
Sites
O Sites
elemento descreve uma coleção de sites e aplicativos Web hospedados em uma função Web. Este elemento é o pai do Site
elemento . Se você não especificar um Sites
elemento, 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 Sites
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
Site
O Site
elemento especifica um site ou aplicativo Web que faz parte da função Web.
O Site
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do Site
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Nome do site ou aplicativo. |
Diretório físico | 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 csdef. |
Aplicação virtual
O VirtualApplication
elemento define um aplicativo no IIS (Serviços de Informações da Internet) 7 é um agrupamento de arquivos que fornece conteúdo ou fornece serviços por meio de protocolos, como HTTP. Quando você cria um aplicativo no IIS 7, o caminho do aplicativo se torna parte da URL do site.
O VirtualApplication
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do VirtualApplication
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Especifica um nome para identificar o aplicativo virtual. |
Diretório físico | string | Obrigatório. Especifica o caminho na máquina de desenvolvimento que contém o aplicativo virtual. No emulador de computação, o IIS é configurado para recuperar conteúdo desse local. Quando implantado no Azure, o conteúdo do diretório físico é empacotado junto com o restante do serviço. Quando o pacote de serviço é implantado no Azure, o IIS é configurado com o local do conteúdo descompactado. |
Diretório virtual
O VirtualDirectory
elemento especifica um nome de diretório (também conhecido como caminho) que você especifica no IIS e mapeia para um diretório físico em um servidor local ou remoto.
O VirtualDirectory
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do VirtualDirectory
elemento .
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Especifica um nome para identificar o diretório virtual. |
valor | Diretório físico | Obrigatório. Especifica o caminho na máquina de desenvolvimento que contém o conteúdo do site ou do diretório virtual. No emulador de computação, o IIS é configurado para recuperar conteúdo desse local. Quando implantado no Azure, o conteúdo do diretório físico é empacotado junto com o restante do serviço. Quando o pacote de serviço é implantado no Azure, o IIS é configurado com o local do conteúdo descompactado. |
Enlaces
O Bindings
elemento descreve uma coleção de associações para um site. É o elemento pai do Binding
elemento . O elemento é necessário para cada Site
elemento. Para obter mais informações sobre como configurar pontos de extremidade, consulte Habilitar comunicação para instâncias de função.
O Bindings
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
Enlace
O Binding
elemento especifica as informações de configuração necessárias para solicitações de comunicação com um site ou aplicativo Web.
O Binding
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
Atributo | Tipo | Description |
---|---|---|
nome | string | Obrigatório. Especifica um nome para identificar a associação. |
endpointName | string | Obrigatório. Especifica o nome do ponto de extremidade ao qual se ligar. |
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 de 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 pai do Variable
elemento . Para obter mais informações sobre como usar as tarefas de inicialização de função, consulte 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 Startup
elemento .
Atributo | Tipo | Description |
---|---|---|
prioridade | número inteiro | Apenas para uso interno. |
Task
O Task
elemento 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 para executar tais componentes de software de instalação ou executar outros aplicativos. As tarefas são executadas na ordem em que aparecem dentro do bloco de Startup
elementos.
O Task
elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.
A tabela a seguir descreve os atributos do Task
elemento .
Atributo | Tipo | Description |
---|---|---|
linha de comando | string | Obrigatório. Um script, como um arquivo CMD, contendo os comandos a serem executados. O comando de inicialização e os arquivos em lote devem ser salvos no formato ANSI. Formatos de arquivo que definem um marcador de ordem de bytes no início dos processos de arquivo incorretamente. |
executionContext | string | Especifica o contexto no qual o script é executado. - limited [Padrão] – Execute com os mesmos privilégios da função que hospeda o processo.- elevated – Executar com privilégios de administrador. |
Tipo de tarefa | string | Especifica o comportamento de execução do comando. - simple [Padrão] – O sistema aguarda a saída da tarefa antes que qualquer outra tarefa seja iniciada.- background – O sistema não espera que a tarefa saia.- foreground – Semelhante ao plano de fundo, exceto que a função não é reiniciada até que todas as tarefas em primeiro plano sejam encerradas. |
Conteúdos
O Contents
elemento descreve a coleção de conteúdo para uma função Web. Este elemento é o pai do Content
elemento .
O Contents
elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.
Conteúdo
O Content
elemento 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 Content
elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.
A tabela a seguir descreve os atributos do Content
elemento .
Atributo | Tipo | Description |
---|---|---|
destination | string | Obrigatório. Local na máquina virtual do Azure na qual o conteúdo é colocado. Esse local é relativo à pasta %ROLEROOT%\Approot. |
Este elemento é o elemento pai do SourceDirectory
elemento .
Diretório de fontes
O SourceDirectory
elemento define o diretório local do qual o conteúdo é copiado. Use este elemento para especificar o conteúdo local a ser copiado para a máquina virtual do Azure.
O SourceDirectory
elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.
A tabela a seguir descreve os atributos do SourceDirectory
elemento .
Atributo | Tipo | Description |
---|---|---|
path | string | Obrigatório. Caminho relativo ou absoluto de um diretório local cujo conteúdo é copiado para a máquina virtual do Azure. A expansão de variáveis de ambiente no caminho do diretório é suportada. |
Próximos passos
Esquema de definição do serviço de nuvem (suporte estendido).