Esquema WorkerRole de definição de serviços de nuvem do AzureAzure Cloud Services Definition WorkerRole Schema

A função de trabalho do Azure é uma função que é útil para desenvolvimento generalizado e pode executar o processamento em segundo plano para uma função Web.The Azure worker role is a role that is useful for generalized development, and may perform background processing for a web role.

A extensão padrão para o arquivo de definição de serviço é. csdef.The default extension for the service definition file is .csdef.

Esquema de definição de serviço básico para uma função de trabalho.Basic service definition schema for a worker role.

O formato básico do arquivo de definição de serviço que contém uma função de trabalho é o seguinte.The basic format of the service definition file containing a worker role is as follows.

<ServiceDefinition …>
  <WorkerRole name="<worker-role-name>" vmsize="<worker-role-size>" enableNativeCodeExecution="[true|false]">
    <Certificates>
      <Certificate name="<certificate-name>" storeLocation="[CurrentUser|LocalMachine]" storeName="[My|Root|CA|Trust|Disallow|TrustedPeople|TrustedPublisher|AuthRoot|AddressBook|<custom-store>" />
    </Certificates>
    <ConfigurationSettings>
      <Setting name="<setting-name>" />
    </ConfigurationSettings>
    <Endpoints>
      <InputEndpoint name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<local-port-number>" port="<port-number>" certificate="<certificate-name>" 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>
    <Imports>
      <Import moduleName="[RemoteAccess|RemoteForwarder|Diagnostics]"/>
    </Imports>
    <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>"/>
         <ProgramEntryPoint commandLine="<application>" setReadyOnProcessStart="[true|false]"/>
      </EntryPoint>
    </Runtime>
    <Startup priority="<for-internal-use-only>">
      <Task commandLine="" 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>
  </WorkerRole>
</ServiceDefinition>

Elementos de esquemaSchema Elements

O arquivo de definição de serviço inclui esses elementos, descritos em detalhes nas seções subsequentes neste tópico:The service definition file includes these elements, described in detail in subsequent sections in this topic:

WorkerRoleWorkerRole

ConfigurationSettingsConfigurationSettings

DefiniçãoSetting

LocalResourcesLocalResources

LocalStorageLocalStorage

ExtremidadeEndpoints

InputEndpointInputEndpoint

InternalEndpointInternalEndpoint

InstanceInputEndpointInstanceInputEndpoint

AllocatePublicPortFromAllocatePublicPortFrom

FixedPortFixedPort

FixedPortRangeFixedPortRange

CertificadosCertificates

CertificadoCertificate

ImportarImports

ImportarImport

AppmodelRuntime

AmbienteEnvironment

PontoEntryPoint

NetFxEntryPointNetFxEntryPoint

ProgramEntryPointProgramEntryPoint

ElaVariable

RoleInstanceValueRoleInstanceValue

InicializaçãoStartup

TarefaTask

ÍndiceContents

ConteúdoContent

SourceDirectorySourceDirectory

WorkerRoleWorkerRole

O elemento WorkerRole descreve uma função que é útil para desenvolvimento generalizado e pode executar o processamento em segundo plano para uma função Web.The WorkerRole element describes a role that is useful for generalized development, and may perform background processing for a web role. Um serviço pode conter zero ou mais funções de trabalho.A service may contain zero or more worker roles.

A tabela a seguir descreve os atributos do elemento WorkerRole.The following table describes the attributes of the WorkerRole element.

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. O nome da função de trabalho.The name for the worker role. O nome da função deve ser exclusivo.The role's name must be unique.
enableNativeCodeExecutionenableNativeCodeExecution booleanboolean Opcional.Optional. O valor padrão é true; a execução de código nativo e a confiança total são habilitadas por padrão.The default value is true; native code execution and full trust are enabled by default. Defina esse atributo como false para desabilitar a execução de código nativo para a função de trabalho e use a confiança parcial do Azure em vez disso.Set this attribute to false to disable native code execution for the worker role, and use Azure partial trust instead.
vmsizevmsize stringstring Opcional.Optional. Defina esse valor para alterar o tamanho da máquina virtual que é alocada para essa função.Set this value to change the size of the virtual machine that is allotted to this role. O valor padrão é Small.The default value is Small. Para obter uma lista de tamanhos de máquinas virtuais possíveis e seus atributos, consulte tamanhos de máquina virtual para serviços de nuvem.For a list of possible virtual machine sizes and their attributes, see Virtual Machine sizes for Cloud Services.

ConfigurationSettingsConfigurationSettings

O elemento ConfigurationSettings descreve a coleção de definições de configuração para uma função de trabalho.The ConfigurationSettings element describes the collection of configuration settings for a worker role. Esse elemento é o pai do elemento Setting.This element is the parent of the Setting element.

ConfiguraçãoSetting

O elemento Setting descreve um par de nome e valor que especifica um parâmetro de configuração para uma instância de uma função.The Setting element describes a name and value pair that specifies a configuration setting for an instance of a role.

A tabela a seguir descreve os atributos do elemento Setting.The following table describes the attributes of the Setting element.

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. Um nome exclusivo para a definição de configuração.A unique name for the configuration setting.

Os parâmetros 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.The configuration settings for a role are name and value pairs that are declared in the service definition file and set in the service configuration file.

LocalResourcesLocalResources

O elemento LocalResources descreve a coleção de recursos de armazenamento local para uma função de trabalho.The LocalResources element describes the collection of local storage resources for a worker role. Esse elemento é o pai do elemento LocalStorage.This element is the parent of the LocalStorage element.

LocalStorageLocalStorage

O elemento LocalStorage identifica um recurso de armazenamento local que fornece o espaço do sistema de arquivos para o serviço em tempo de execução.The LocalStorage element identifies a local storage resource that provides file system space for the service at runtime. Uma função pode definir zero ou mais recursos de armazenamento local.A role may define zero or more local storage resources.

Nota

O elemento LocalStorage pode aparecer como um filho do elemento WorkerRole para dar suporte à compatibilidade com versões anteriores do SDK do Azure.The LocalStorage element can appear as a child of the WorkerRole element to support compatibility with earlier versions of the Azure SDK.

A tabela a seguir descreve os atributos do elemento LocalStorage.The following table describes the attributes of the LocalStorage element.

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. Um nome exclusivo para o repositório local.A unique name for the local store.
cleanOnRoleRecyclecleanOnRoleRecycle booleanboolean Opcional.Optional. Indica se o repositório local deve ser limpo quando a função é reiniciada.Indicates whether the local store should be cleaned when the role is restarted. O valor padrão é true.Default value is true.
sizeInMbsizeInMb intint Opcional.Optional. A quantidade desejada de espaço de armazenamento a ser alocada para o repositório local, em MB.The desired amount of storage space to allocate for the local store, in MB. Se não for especificado, o espaço de armazenamento padrão alocado será de 100 MB.If not specified, the default storage space allocated is 100 MB. A quantidade mínima de espaço de armazenamento que pode ser alocada é 1 MB.The minimum amount of storage space that may be allocated is 1 MB.

O tamanho máximo dos recursos locais depende do tamanho da máquina virtual.The maximum size of the local resources is dependent on the virtual machine size. Para obter mais informações, consulte tamanhos de máquina virtual para serviços de nuvem.For more information, see Virtual Machine sizes for Cloud Services.

O nome do diretório alocado para o recurso de armazenamento local corresponde ao valor fornecido para o atributo Name.The name of the directory allocated to the local storage resource corresponds to the value provided for the name attribute.

ExtremidadeEndpoints

O elemento Endpoints descreve a coleção de pontos de extremidade de entrada (externo), interno e de entrada de instância para uma função.The Endpoints element describes the collection of input (external), internal, and instance input endpoints for a role. Esse elemento é o pai dos elementos InputEndpoint, InternalEndpointe InstanceInputEndpoint.This element is the parent of the InputEndpoint, InternalEndpoint, and InstanceInputEndpoint elements.

Os pontos de extremidade internos e de entrada são alocados separadamente.Input and Internal endpoints are allocated separately. Um serviço pode ter um total de 25 pontos de extremidade de entrada, internos e de entrada de instância que podem ser alocados entre as 25 funções permitidas em um serviço.A service can have a total of 25 input, internal, and instance input endpoints which can be allocated across the 25 roles allowed in a service. Por exemplo, se tiver 5 funções, você poderá alocar 5 pontos de extremidade de entrada por função ou pode alocar 25 pontos de extremidade de entrada para uma única função, ou você pode alocar 1 ponto final de entrada a cada 25 funções.For example, if have 5 roles you can allocate 5 input endpoints per role or you can allocate 25 input endpoints to a single role or you can allocate 1 input endpoint each to 25 roles.

Nota

Cada função implantada requer uma instância por função.Each role deployed requires one instance per role. O provisionamento padrão de uma assinatura é limitado a 20 núcleos e, portanto, é limitado a 20 instâncias de uma função.The default provisioning for a subscription is limited to 20 cores and thus is limited to 20 instances of a role. Se seu aplicativo exigir mais instâncias do que o fornecido pelo provisionamento padrão , consulte cobrança, gerenciamento de assinaturas e suporte a cota para obter mais informações sobre como aumentar sua cota.If your application requires more instances than is provided by the default provisioning see Billing, Subscription Management and Quota Support for more information on increasing your quota.

InputEndpointInputEndpoint

O elemento InputEndpoint descreve um ponto de extremidade externo para uma função de trabalho.The InputEndpoint element describes an external endpoint to a worker role.

Você pode definir vários pontos de extremidade que são uma combinação de pontos de extremidade HTTP, HTTPS, UDP e TCP.You can define multiple endpoints that are a combination of HTTP, HTTPS, UDP, and TCP endpoints. Você pode especificar qualquer número de porta que escolher para um ponto de extremidade de entrada, mas os números de porta especificados para cada função no serviço devem ser exclusivos.You can specify any port number you choose for an input endpoint, but the port numbers specified for each role in the service must be unique. Por exemplo, se você especificar que uma função usa a porta 80 para HTTP e a porta 443 para HTTPS, você pode especificar que uma segunda função usa a porta 8080 para HTTP e a porta 8043 para HTTPS.For example, if you specify that a role uses port 80 for HTTP and port 443 for HTTPS, you might then specify that a second role uses port 8080 for HTTP and port 8043 for HTTPS.

A tabela a seguir descreve os atributos do elemento InputEndpoint.The following table describes the attributes of the InputEndpoint element.

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. Um nome exclusivo para o ponto de extremidade externo.A unique name for the external endpoint.
Protocoloprotocol stringstring Necessário.Required. O protocolo de transporte para o ponto de extremidade externo.The transport protocol for the external endpoint. Para uma função de trabalho, os valores possíveis são HTTP, HTTPS, UDPou TCP.For a worker role, possible values are HTTP, HTTPS, UDP, or TCP.
portaport intint Necessário.Required. A porta para o ponto de extremidade externo.The port for the external endpoint. Você pode especificar qualquer número de porta que escolher, mas os números de porta especificados para cada função no serviço devem ser exclusivos.You can specify any port number you choose, but the port numbers specified for each role in the service must be unique.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1,7 ou superior).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).
certificadocertificate stringstring Necessário para um ponto de extremidade HTTPS.Required for an HTTPS endpoint. O nome de um certificado definido por um elemento Certificate.The name of a certificate defined by a Certificate element.
localPortlocalPort intint Opcional.Optional. Especifica uma porta usada para conexões internas no ponto de extremidade.Specifies a port used for internal connections on the endpoint. O atributo localPort mapeia a porta externa no ponto de extremidade para uma porta interna em uma função.The localPort attribute maps the external port on the endpoint to an internal port on a role. Isso é útil em cenários em que uma função deve se comunicar com um componente interno em uma porta diferente da que é exposta externamente.This is useful in scenarios where a role must communicate to an internal component on a port that different from the one that is exposed externally.

Se não for especificado, o valor de localPort será o mesmo que o atributo port.If not specified, the value of localPort is the same as the port attribute. Defina o valor de localPort como "*" para atribuir automaticamente uma porta não alocada que é detectável usando a API de tempo de execução.Set the value of localPort to “*” to automatically assign an unallocated port that is discoverable using the runtime API.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1,7 ou superior).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

O atributo localPort só está disponível usando o SDK do Azure versão 1,3 ou superior.The localPort attribute is only available using the Azure SDK version 1.3 or higher.
ignoreRoleInstanceStatusignoreRoleInstanceStatus booleanboolean Opcional.Optional. Quando o valor desse atributo é definido como true, o status de um serviço é ignorado e o ponto de extremidade não será removido pelo balanceador de carga.When the value of this attribute is set to true, the status of a service is ignored and the endpoint will not be removed by the load balancer. Definir esse valor como true útil para a depuração de instâncias ocupadas de um serviço.Setting this value to true useful for debugging busy instances of a service. O valor padrão é false.The default value is false. Observação: Um ponto de extremidade ainda pode receber tráfego mesmo quando a função não está em um estado pronto.Note: An endpoint can still receive traffic even when the role is not in a Ready state.
loadBalancerProbeloadBalancerProbe stringstring Opcional.Optional. O nome da investigação do balanceador de carga associada ao ponto de extremidade de entrada.The name of the load balancer probe associated with the input endpoint. Para obter mais informações, consulte LoadBalancerProbe Schema.For more information, see LoadBalancerProbe Schema.

InternalEndpointInternalEndpoint

O elemento InternalEndpoint descreve um ponto de extremidade interno para uma função de trabalho.The InternalEndpoint element describes an internal endpoint to a worker role. Um ponto de extremidade interno está disponível somente 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.An internal endpoint is available only to other role instances running within the service; it is not available to clients outside the service. Uma função de trabalho pode ter até cinco pontos de extremidade internos HTTP, UDP ou TCP.A worker role may have up to five HTTP, UDP, or TCP internal endpoints.

A tabela a seguir descreve os atributos do elemento InternalEndpoint.The following table describes the attributes of the InternalEndpoint element.

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. Um nome exclusivo para o ponto de extremidade interno.A unique name for the internal endpoint.
Protocoloprotocol stringstring Necessário.Required. O protocolo de transporte para o ponto de extremidade interno.The transport protocol for the internal endpoint. Os valores possíveis são HTTP, TCP, UDPou ANY.Possible values are HTTP, TCP, UDP, or ANY.

Um valor de ANY especifica que qualquer protocolo, qualquer porta é permitida.A value of ANY specifies that any protocol, any port is allowed.
portaport intint Opcional.Optional. A porta usada para conexões de balanceamento de carga interno no ponto de extremidade.The port used for internal load balanced connections on the endpoint. Um ponto de extremidade com balanceamento de carga usa duas portas.A Load balanced endpoint uses two ports. A porta usada para o endereço IP público e a porta usada no endereço IP privado.The port used for the public IP address, and the port used on the private IP address. Normalmente, elas são definidas para o mesmo, mas você pode optar por usar portas diferentes.Typically these are these are set to the same, but you can choose to use different ports.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1,7 ou superior).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

O atributo Port só está disponível usando o SDK do Azure versão 1,3 ou superior.The Port attribute is only available using the Azure SDK version 1.3 or higher.

InstanceInputEndpointInstanceInputEndpoint

O elemento InstanceInputEndpoint descreve um ponto de extremidade de entrada de instância para uma função de trabalho.The InstanceInputEndpoint element describes an instance input endpoint to a worker role. 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.An instance input endpoint is associated with a specific role instance by using port forwarding in the load balancer. Cada ponto de extremidade de entrada de instância é mapeado para uma porta específica de um intervalo de portas possíveis.Each instance input endpoint is mapped to a specific port from a range of possible ports. Esse elemento é o pai do elemento AllocatePublicPortFrom.This element is the parent of the AllocatePublicPortFrom element.

O elemento InstanceInputEndpoint só está disponível usando o SDK do Azure versão 1,7 ou superior.The InstanceInputEndpoint element is only available using the Azure SDK version 1.7 or higher.

A tabela a seguir descreve os atributos do elemento InstanceInputEndpoint.The following table describes the attributes of the InstanceInputEndpoint element.

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. Um nome exclusivo para o ponto de extremidade.A unique name for the endpoint.
localPortlocalPort intint Necessário.Required. Especifica a porta interna que todas as instâncias de função escutarão a fim de receber o tráfego de entrada encaminhado do balanceador de carga.Specifies the internal port that all role instances will listen to in order to receive incoming traffic forwarded from the load balancer. Os valores possíveis variam entre 1 e 65535, inclusive.Possible values range between 1 and 65535, inclusive.
Protocoloprotocol stringstring Necessário.Required. O protocolo de transporte para o ponto de extremidade interno.The transport protocol for the internal endpoint. Os valores possíveis são udp ou tcp.Possible values are udp or tcp. Use tcp para tráfego baseado em http/https.Use tcp for http/https based traffic.

AllocatePublicPortFromAllocatePublicPortFrom

O elemento AllocatePublicPortFrom descreve o intervalo de portas públicas que pode ser usado por clientes externos para acessar cada ponto de extremidade de entrada de instância.The AllocatePublicPortFrom element describes the public port range that can be used by external customers to access each instance input endpoint. 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.The public (VIP) port number is allocated from this range and assigned to each individual role instance endpoint during tenant deployment and update. Esse elemento é o pai do elemento FixedPortRange.This element is the parent of the FixedPortRange element.

O elemento AllocatePublicPortFrom só está disponível usando o SDK do Azure versão 1,7 ou superior.The AllocatePublicPortFrom element is only available using the Azure SDK version 1.7 or higher.

FixedPortFixedPort

O elemento FixedPort especifica a porta para o ponto de extremidade interno, que permite conexões com balanceamento de carga no ponto de extremidade.The FixedPort element specifies the port for the internal endpoint, which enables load balanced connections on the endpoint.

O elemento FixedPort só está disponível usando o SDK do Azure versão 1,3 ou superior.The FixedPort element is only available using the Azure SDK version 1.3 or higher.

A tabela a seguir descreve os atributos do elemento FixedPort.The following table describes the attributes of the FixedPort element.

AtributoAttribute TipoType DescriçãoDescription
portaport intint Necessário.Required. A porta para o ponto de extremidade interno.The port for the internal endpoint. Isso tem o mesmo efeito que definir o FixedPortRange mín. e máx. para a mesma porta.This has the same effect as setting the FixedPortRange min and max to the same port.

Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1,7 ou superior).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

FixedPortRangeFixedPortRange

O elemento FixedPortRange especifica o intervalo de portas que são atribuídas 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.The FixedPortRange element specifies the range of ports that are assigned to the internal endpoint or instance input endpoint, and sets the port used for load balanced connections on the endpoint.

Nota

O elemento FixedPortRange funciona de maneira diferente, dependendo do elemento no qual ele reside.The FixedPortRange element works differently depending on the element in which it resides. Quando o elemento FixedPortRange está no elemento InternalEndpoint, ele abre todas as portas no balanceador de carga dentro do intervalo dos atributos mínimo e máximo para todas as máquinas virtuais em que a função é executada.When the FixedPortRange element is in the InternalEndpoint element, it opens all ports on the load balancer within the range of the min and max attributes for all virtual machines on which the role runs. Quando o elemento FixedPortRange está no elemento InstanceInputEndpoint, ele abre apenas uma porta dentro do intervalo dos atributos mínimo e máximo em cada máquina virtual que executa a função.When the FixedPortRange element is in the InstanceInputEndpoint element, it opens only one port within the range of the min and max attributes on each virtual machine running the role.

O elemento FixedPortRange só está disponível usando o SDK do Azure versão 1,3 ou superior.The FixedPortRange element is only available using the Azure SDK version 1.3 or higher.

A tabela a seguir descreve os atributos do elemento FixedPortRange.The following table describes the attributes of the FixedPortRange element.

AtributoAttribute TipoType DescriçãoDescription
min.min intint Necessário.Required. A porta mínima no intervalo.The minimum port in the range. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1,7 ou superior).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).
maximizarmax stringstring Necessário.Required. A porta máxima no intervalo.The maximum port in the range. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1,7 ou superior).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

CertificadoCertificates

O elemento Certificates descreve a coleção de certificados para uma função de trabalho.The Certificates element describes the collection of certificates for a worker role. Esse elemento é o pai do elemento Certificate.This element is the parent of the Certificate element. Uma função pode ter qualquer número de certificados associados.A role may have any number of associated certificates. Para obter mais informações sobre como usar o elemento Certificates, consulte Modificar o arquivo de definição de serviço com um certificado.For more information on using the certificates element, see Modify the Service Definition file with a certificate.

CertificateCertificate

O elemento Certificate descreve um certificado associado a uma função de trabalho.The Certificate element describes a certificate that is associated with a worker role.

A tabela a seguir descreve os atributos do elemento Certificate.The following table describes the attributes of the Certificate element.

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. Um nome para esse certificado, que é usado para fazer referência a ele quando ele está associado a um elemento de InputEndpoint HTTPS.A name for this certificate, which is used to refer to it when it is associated with an HTTPS InputEndpoint element.
storeLocationstoreLocation stringstring Necessário.Required. O local do repositório de certificados em que esse certificado pode ser encontrado no computador local.The location of the certificate store where this certificate may be found on the local machine. Os valores possíveis são CurrentUser e LocalMachine.Possible values are CurrentUser and LocalMachine.
storeNamestoreName stringstring Necessário.Required. O nome do repositório de certificados em que esse certificado reside no computador local.The name of the certificate store where this certificate resides on the local machine. Os valores possíveis incluem os nomes de armazenamento internos My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBookou qualquer nome de repositório personalizado.Possible values include the built-in store names My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, or any custom store name. Se um nome de repositório personalizado for especificado, o repositório será criado automaticamente.If a custom store name is specified, the store is automatically created.
permissionLevelpermissionLevel stringstring Opcional.Optional. Especifica as permissões de acesso dadas aos processos de função.Specifies the access permissions given to the role processes. Se você quiser que apenas processos elevados possam acessar a chave privada, especifique elevated permissão.If you want only elevated processes to be able to access the private key, then specify elevated permission. limitedOrElevated permissão permite que todos os processos de função acessem a chave privada.limitedOrElevated permission allows all role processes to access the private key. Os valores possíveis são limitedOrElevated ou elevated.Possible values are limitedOrElevated or elevated. O valor padrão é limitedOrElevated.The default value is limitedOrElevated.

ImportarImports

O elemento Imports descreve uma coleção de módulos de importação para uma função de trabalho que adiciona componentes ao sistema operacional convidado.The Imports element describes a collection of import modules for a worker role that add components to the guest operating system. Esse elemento é o pai do elemento Import.This element is the parent of the Import element. Esse elemento é opcional e uma função pode ter apenas um bloco de tempo de execução.This element is optional and a role can have only one runtime block.

O elemento Imports só está disponível usando o SDK do Azure versão 1,3 ou superior.The Imports element is only available using the Azure SDK version 1.3 or higher.

ImporteImport

O elemento Import especifica um módulo a ser adicionado ao sistema operacional convidado.The Import element specifies a module to add to the guest operating system.

O elemento Import só está disponível usando o SDK do Azure versão 1,3 ou superior.The Import element is only available using the Azure SDK version 1.3 or higher.

A tabela a seguir descreve os atributos do elemento Import.The following table describes the attributes of the Import element.

AtributoAttribute TipoType DescriçãoDescription
moduleNamemoduleName stringstring Necessário.Required. O nome do módulo a ser importado.The name of the module to import. Os módulos de importação válidos são:Valid import modules are:

-RemoteAccess- RemoteAccess
-RemoteForwarder- RemoteForwarder
-Diagnóstico- Diagnostics

Os módulos RemoteAccess e RemoteForwarder permitem que você configure sua instância de função para conexões de área de trabalho remota.The RemoteAccess and RemoteForwarder modules allow you to configure your role instance for remote desktop connections. Para obter mais informações, consulte habilitar conexão de área de trabalho remota.For more information see Enable Remote Desktop Connection.

O módulo diagnóstico permite coletar dados de diagnóstico para uma instância de funçãoThe Diagnostics module allows you to collect diagnostic data for a role instance

AppmodelRuntime

O elemento Runtime descreve uma coleção de configurações de variável de ambiente para uma função de trabalho que controla o ambiente de tempo de execução do processo de host do Azure.The Runtime element describes a collection of environment variable settings for a worker role that control the runtime environment of the Azure host process. Esse elemento é o pai do elemento Environment.This element is the parent of the Environment element. Esse elemento é opcional e uma função pode ter apenas um bloco de tempo de execução.This element is optional and a role can have only one runtime block.

O elemento Runtime só está disponível usando o SDK do Azure versão 1,3 ou superior.The Runtime element is only available using the Azure SDK version 1.3 or higher.

A tabela a seguir descreve os atributos do elemento Runtime:The following table describes the attributes of the Runtime element:

AtributoAttribute TipoType DescriçãoDescription
executionContextexecutionContext stringstring Opcional.Optional. Especifica o contexto no qual o processo de função é iniciado.Specifies the context in which the Role Process is launched. O contexto padrão é limited.The default context is limited.

- limited – o processo é iniciado sem privilégios de administrador.- limited – The process is launched without Administrator privileges.
- elevated – o processo é iniciado com privilégios de administrador.- elevated – The process is launched with Administrator privileges.

AmbienteEnvironment

O elemento Environment descreve uma coleção de configurações de variável de ambiente para uma função de trabalho.The Environment element describes a collection of environment variable settings for a worker role. Esse elemento é o pai do elemento Variable.This element is the parent of the Variable element. Uma função pode ter qualquer número de variáveis de ambiente definidas.A role may have any number of environment variables set.

ElaVariable

O elemento Variable especifica uma variável de ambiente a ser definida na operação de convidado.The Variable element specifies an environment variable to set in the guest operating.

O elemento Variable só está disponível usando o SDK do Azure versão 1,3 ou superior.The Variable element is only available using the Azure SDK version 1.3 or higher.

A tabela a seguir descreve os atributos do elemento Variable:The following table describes the attributes of the Variable element:

AtributoAttribute TipoType DescriçãoDescription
nomename stringstring Necessário.Required. O nome da variável de ambiente a ser definida.The name of the environment variable to set.
valorvalue stringstring Opcional.Optional. O valor a ser definido para a variável de ambiente.The value to set for the environment variable. Você deve incluir um atributo Value ou um elemento RoleInstanceValue.You must include either a value attribute or a RoleInstanceValue element.

RoleInstanceValueRoleInstanceValue

O elemento RoleInstanceValue especifica o xPath do qual recuperar o valor da variável.The RoleInstanceValue element specifies the xPath from which to retrieve the value of the variable.

A tabela a seguir descreve os atributos do elemento RoleInstanceValue.The following table describes the attributes of the RoleInstanceValue element.

AtributoAttribute TipoType DescriçãoDescription
XPathxpath stringstring Opcional.Optional. Caminho do local das configurações de implantação da instância.Location path of deployment settings for the instance. Para obter mais informações, consulte variáveis de configuração com XPath.For more information, see Configuration variables with XPath.

Você deve incluir um atributo Value ou um elemento RoleInstanceValue.You must include either a value attribute or a RoleInstanceValue element.

PontoEntryPoint

O elemento EntryPoint especifica o ponto de entrada para uma função.The EntryPoint element specifies the entry point for a role. Esse elemento é o pai dos elementos de NetFxEntryPoint.This element is the parent of the NetFxEntryPoint elements. Esses elementos permitem que você especifique um aplicativo que não seja o WaWorkerHost. exe padrão para atuar como o ponto de entrada de função.These elements allow you to specify an application other than the default WaWorkerHost.exe to act as the role entry point.

O elemento EntryPoint só está disponível usando o SDK do Azure versão 1,5 ou superior.The EntryPoint element is only available using the Azure SDK version 1.5 or higher.

NetFxEntryPointNetFxEntryPoint

O elemento NetFxEntryPoint especifica o programa a ser executado para uma função.The NetFxEntryPoint element specifies the program to run for a role.

Nota

O elemento NetFxEntryPoint só está disponível usando o SDK do Azure versão 1,5 ou superior.The NetFxEntryPoint element is only available using the Azure SDK version 1.5 or higher.

A tabela a seguir descreve os atributos do elemento NetFxEntryPoint.The following table describes the attributes of the NetFxEntryPoint element.

AtributoAttribute TipoType DescriçãoDescription
AssemblyNameassemblyName stringstring Necessário.Required. O caminho e o nome do arquivo do assembly que contém o ponto de entrada.The path and file name of the assembly containing the entry point. O caminho é relativo à pasta \%ROLEROOT%\Approot (não especifique \%ROLEROOT%\Approot no commandLine, ele é presumido).The path is relative to the folder \%ROLEROOT%\Approot (do not specify \%ROLEROOT%\Approot in commandLine, it is assumed). % ROLEROOT% é uma variável de ambiente mantida pelo Azure e representa o local da pasta raiz para sua função.%ROLEROOT% is an environment variable maintained by Azure and it represents the root folder location for your role. A pasta \%ROLEROOT%\Approot representa a pasta do aplicativo para sua função.The \%ROLEROOT%\Approot folder represents the application folder for your role.
targetFrameworkVersiontargetFrameworkVersion stringstring Necessário.Required. A versão do .NET Framework na qual o assembly foi criado.The version of the .NET framework on which the assembly was built. Por exemplo, targetFrameworkVersion="v4.0".For example, targetFrameworkVersion="v4.0".

ProgramEntryPointProgramEntryPoint

O elemento ProgramEntryPoint especifica o programa a ser executado para uma função.The ProgramEntryPoint element specifies the program to run for a role. O elemento ProgramEntryPoint permite que você especifique um ponto de entrada do programa que não se baseia em um assembly .NET.The ProgramEntryPoint element allows you to specify a program entry point that is not based on a .NET assembly.

Nota

O elemento ProgramEntryPoint só está disponível usando o SDK do Azure versão 1,5 ou superior.The ProgramEntryPoint element is only available using the Azure SDK version 1.5 or higher.

A tabela a seguir descreve os atributos do elemento ProgramEntryPoint.The following table describes the attributes of the ProgramEntryPoint element.

AtributoAttribute TipoType DescriçãoDescription
commandLinecommandLine stringstring Necessário.Required. O caminho, o nome do arquivo e todos os argumentos de linha de comando do programa a ser executado.The path, file name, and any command line arguments of the program to execute. O caminho é relativo à pasta %ROLEROOT%\Approot (não especifique %ROLEROOT%\Approot em CommandLine, ele é presumido).The path is relative to the folder %ROLEROOT%\Approot (do not specify %ROLEROOT%\Approot in commandLine, it is assumed). % ROLEROOT% é uma variável de ambiente mantida pelo Azure e representa o local da pasta raiz para sua função.%ROLEROOT% is an environment variable maintained by Azure and it represents the root folder location for your role. A pasta %ROLEROOT%\Approot representa a pasta do aplicativo para sua função.The %ROLEROOT%\Approot folder represents the application folder for your role.

Se o programa terminar, a função será reciclada, de modo geral, defina o programa para continuar a ser executado, em vez de ser um programa que simplesmente inicia e executa uma tarefa finita.If the program ends, the role is recycled, so generally set the program to continue to run, instead of being a program that just starts up and runs a finite task.
setReadyOnProcessStartsetReadyOnProcessStart booleanboolean Necessário.Required. Especifica se a instância de função aguarda até que o programa de linha de comando o sinalize seja iniciado.Specifies whether the role instance waits for the command line program to signal it is started. Esse valor deve ser definido como true neste momento.This value must be set to true at this time. Definir o valor como false é reservado para uso futuro.Setting the value to false is reserved for future use.

InicializaçãoStartup

O elemento Startup descreve uma coleção de tarefas que são executadas quando a função é iniciada.The Startup element describes a collection of tasks that run when the role is started. Esse elemento pode ser o pai do elemento Variable.This element can be the parent of the Variable element. Para obter mais informações sobre como usar as tarefas de inicialização de função, consulte como configurar tarefas de inicialização.For more information about using the role startup tasks, see How to configure startup tasks. Esse elemento é opcional e uma função pode ter apenas um bloco de inicialização.This element is optional and a role can have only one startup block.

A tabela a seguir descreve o atributo do elemento Startup.The following table describes the attribute of the Startup element.

AtributoAttribute TipoType DescriçãoDescription
prioridadepriority intint Somente para uso interno.For internal use only.

AgendaTask

O elemento Task especifica a tarefa de inicialização que ocorre quando a função é iniciada.The Task element specifies startup task that takes place when the role starts. As tarefas de inicialização podem ser usadas para executar tarefas que preparam a função para executar esses componentes de software de instalação ou executar outros aplicativos.Startup tasks can be used to perform tasks that prepare the role to run such install software components or run other applications. As tarefas são executadas na ordem em que aparecem dentro do bloco do elemento Startup.Tasks execute in the order in which they appear within the Startup element block.

O elemento Task só está disponível usando o SDK do Azure versão 1,3 ou superior.The Task element is only available using the Azure SDK version 1.3 or higher.

A tabela a seguir descreve os atributos do elemento Task.The following table describes the attributes of the Task element.

AtributoAttribute TipoType DescriçãoDescription
commandLinecommandLine stringstring Necessário.Required. Um script, como um arquivo CMD, que contém os comandos a serem executados.A script, such as a CMD file, containing the commands to run. O comando de inicialização e os arquivos em lotes devem ser salvos no formato ANSI.Startup command and batch files must be saved in ANSI format. Os formatos de arquivo que definem um marcador de ordem de byte no início do arquivo não serão processados corretamente.File formats that set a byte-order marker at the start of the file will not process properly.
executionContextexecutionContext stringstring Especifica o contexto no qual o script é executado.Specifies the context in which the script is run.

- limited [padrão] – execute com os mesmos privilégios que a função que hospeda o processo.- limited [Default] – Run with the same privileges as the role hosting the process.
- elevated – execute com privilégios de administrador.- elevated – Run with administrator privileges.
taskTypetaskType stringstring Especifica o comportamento de execução do comando.Specifies the execution behavior of the command.

- simple [padrão] – o sistema aguarda a tarefa ser encerrada antes de qualquer outra tarefa ser iniciada.- simple [Default] – System waits for the task to exit before any other tasks are launched.
- background – o sistema não aguarda a tarefa ser encerrada.- background – System does not wait for the task to exit.
- foreground – semelhante ao plano de fundo, exceto que a função não é reiniciada até que todas as tarefas de primeiro plano sejam encerradas.- foreground – Similar to background, except role is not restarted until all foreground tasks exit.

ÍndiceContents

O elemento Contents descreve a coleção de conteúdo para uma função de trabalho.The Contents element describes the collection of content for a worker role. Esse elemento é o pai do elemento Content.This element is the parent of the Content element.

O elemento Contents só está disponível usando o SDK do Azure versão 1,5 ou superior.The Contents element is only available using the Azure SDK version 1.5 or higher.

DisputaContent

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 é copiado.The Content element defines the source location of content to be copied to the Azure virtual machine and the destination path to which it is copied.

O elemento Content só está disponível usando o SDK do Azure versão 1,5 ou superior.The Content element is only available using the Azure SDK version 1.5 or higher.

A tabela a seguir descreve os atributos do elemento Content.The following table describes the attributes of the Content element.

AtributoAttribute TipoType DescriçãoDescription
Destinodestination stringstring Necessário.Required. Local na máquina virtual do Azure na qual o conteúdo é colocado.Location on the Azure virtual machine to which the content is placed. Esse local é relativo à pasta %ROLEROOT%\Approot.This location is relative to the folder %ROLEROOT%\Approot.

Esse elemento é o elemento pai do elemento SourceDirectory.This element is the parent element of the SourceDirectory element.

SourceDirectorySourceDirectory

O elemento SourceDirectory define o diretório local do qual o conteúdo é copiado.The SourceDirectory element defines the local directory from which content is copied. Use este elemento para especificar o conteúdo local a ser copiado para a máquina virtual do Azure.Use this element to specify the local contents to copy to the Azure virtual machine.

O elemento SourceDirectory só está disponível usando o SDK do Azure versão 1,5 ou superior.The SourceDirectory element is only available using the Azure SDK version 1.5 or higher.

A tabela a seguir descreve os atributos do elemento SourceDirectory.The following table describes the attributes of the SourceDirectory element.

AtributoAttribute TipoType DescriçãoDescription
Multi-Pathpath stringstring Necessário.Required. Caminho relativo ou absoluto de um diretório local cujo conteúdo será copiado para a máquina virtual do Azure.Relative or absolute path of a local directory whose contents will be copied to the Azure virtual machine. Há suporte para a expansão de variáveis de ambiente no caminho de diretório.Expansion of environment variables in the directory path is supported.

Consulte tambémSee Also

Esquema de definição do serviço de nuvem (clássico)Cloud Service (classic) Definition Schema