Schéma WorkerRole de définition d’Azure Cloud ServicesAzure Cloud Services Definition WorkerRole Schema

Le rôle de travail Azure est un rôle utile pour le développement généralisé. Il peut également effectuer le traitement en arrière-plan pour un rôle Web.The Azure worker role is a role that is useful for generalized development, and may perform background processing for a web role.

L’extension par défaut du fichier de définition de service est .csdef.The default extension for the service definition file is .csdef.

Schéma de définition de service de base pour un rôle de travail.Basic service definition schema for a worker role.

Le format de base du fichier de définition de service contenant un rôle de travail est le suivant.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>

Éléments du schémaSchema Elements

Le fichier de définition de service inclut ces éléments, ils sont détaillés dans les sections suivantes de cette rubrique :The service definition file includes these elements, described in detail in subsequent sections in this topic:

WorkerRoleWorkerRole

ConfigurationSettingsConfigurationSettings

ParamètreSetting

LocalResourcesLocalResources

LocalStorageLocalStorage

Points de terminaisonEndpoints

InputEndpointInputEndpoint

InternalEndpointInternalEndpoint

InstanceInputEndpointInstanceInputEndpoint

AllocatePublicPortFromAllocatePublicPortFrom

FixedPortFixedPort

FixedPortRangeFixedPortRange

CertificatesCertificates

CertificateCertificate

ImportsImports

ImportationationImport

RuntimeRuntime

EnvironmentEnvironment

EntryPointEntryPoint

NetFxEntryPointNetFxEntryPoint

ProgramEntryPointProgramEntryPoint

VariableVariable

RoleInstanceValueRoleInstanceValue

StartupStartup

TâcheTask

ContentsContents

ContenuContent

SourceDirectorySourceDirectory

WorkerRoleWorkerRole

L’élément WorkerRole décrit un rôle utile pour le développement généralisé. Il peut également effectuer le traitement en arrière-plan pour un rôle Web.The WorkerRole element describes a role that is useful for generalized development, and may perform background processing for a web role. Un service peut contenir zéro ou plusieurs rôles de travail.A service may contain zero or more worker roles.

Le tableau suivant décrit les attributs d’un de l’élément WorkerRole.The following table describes the attributes of the WorkerRole element.

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom du rôle de travail.The name for the worker role. Ce nom doit être unique.The role's name must be unique.
enableNativeCodeExecutionenableNativeCodeExecution booleanboolean facultatif.Optional. La valeur par défaut est true ; les fonctions d’exécution du code natif et de confiance totale sont activées par défaut.The default value is true; native code execution and full trust are enabled by default. Définissez cet attribut sur false pour désactiver l’exécution du code natif pour le rôle de travail et utilisez à la place la fonction de confiance totale Azure.Set this attribute to false to disable native code execution for the worker role, and use Azure partial trust instead.
vmSizevmsize stringstring facultatif.Optional. Définissez cette valeur pour modifier la taille de la machine virtuelle allouée à ce rôle.Set this value to change the size of the virtual machine that is allotted to this role. La valeur par défaut est Small.The default value is Small. Pour obtenir la liste des tailles de machine virtuelle possibles et leurs attributs, consultez Tailles de machine virtuelle pour les services cloud.For a list of possible virtual machine sizes and their attributes, see Virtual Machine sizes for Cloud Services.

ConfigurationSettingsConfigurationSettings

L’élément ConfigurationSettings décrit la collection de paramètres de configuration pour un rôle de travail.The ConfigurationSettings element describes the collection of configuration settings for a worker role. Cet élément est le parent de l’élément Setting.This element is the parent of the Setting element.

SettingSetting

L’élément Setting décrit une paire nom-valeur qui spécifie un paramètre de configuration pour une instance d’un rôle.The Setting element describes a name and value pair that specifies a configuration setting for an instance of a role.

Le tableau suivant décrit les attributs d’un de l’élément Setting.The following table describes the attributes of the Setting element.

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom unique du paramètre de configuration.A unique name for the configuration setting.

Les paramètres de configuration d’un rôle sont des paires nom-valeur déclarées dans le fichier de définition de service et définies dans le fichier de configuration de service.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

L’élément LocalResources décrit la collection de ressources de stockage local pour un rôle de travail.The LocalResources element describes the collection of local storage resources for a worker role. Cet élément est le parent de l’élément LocalStorage.This element is the parent of the LocalStorage element.

LocalStorageLocalStorage

L’élément LocalStorage identifie une ressource de stockage local qui fournit l’espace de système de fichiers pour le service lors de l’exécution.The LocalStorage element identifies a local storage resource that provides file system space for the service at runtime. Un rôle peut définir zéro ou plusieurs ressources de stockage local.A role may define zero or more local storage resources.

Notes

L’élément LocalStorage peut apparaître en tant qu’enfant de l’élément WorkerRole pour prendre en charge la compatibilité avec les versions antérieures du kit SDK Azure.The LocalStorage element can appear as a child of the WorkerRole element to support compatibility with earlier versions of the Azure SDK.

Le tableau suivant décrit les attributs d’un de l’élément LocalStorage.The following table describes the attributes of the LocalStorage element.

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom unique du magasin local.A unique name for the local store.
cleanOnRoleRecyclecleanOnRoleRecycle booleanboolean facultatif.Optional. Indique si le magasin local doit être nettoyé lorsque le rôle est redémarré.Indicates whether the local store should be cleaned when the role is restarted. La valeur par défaut est true.Default value is true.
sizeInMbsizeInMb intint facultatif.Optional. Quantité souhaitée d’espace de stockage à allouer pour le magasin local, en Mo.The desired amount of storage space to allocate for the local store, in MB. S’il n’est pas spécifié, l’espace de stockage alloué par défaut est de 100 Mo.If not specified, the default storage space allocated is 100 MB. La quantité d’espace de stockage minimale pouvant être allouée est de 1 Mo.The minimum amount of storage space that may be allocated is 1 MB.

La taille maximale des ressources locales dépend de la taille de la machine virtuelle.The maximum size of the local resources is dependent on the virtual machine size. Pour plus d’informations, consultez Tailles de machine virtuelle pour les services cloud.For more information, see Virtual Machine sizes for Cloud Services.

Le nom du répertoire alloué à la ressource de stockage local correspond à la valeur fournie pour l’attribut name.The name of the directory allocated to the local storage resource corresponds to the value provided for the name attribute.

EndpointsEndpoints

L’élément Endpoints décrit la collection de points de terminaison d’entrée (externes), internes et d’entrée d’instance pour un rôle.The Endpoints element describes the collection of input (external), internal, and instance input endpoints for a role. Cet élément est le parent des éléments InputEndpoint, InternalEndpoint et InstanceInputEndpoint.This element is the parent of the InputEndpoint, InternalEndpoint, and InstanceInputEndpoint elements.

Les points de terminaison d’entrée et internes sont alloués séparément.Input and Internal endpoints are allocated separately. Un service peut cumuler un total de 25 points de terminaison d’entrée, d’entrée d’instance et internes qui peuvent être alloués aux 25 rôles autorisés dans un service.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. Par exemple, avec 5 rôles vous pouvez au choix allouer 5 points de terminaison d’entrée par rôle, 25 points de terminaison d’entrée à un même rôle ou 1 point de terminaison d’entrée à chacun des 25 rôles.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.

Notes

Chaque rôle déployé nécessite une instance par rôle.Each role deployed requires one instance per role. L’approvisionnement par défaut d’un abonnement est limité à 20 cœurs, et donc à 20 instances d’un rôle.The default provisioning for a subscription is limited to 20 cores and thus is limited to 20 instances of a role. Si votre application nécessite plus d’instances que ce qui est fourni par l’approvisionnement par défaut, consultez Support pour la facturation, la gestion des abonnements et les quotas pour obtenir plus d’informations sur l’augmentation de votre quota.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

L’élément InputEndpoint décrit un point de terminaison externe à un rôle de travail.The InputEndpoint element describes an external endpoint to a worker role.

Vous pouvez définir plusieurs points de terminaison combinant à la fois des points de terminaison HTTP, HTTPS, UDP et TCP.You can define multiple endpoints that are a combination of HTTP, HTTPS, UDP, and TCP endpoints. Vous pouvez spécifier le numéro de port souhaité pour un point de terminaison d’entrée, mais les numéros de port spécifiés pour chaque rôle dans le service doivent être uniques.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. Par exemple, si vous spécifiez qu’un rôle utilise le port 80 pour HTTP et le port 443 pour HTTPS, vous pouvez ensuite spécifier qu’un deuxième rôle utilise le port 8080 pour HTTP et le port 8043 pour 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.

Le tableau suivant décrit les attributs d’un de l’élément InputEndpoint.The following table describes the attributes of the InputEndpoint element.

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom unique du point de terminaison externe.A unique name for the external endpoint.
protocolprotocol stringstring Requis.Required. Protocole de transport du point de terminaison externe.The transport protocol for the external endpoint. Pour un rôle de travail, les valeurs possibles sont HTTP, HTTPS, UDP ou TCP.For a worker role, possible values are HTTP, HTTPS, UDP, or TCP.
portport intint Requis.Required. Port du point de terminaison externe.The port for the external endpoint. Vous pouvez spécifier le numéro de port de votre choix, mais les numéros de port précisés pour chaque rôle dans le service doivent être uniques.You can specify any port number you choose, but the port numbers specified for each role in the service must be unique.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).
certificatcertificate stringstring Obligatoire pour un point de terminaison HTTPS.Required for an HTTPS endpoint. Nom d’un certificat défini par un élément Certificate.The name of a certificate defined by a Certificate element.
localPortlocalPort intint facultatif.Optional. Spécifie le port utilisé pour les connexions internes sur le point de terminaison.Specifies a port used for internal connections on the endpoint. L’attribut localPort mappe le port externe sur le point de terminaison à un port interne sur un rôle.The localPort attribute maps the external port on the endpoint to an internal port on a role. Cela est utile dans les scénarios où un rôle doit communiquer avec un composant interne sur un port différent de celui qui est exposé en externe.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.

Si elle n’est pas spécifiée, la valeur de localPort est la même que celle de l’attribut port.If not specified, the value of localPort is the same as the port attribute. Définissez la valeur de localPort sur « * » pour attribuer automatiquement un port non alloué, détectable à l’aide de l’API d’exécution.Set the value of localPort to “*” to automatically assign an unallocated port that is discoverable using the runtime API.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

L’attribut localPort n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The localPort attribute is only available using the Azure SDK version 1.3 or higher.
ignoreRoleInstanceStatusignoreRoleInstanceStatus booleanboolean facultatif.Optional. Lorsque la valeur de cet attribut est définie sur true, l’état d’un service est ignoré et le point de terminaison n’est pas supprimé par l’équilibreur de charge.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. Définir cette valeur sur true est utile pour déboguer les instances occupées d’un service.Setting this value to true useful for debugging busy instances of a service. La valeur par défaut est false.The default value is false. Remarque : un point de terminaison peut toujours recevoir du trafic, même si le rôle n'est pas à l'état Prêt.Note: An endpoint can still receive traffic even when the role is not in a Ready state.
loadBalancerProbeloadBalancerProbe stringstring facultatif.Optional. Nom de la sonde de l’équilibreur de charge associée au point de terminaison d’entrée.The name of the load balancer probe associated with the input endpoint. Pour plus d’informations, consultez Schéma LoadBalancerProbe.For more information, see LoadBalancerProbe Schema.

InternalEndpointInternalEndpoint

L’élément InternalEndpoint décrit un point de terminaison interne à un rôle de travail.The InternalEndpoint element describes an internal endpoint to a worker role. Un point de terminaison interne est uniquement disponible pour les autres instances de rôle exécutées dans le service ; il n’est en revanche pas disponible pour les clients en dehors du service.An internal endpoint is available only to other role instances running within the service; it is not available to clients outside the service. Un rôle de travail peut avoir jusqu'à cinq points de terminaison internes HTTP, UDP ou TCP.A worker role may have up to five HTTP, UDP, or TCP internal endpoints.

Le tableau suivant décrit les attributs d’un de l’élément InternalEndpoint.The following table describes the attributes of the InternalEndpoint element.

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom unique du point de terminaison interne.A unique name for the internal endpoint.
protocolprotocol stringstring Requis.Required. Protocole de transport du point de terminaison interne.The transport protocol for the internal endpoint. Les valeurs possibles sont HTTP, TCP, UDP ou ANY.Possible values are HTTP, TCP, UDP, or ANY.

La valeur ANY spécifie que tous les protocoles et tous les ports sont autorisés.A value of ANY specifies that any protocol, any port is allowed.
portport intint facultatif.Optional. Port utilisé pour les connexions internes à charge équilibrée sur le point de terminaison.The port used for internal load balanced connections on the endpoint. Un point de terminaison à charge équilibrée utilise deux ports :A Load balanced endpoint uses two ports. le port utilisé pour l’adresse IP publique, et le port utilisé sur l’adresse IP privée.The port used for the public IP address, and the port used on the private IP address. Ces adresses sont généralement définies sur le même port, mais vous pouvez utiliser des ports différents.Typically these are these are set to the same, but you can choose to use different ports.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

L’attribut Port n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The Port attribute is only available using the Azure SDK version 1.3 or higher.

InstanceInputEndpointInstanceInputEndpoint

L’élément InstanceInputEndpoint décrit un point de terminaison d’entrée d’instance à un rôle de travail.The InstanceInputEndpoint element describes an instance input endpoint to a worker role. Un point de terminaison d’entrée d’instance est associé à une instance de rôle spécifique à l’aide d’un réacheminement de port dans l’équilibreur de charge.An instance input endpoint is associated with a specific role instance by using port forwarding in the load balancer. Chaque point de terminaison d’entrée d’instance est mappé à un port spécifique à partir d’une plage de ports possibles.Each instance input endpoint is mapped to a specific port from a range of possible ports. Cet élément est le parent de l’élément AllocatePublicPortFrom.This element is the parent of the AllocatePublicPortFrom element.

L’élément InstanceInputEndpoint n’est disponible que par le biais du kit SDK Azure version 1.7 ou supérieure.The InstanceInputEndpoint element is only available using the Azure SDK version 1.7 or higher.

Le tableau suivant décrit les attributs d’un de l’élément InstanceInputEndpoint.The following table describes the attributes of the InstanceInputEndpoint element.

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom unique du point de terminaison.A unique name for the endpoint.
localPortlocalPort intint Requis.Required. Spécifie le port interne que toutes les instances de rôle doivent écouter pour recevoir le trafic entrant transféré à partir de l’équilibreur de charge.Specifies the internal port that all role instances will listen to in order to receive incoming traffic forwarded from the load balancer. Les valeurs possibles sont comprises entre 1 et 65535 inclus.Possible values range between 1 and 65535, inclusive.
protocolprotocol stringstring Requis.Required. Protocole de transport du point de terminaison interne.The transport protocol for the internal endpoint. Les valeurs possibles sont udp ou tcp.Possible values are udp or tcp. Utilisez tcp pour le trafic http/https.Use tcp for http/https based traffic.

AllocatePublicPortFromAllocatePublicPortFrom

L’élément AllocatePublicPortFrom décrit la plage de ports publics qui peut être utilisée par les clients externes pour accéder à chaque point de terminaison d’entrée d’instance.The AllocatePublicPortFrom element describes the public port range that can be used by external customers to access each instance input endpoint. Le numéro de port public (adresse IP virtuelle) est alloué à partir de cette plage, et affecté à chaque point de terminaison d’instance de rôle individuel pendant le déploiement et la mise à jour du locataire.The public (VIP) port number is allocated from this range and assigned to each individual role instance endpoint during tenant deployment and update. Cet élément est le parent de l’élément FixedPortRange.This element is the parent of the FixedPortRange element.

L’élément AllocatePublicPortFrom n’est disponible que par le biais du kit SDK Azure version 1.7 ou supérieure.The AllocatePublicPortFrom element is only available using the Azure SDK version 1.7 or higher.

FixedPortFixedPort

L’élément FixedPort spécifie le port du point de terminaison interne, ce qui permet les connexions à charge équilibrée sur le point de terminaison.The FixedPort element specifies the port for the internal endpoint, which enables load balanced connections on the endpoint.

L’élément FixedPort n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The FixedPort element is only available using the Azure SDK version 1.3 or higher.

Le tableau suivant décrit les attributs d’un de l’élément FixedPort.The following table describes the attributes of the FixedPort element.

AttributAttribute TypeType DescriptionDescription
portport intint Requis.Required. Port du point de terminaison interne.The port for the internal endpoint. Cela a le même effet que de définir les attributs min et max de l’élément FixedPortRange sur le même port.This has the same effect as setting the FixedPortRange min and max to the same port.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

FixedPortRangeFixedPortRange

L’élément FixedPortRange spécifie la plage de ports affectés au point de terminaison interne ou au point de terminaison d’entrée d’instance, et définit le port utilisé pour les connexions à charge équilibrée sur le point de terminaison.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.

Notes

L’élément FixedPortRange fonctionne différemment selon l’élément dans lequel il se trouve.The FixedPortRange element works differently depending on the element in which it resides. Lorsque l’élément FixedPortRange se trouve dans l’élément InternalEndpoint, il ouvre tous les ports sur l’équilibreur de charge dans la plage des attributs min et max pour toutes les machines virtuelles sur lesquelles le rôle s’exécute.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. Lorsque l’élément FixedPortRange se trouve dans l’élément InstanceInputEndpoint, il ouvre seulement un port dans la plage des attributs min et max sur chaque machine virtuelle exécutant le rôle.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.

L’élément FixedPortRange n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The FixedPortRange element is only available using the Azure SDK version 1.3 or higher.

Le tableau suivant décrit les attributs d’un de l’élément FixedPortRange.The following table describes the attributes of the FixedPortRange element.

AttributAttribute TypeType DescriptionDescription
minmin intint Requis.Required. Port minimal dans la plage.The minimum port in the range. Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).
maxmax stringstring Requis.Required. Port maximal dans la plage.The maximum port in the range. Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).Possible values range between 1 and 65535, inclusive (Azure SDK version 1.7 or higher).

CertificatesCertificates

L’élément Certificates décrit la collection de certificats pour un rôle de travail.The Certificates element describes the collection of certificates for a worker role. Cet élément est le parent de l’élément Certificate.This element is the parent of the Certificate element. Un rôle peut avoir n’importe quel nombre de certificats associés.A role may have any number of associated certificates. Pour plus d’informations sur l’utilisation de l’élément certificates, consultez Modifier le fichier de définition de service avec un certificat.For more information on using the certificates element, see Modify the Service Definition file with a certificate.

CertificateCertificate

L’élément Certificate décrit un certificat associé à un rôle de travail.The Certificate element describes a certificate that is associated with a worker role.

Le tableau suivant décrit les attributs d’un de l’élément Certificate.The following table describes the attributes of the Certificate element.

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom de ce certificat, utilisé pour y faire référence quand il est associé à un élément 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 Requis.Required. Emplacement du magasin de certificats dans lequel se trouve ce certificat sur la machine locale.The location of the certificate store where this certificate may be found on the local machine. Les valeurs possibles sont CurrentUser et LocalMachine.Possible values are CurrentUser and LocalMachine.
storeNamestoreName stringstring Requis.Required. Nom du magasin de certificats dans lequel se trouve ce certificat sur la machine locale.The name of the certificate store where this certificate resides on the local machine. Les valeurs possibles comprennent les noms de magasin intégrés My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ou un nom de magasin personnalisé.Possible values include the built-in store names My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, or any custom store name. Si un nom de magasin personnalisé est indiqué, le magasin est automatiquement créé.If a custom store name is specified, the store is automatically created.
permissionLevelpermissionLevel stringstring facultatif.Optional. Spécifie les autorisations d’accès données aux processus de rôle.Specifies the access permissions given to the role processes. Si vous souhaitez que seuls les processus élevés puissent accéder à la clé privée, spécifiez l’autorisation elevated.If you want only elevated processes to be able to access the private key, then specify elevated permission. Une autorisation limitedOrElevated permet à tous les processus de rôle d’accéder à la clé privée.limitedOrElevated permission allows all role processes to access the private key. Les valeurs possibles sont limitedOrElevated ou elevated.Possible values are limitedOrElevated or elevated. La valeur par défaut est limitedOrElevated.The default value is limitedOrElevated.

ImportsImports

L’élément Imports décrit une collection de modules d’importation pour un rôle de travail qui ajoutent des composants au système d’exploitation invité.The Imports element describes a collection of import modules for a worker role that add components to the guest operating system. Cet élément est le parent de l’élément Import.This element is the parent of the Import element. Cet élément est facultatif, et un rôle ne peut avoir qu’un seul bloc runtime.This element is optional and a role can have only one runtime block.

L’élément Imports n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The Imports element is only available using the Azure SDK version 1.3 or higher.

ImportImport

L’élément Import spécifie un module à ajouter au système d’exploitation invité.The Import element specifies a module to add to the guest operating system.

L’élément Import n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The Import element is only available using the Azure SDK version 1.3 or higher.

Le tableau suivant décrit les attributs d’un de l’élément Import.The following table describes the attributes of the Import element.

AttributAttribute TypeType DescriptionDescription
moduleNamemoduleName stringstring Requis.Required. Nom du module à importer.The name of the module to import. Les modules d’importation valides sont les suivants :Valid import modules are:

- RemoteAccess- RemoteAccess
- RemoteForwarder- RemoteForwarder
- Diagnostics- Diagnostics

Les modules RemoteAccess et RemoteForwarder vous permettent de configurer votre instance de rôle pour les connexions Bureau à distance.The RemoteAccess and RemoteForwarder modules allow you to configure your role instance for remote desktop connections. Pour plus d’informations, consultez Activer une connexion Bureau à distance.For more information see Enable Remote Desktop Connection.

Le module Diagnostics vous permet de collecter des données de diagnostic pour une instance de rôle.The Diagnostics module allows you to collect diagnostic data for a role instance

RuntimeRuntime

L’élément Runtime décrit une collection de paramètres de variables d’environnement pour un rôle de travail qui contrôlent l’environnement d’exécution du processus hôte 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. Cet élément est le parent de l’élément Environment.This element is the parent of the Environment element. Cet élément est facultatif, et un rôle ne peut avoir qu’un seul bloc runtime.This element is optional and a role can have only one runtime block.

L’élément Runtime n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The Runtime element is only available using the Azure SDK version 1.3 or higher.

Le tableau suivant décrit les attributs de l’élément Runtime :The following table describes the attributes of the Runtime element:

AttributAttribute TypeType DescriptionDescription
executionContextexecutionContext stringstring facultatif.Optional. Spécifie le contexte dans lequel le processus de rôle est lancé.Specifies the context in which the Role Process is launched. Le contexte par défaut est limited.The default context is limited.

- limited – Le processus est lancé sans privilèges d’administrateur.- limited – The process is launched without Administrator privileges.
- elevated – Le processus est lancé avec des privilèges d’administrateur.- elevated – The process is launched with Administrator privileges.

EnvironmentEnvironment

L’élément Environment décrit une collection de paramètres de variables d'environnement pour un rôle de travail.The Environment element describes a collection of environment variable settings for a worker role. Cet élément est le parent de l’élément Variable.This element is the parent of the Variable element. Un rôle peut avoir n’importe quel nombre de variables d’environnement définies.A role may have any number of environment variables set.

VariableVariable

L’élément Variable spécifie une variable d’environnement à définir dans le système d’exploitation invité.The Variable element specifies an environment variable to set in the guest operating.

L’élément Variable n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The Variable element is only available using the Azure SDK version 1.3 or higher.

Le tableau suivant décrit les attributs de l’élément Variable :The following table describes the attributes of the Variable element:

AttributAttribute TypeType DescriptionDescription
Nomname stringstring Requis.Required. Nom de la variable d'environnement à définir.The name of the environment variable to set.
valuevalue stringstring facultatif.Optional. Valeur à définir pour la variable d’environnement.The value to set for the environment variable. Vous devez inclure un attribut value ou un élément RoleInstanceValue.You must include either a value attribute or a RoleInstanceValue element.

RoleInstanceValueRoleInstanceValue

L’élément RoleInstanceValue spécifie l’attribut xPath à partir duquel récupérer la valeur de la variable.The RoleInstanceValue element specifies the xPath from which to retrieve the value of the variable.

Le tableau suivant décrit les attributs d’un de l’élément RoleInstanceValue.The following table describes the attributes of the RoleInstanceValue element.

AttributAttribute TypeType DescriptionDescription
xpathxpath stringstring facultatif.Optional. Chemin de l’emplacement des paramètres de déploiement pour l’instance.Location path of deployment settings for the instance. Pour plus d’informations, consultez Variables de configuration avec XPath.For more information, see Configuration variables with XPath.

Vous devez inclure un attribut value ou un élément RoleInstanceValue.You must include either a value attribute or a RoleInstanceValue element.

EntryPointEntryPoint

L’élément EntryPoint spécifie le point d’entrée d’un rôle.The EntryPoint element specifies the entry point for a role. Cet élément est le parent des éléments NetFxEntryPoint.This element is the parent of the NetFxEntryPoint elements. Ces éléments vous permettent de spécifier une autre application que l’application par défaut WaWorkerHost.exe pour agir comme point d’entrée du rôle.These elements allow you to specify an application other than the default WaWorkerHost.exe to act as the role entry point.

L’élément EntryPoint n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.The EntryPoint element is only available using the Azure SDK version 1.5 or higher.

NetFxEntryPointNetFxEntryPoint

L’élément NetFxEntryPoint spécifie le programme à exécuter pour un rôle.The NetFxEntryPoint element specifies the program to run for a role.

Notes

L’élément NetFxEntryPoint n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.The NetFxEntryPoint element is only available using the Azure SDK version 1.5 or higher.

Le tableau suivant décrit les attributs d’un de l’élément NetFxEntryPoint.The following table describes the attributes of the NetFxEntryPoint element.

AttributAttribute TypeType DescriptionDescription
assemblyNameassemblyName stringstring Requis.Required. Chemin et nom de fichier de l’assembly contenant le point d’entrée.The path and file name of the assembly containing the entry point. Le chemin est relatif au dossier \%ROLEROOT%\Approot (ne spécifiez pas \%ROLEROOT%\Approot dans commandLine, car il est supposé).The path is relative to the folder \%ROLEROOT%\Approot (do not specify \%ROLEROOT%\Approot in commandLine, it is assumed). %ROLEROOT% est une variable d’environnement gérée par Azure, qui représente l’emplacement du dossier racine de votre rôle.%ROLEROOT% is an environment variable maintained by Azure and it represents the root folder location for your role. Le dossier \%ROLEROOT%\Approot désigne le dossier d’application de votre rôle.The \%ROLEROOT%\Approot folder represents the application folder for your role.
targetFrameworkVersiontargetFrameworkVersion stringstring Requis.Required. La version de .NET framework sur laquelle l’assembly a été créé.The version of the .NET framework on which the assembly was built. Par exemple : targetFrameworkVersion="v4.0".For example, targetFrameworkVersion="v4.0".

ProgramEntryPointProgramEntryPoint

L’élément ProgramEntryPoint spécifie le programme à exécuter pour un rôle.The ProgramEntryPoint element specifies the program to run for a role. L’élément ProgramEntryPoint permet de spécifier un point d’entrée de programme non basé sur un assembly .NET.The ProgramEntryPoint element allows you to specify a program entry point that is not based on a .NET assembly.

Notes

L’élément ProgramEntryPoint n’est disponible que par le biais du Kit SDK Azure version 1.5 ou supérieure.The ProgramEntryPoint element is only available using the Azure SDK version 1.5 or higher.

Le tableau suivant décrit les attributs d’un de l’élément ProgramEntryPoint.The following table describes the attributes of the ProgramEntryPoint element.

AttributAttribute TypeType DescriptionDescription
commandLinecommandLine stringstring Requis.Required. Chemin d’accès, nom de fichier et arguments de ligne de commande du programme à exécuter.The path, file name, and any command line arguments of the program to execute. Le chemin d’accès est lié au dossier %ROLEROOT%\Approot (ne spécifiez pas %ROLEROOT%\Approot dans la ligne de commande, car cela est implicite).The path is relative to the folder %ROLEROOT%\Approot (do not specify %ROLEROOT%\Approot in commandLine, it is assumed). %ROLEROOT% est une variable d’environnement gérée par Azure, qui représente l’emplacement du dossier racine de votre rôle.%ROLEROOT% is an environment variable maintained by Azure and it represents the root folder location for your role. Le dossier %ROLEROOT%\Approot désigne le dossier d’application de votre rôle.The %ROLEROOT%\Approot folder represents the application folder for your role.

Si le programme se termine, le rôle est recyclé. Par conséquent, en règle générale, définissez le programme pour qu’il continue à s’exécuter au lieu qu’il démarre et exécute simplement une tâche déterminée.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 Requis.Required. Spécifie si l’instance de rôle doit attendre que le programme de ligne de commande signale son démarrage.Specifies whether the role instance waits for the command line program to signal it is started. Cette valeur doit être définie sur true à ce stade.This value must be set to true at this time. La valeur false est réservée à un usage ultérieur.Setting the value to false is reserved for future use.

StartupStartup

L’élément Startup décrit une collection de tâches qui s’exécutent au démarrage du rôle.The Startup element describes a collection of tasks that run when the role is started. Cet élément peut être le parent de l’élément Variable.This element can be the parent of the Variable element. Pour plus d’informations sur l’utilisation des tâches de démarrage de rôle, consultez Guide pratique pour configurer des tâches de démarrage.For more information about using the role startup tasks, see How to configure startup tasks. Cet élément est facultatif et un rôle peut n’avoir qu’un seul bloc startup.This element is optional and a role can have only one startup block.

Le tableau suivant décrit l’attribut de l’élément Startup.The following table describes the attribute of the Startup element.

AttributAttribute TypeType DescriptionDescription
prioritypriority intint À usage interne uniquement.For internal use only.

TaskTask

L’élément Task spécifie la tâche de démarrage qui s’exécute au démarrage du rôle.The Task element specifies startup task that takes place when the role starts. Les tâches de démarrage peuvent être utilisées pour réaliser des tâches en préparation de l’exécution du rôle, telles que l’installation de composants logiciels ou l’exécution d’autres applications.Startup tasks can be used to perform tasks that prepare the role to run such install software components or run other applications. Les tâches s’exécutent dans l’ordre selon lequel elles apparaissent dans le bloc de l’élément Startup.Tasks execute in the order in which they appear within the Startup element block.

L’élément Task n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.The Task element is only available using the Azure SDK version 1.3 or higher.

Le tableau suivant décrit les attributs d’un de l’élément Task.The following table describes the attributes of the Task element.

AttributAttribute TypeType DescriptionDescription
commandLinecommandLine stringstring Requis.Required. Script, comme un fichier CMD, contenant les commandes à exécuter.A script, such as a CMD file, containing the commands to run. La commande de démarrage et les fichiers de commandes doivent être enregistrés au format ANSI.Startup command and batch files must be saved in ANSI format. Les formats de fichier qui définissent un indicateur d’ordre des octets au début du fichier ne sont pas traités correctement.File formats that set a byte-order marker at the start of the file will not process properly.
executionContextexecutionContext stringstring Spécifie le contexte dans lequel le script est exécuté.Specifies the context in which the script is run.

- limited [Par défaut] – Exécution avec les mêmes privilèges que le rôle qui héberge le processus.- limited [Default] – Run with the same privileges as the role hosting the process.
- elevated – Exécution avec des privilèges d’administrateur.- elevated – Run with administrator privileges.
taskTypetaskType stringstring Spécifie le comportement d’exécution de la commande.Specifies the execution behavior of the command.

- simple [Par défaut] – Le système attend que la tâche se termine avant de lancer d’autres tâches.- simple [Default] – System waits for the task to exit before any other tasks are launched.
- background – Le système n’attend pas que la tâche se termine.- background – System does not wait for the task to exit.
- foreground – Similaire à background, à la différence près que le rôle n’est redémarré que quand toutes les tâches foreground sont terminées.- foreground – Similar to background, except role is not restarted until all foreground tasks exit.

ContentsContents

L’élément Contents décrit la collection du contenu d’un rôle de travail.The Contents element describes the collection of content for a worker role. Cet élément est le parent de l’élément Content.This element is the parent of the Content element.

L’élément Contents n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.The Contents element is only available using the Azure SDK version 1.5 or higher.

ContentContent

L’élément Content définit l’emplacement source du contenu à copier sur la machine virtuelle Azure, et le chemin de destination dans lequel il est copié.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.

L’élément Content n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.The Content element is only available using the Azure SDK version 1.5 or higher.

Le tableau suivant décrit les attributs d’un de l’élément Content.The following table describes the attributes of the Content element.

AttributAttribute TypeType DescriptionDescription
destinationdestination stringstring Requis.Required. Emplacement sur la machine virtuelle Azure dans lequel le contenu est placé.Location on the Azure virtual machine to which the content is placed. Cet emplacement est relatif au dossier %ROLEROOT%\Approot.This location is relative to the folder %ROLEROOT%\Approot.

Cet élément est le parent de l’élément SourceDirectory.This element is the parent element of the SourceDirectory element.

SourceDirectorySourceDirectory

L’élément SourceDirectory définit le répertoire local à partir duquel le contenu est copié.The SourceDirectory element defines the local directory from which content is copied. Utilisez cet élément pour spécifier le contenu local à copier sur la machine virtuelle Azure.Use this element to specify the local contents to copy to the Azure virtual machine.

L’élément SourceDirectory n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.The SourceDirectory element is only available using the Azure SDK version 1.5 or higher.

Le tableau suivant décrit les attributs d’un de l’élément SourceDirectory.The following table describes the attributes of the SourceDirectory element.

AttributAttribute TypeType DescriptionDescription
pathpath stringstring Requis.Required. Chemin relatif ou absolu d’un répertoire local dont le contenu doit être copié sur la machine virtuelle Azure.Relative or absolute path of a local directory whose contents will be copied to the Azure virtual machine. L’extension des variables d’environnement dans le chemin du répertoire est prise en charge.Expansion of environment variables in the directory path is supported.

Voir aussiSee Also

Schéma de définition de services cloud (classique)Cloud Service (classic) Definition Schema