Esquema de rol web de definición de Azure Cloud Services (soporte extendido)

Artículo
07/24/2024

El rol web de Azure es un rol que se personaliza para la programación de aplicaciones web compatibles con IIS 7, como ASP.NET, PHP, Windows Communication Foundation y FastCGI.

La extensión predeterminada del archivo de definición de servicio es .csdef.

Esquema básico de definición de servicio para un rol web

El formato básico de un archivo de definición de servicio que contiene un rol web es el siguiente.

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe="<load-balancer-probe-name>" />  
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">  
         <FixedPort port="<port-number>"/>  
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
      </InternalEndpoint>  
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">  
         <AllocatePublicPortFrom>  
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
         </AllocatePublicPortFrom>  
      </InstanceInputEndpoint>  
    </Endpoints>  
    <LocalResources>  
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    </LocalResources>  
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    <Runtime executionContext="[limited|elevated]">  
      <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
      </Environment>  
      <EntryPoint>  
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">  
        <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
        </Environment>  
      </Task>  
    </Startup>  
    <Contents>  
      <Content destination="<destination-folder-name>" >  
        <SourceDirectory path="<local-source-directory>" />  
      </Content>  
    </Contents>  
  </WebRole>  
</ServiceDefinition>

Elementos de esquema

El archivo de definición de servicio incluye estos elementos, que se describen más detalladamente en las secciones siguientes de este artículo:

WebRole

ConfigurationSettings

InstanceInputEndpoint

AllocatePublicPortFrom

WebRole

El elemento WebRole describe un rol que se personaliza para la programación de aplicaciones web compatibles con IIS 7 y ASP.NET. Un servicio puede contener cero o más roles web.

En la tabla siguiente se describen los atributos del elemento WebRole:

Atributo	Tipo	Descripción
name	string	Necesario. Nombre del rol web. El nombre del rol debe ser único.
enableNativeCodeExecution	boolean	Opcional. El valor predeterminado es `true`; de forma predeterminada están habilitadas la ejecución de código nativo y la plena confianza. Establezca este atributo en `false` para deshabilitar la ejecución de código nativo para el rol web y usar en su lugar la confianza parcial de Azure.
vmsize	string	Opcional. Establezca este valor para cambiar el tamaño de la máquina virtual que se asigna al rol. El valor predeterminado es `Small`. Para más información, consulte los tamaños de máquina virtual para Cloud Services.

ConfigurationSettings

El elemento ConfigurationSettings describe la colección de valores de configuración de un rol web. Este elemento es el elemento primario del elemento Setting.

Configuración

El elemento Setting describe un par de nombre y valor que especifica un valor de configuración para una instancia de un rol.

En la tabla siguiente se describen los atributos del elemento Setting:

Atributo	Tipo	Descripción
name	string	Necesario. Un nombre único para el valor de configuración.

Los valores de configuración de un rol son pares de nombre y valor que se declaran en el archivo de definición de servicio y se establecen en el archivo de configuración de servicio.

LocalResources

El elemento LocalResources describe la colección de recursos de almacenamiento local de un rol web. Este elemento es el elemento primario del elemento LocalStorage.

LocalStorage

El elemento LocalStorage identifica un recurso de almacenamiento local que proporciona espacio del sistema de archivos para el servicio en tiempo de ejecución. Un rol puede definir cero o más recursos de almacenamiento local.

Nota

El elemento LocalStorage puede aparecer como un elemento secundario del elemento WebRole para permitir la compatibilidad con versiones anteriores de Azure SDK.

En la tabla siguiente se describen los atributos del elemento LocalStorage:

Atributo	Tipo	Descripción
name	string	Necesario. Un nombre único para el almacén local.
cleanOnRoleRecycle	boolean	Opcional. Indica si se debe limpiar el almacén local cuando se reinicia el rol. El valor predeterminado es `true`.
sizeInMb	int	Opcional. La cantidad deseada de espacio de almacenamiento para asignar al almacén local, en MB. Si no se especifica, el espacio de almacenamiento predeterminado asignado es 100 MB. La cantidad mínima de espacio de almacenamiento que puede asignarse es 1 MB. El tamaño máximo de los recursos locales depende del tamaño de máquina virtual. Para más información, consulte los tamaños de máquina virtual para Cloud Services.

El nombre del directorio asignado al recurso de almacenamiento local corresponde al valor proporcionado para el atributo de nombre.

Puntos de conexión

El elemento Endpoints describe la colección de puntos de conexión de entrada (externos), internos y de entrada de instancia de un rol. Este elemento es el elemento primario de los elementos InputEndpoint, InternalEndpoint y InstanceInputEndpoint.

Los puntos de conexión de entrada e internos se asignan por separado. Un servicio puede tener un total de 25 puntos de conexión de entrada, internos y de entrada de instancia que se pueden asignar entre los 25 roles permitidos en un servicio. Por ejemplo, si tiene cinco roles, puede asignar cinco puntos de conexión de entrada por rol, puede asignar 25 puntos de conexión de entrada a un solo rol o puede asignar un punto de conexión de entrada a cada uno de los 25 roles.

Nota:

Cada rol implementado requiere una instancia por rol. El aprovisionamiento predeterminado de una suscripción está limitado a veinte núcleos y, por tanto, a veinte instancias de un rol. Si la aplicación requiere más instancias que las que se proporcionan con el aprovisionamiento predeterminado, vea las secciones sobre facturación, administración de suscripciones y compatibilidad con cuotas para más información sobre cómo aumentar la cuota.

InputEndpoint

El elemento InputEndpoint describe un punto de conexión externo a un rol web.

Puede definir varios puntos de conexión que sean una combinación de puntos de conexión HTTP, HTTPS, UDP y TCP. Puede especificar cualquier número de puerto que elija para un punto de conexión de entrada, pero los números de puerto especificados para cada rol del servicio deben ser únicos. Por ejemplo, si especifica que un rol web use el puerto 80 para HTTP y el puerto 443 para HTTPS, podría especificar entonces que un segundo rol web use el puerto 8080 para HTTP y el puerto 8043 para HTTPS.

En la tabla siguiente se describen los atributos del elemento InputEndpoint:

Atributo	Tipo	Descripción
name	string	Necesario. Un nombre único para el punto de conexión externo.
protocol	string	Necesario. El protocolo de transporte del punto de conexión externo. Los valores posibles para un rol web son `HTTP`, `HTTPS`, `UDP` o `TCP`.
port	int	Necesario. El puerto del punto de conexión externo. Puede especificar cualquier número de puerto que elija, pero los números de puerto especificados para cada rol del servicio deben ser únicos. Los valores posibles oscilan entre 1 y 65535, ambos inclusive (versión 1.7 o posterior de Azure SDK).
certificado	string	Obligatorio para un punto de conexión HTTPS. El nombre de un certificado definido por un elemento `Certificate`.
localPort	int	Opcional. Especifica un puerto usado para las conexiones internas del punto de conexión. El atributo `localPort` asigna el puerto externo del punto de conexión a un puerto interno de un rol. Este atributo resulta de utilidad en escenarios donde un rol debe comunicarse con un componente interno en un puerto diferente del que se expone externamente. Si no se especifica, el valor de `localPort` es el mismo que el del atributo `port`. Establezca el valor de `localPort` en "*" para asignar automáticamente un puerto sin asignar que se puede detectar mediante la API en tiempo de ejecución. Los valores posibles oscilan entre 1 y 65535, ambos inclusive (versión 1.7 o posterior de Azure SDK). El atributo `localPort` solo está disponible mediante la versión 1.3 o posterior de Azure SDK.
ignoreRoleInstanceStatus	boolean	Opcional. Cuando el valor de este atributo se establece en `true`, se omite el estado de un servicio y el equilibrador de carga no quitará el punto de conexión. El establecimiento de este valor en `true` resulta de utilidad para depurar instancias ocupadas de un servicio. El valor predeterminado es `false`. Nota: Un punto de conexión puede seguir recibiendo tráfico aunque el rol no esté en un estado listo.
loadBalancerProbe	string	Opcional. El nombre del sondeo del equilibrador de carga asociado con el punto de conexión de entrada. Para más información, vea Esquema LoadBalancerProbe.

InternalEndpoint

El elemento InternalEndpoint describe un punto de conexión interno a un rol web. Un punto de conexión solo está disponible para otras instancias de rol que se ejecutan dentro del servicio; no está disponible para los clientes de fuera del servicio. Los roles web que no incluyen el elemento Sites solo pueden tener un único punto de conexión interno HTTP, UDP o TCP.

En la tabla siguiente se describen los atributos del elemento InternalEndpoint:

Atributo	Tipo	Descripción
name	string	Necesario. Un nombre único para el punto de conexión interno.
protocol	string	Necesario. El protocolo de transporte del punto de conexión interno. Los valores posibles son `HTTP`, `TCP`, `UDP` o `ANY`. Un valor de `ANY` especifica que se permite cualquier protocolo y cualquier puerto.
port	int	Opcional. El puerto usado para las conexiones de carga equilibrada internas del punto de conexión. Un punto de conexión de carga equilibrada usa dos puertos. uno para la dirección IP pública y el otro en la dirección IP privada. Normalmente, estos valores se establecen en el mismo valor, pero puede elegir usar puertos diferentes. Los valores posibles oscilan entre 1 y 65535, ambos inclusive (versión 1.7 o posterior de Azure SDK). El atributo `Port` solo está disponible mediante la versión 1.3 o posterior de Azure SDK.

InstanceInputEndpoint

El elemento InstanceInputEndpoint describe un punto de conexión de entrada de instancia a un rol web. Un punto de conexión de entrada de instancia está asociado a una instancia de rol específica mediante el reenvío de puerto del equilibrador de carga. Cada punto de conexión de entrada de instancia se asigna a un puerto específico de un intervalo de puertos posibles. Este elemento es el elemento primario del elemento AllocatePublicPortFrom.

El elemento InstanceInputEndpoint solo está disponible cuando se usa la versión 1.7 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento InstanceInputEndpoint:

Atributo	Tipo	Descripción
name	string	Necesario. Un nombre único para el punto de conexión.
localPort	int	Necesario. Especifica el puerto interno que todas las instancias de rol escuchan para recibir el tráfico de entrada reenviado desde el equilibrador de carga. El intervalo de valores posibles oscila entre 1 y 65535, ambos inclusive.
protocol	string	Necesario. El protocolo de transporte del punto de conexión interno. Los valores posibles son `udp` o `tcp`. Use `tcp` para el tráfico basado en http/https.

AllocatePublicPortFrom

El elemento AllocatePublicPortFrom describe el intervalo de puertos públicos que pueden usar los clientes externos para acceder a cada punto de conexión de entrada de instancia. El número de puerto público (VIP) se asigna de este intervalo y a cada punto de conexión de instancia de rol individual durante la implementación y la actualización de inquilinos. Este elemento es el elemento primario del elemento FixedPortRange.

El elemento AllocatePublicPortFrom solo está disponible cuando se usa la versión 1.7 o posterior de Azure SDK.

FixedPort

El elemento FixedPort especifica el puerto del punto de conexión interno, que permite conexiones de carga equilibrada en el punto de conexión.

El elemento FixedPort solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento FixedPort:

Atributo	Tipo	Descripción
port	int	Necesario. El puerto del punto de conexión interno. Este atributo tiene el mismo efecto que establecer el valor mínimo y máximo de `FixedPortRange` en el mismo puerto. Los valores posibles oscilan entre 1 y 65535, ambos inclusive (versión 1.7 o posterior de Azure SDK).

FixedPortRange

El elemento FixedPortRange especifica el intervalo de puertos que se asignan al punto de conexión interno o al punto de conexión de entrada de instancia, y establece el puerto usado en las conexiones de carga equilibrada en el punto de conexión.

Nota

El elemento FixedPortRange funciona de manera diferente según el elemento en el que reside. Cuando el elemento FixedPortRange está en el elemento InternalEndpoint, se abren todos los puertos del equilibrador de carga que se encuentran en el intervalo de los atributos min y max en todas las máquinas virtuales en las que se ejecuta el rol. Cuando el elemento FixedPortRange está en el elemento InstanceInputEndpoint, solo se abre un puerto del intervalo de los atributos min y max en cada máquina virtual donde se ejecuta el rol.

El elemento FixedPortRange solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento FixedPortRange:

Atributo	Tipo	Descripción
Min	int	Necesario. El puerto mínimo del intervalo. Los valores posibles oscilan entre 1 y 65535, ambos inclusive (versión 1.7 o posterior de Azure SDK).
máx.	string	Necesario. El puerto máximo del intervalo. Los valores posibles oscilan entre 1 y 65535, ambos inclusive (versión 1.7 o posterior de Azure SDK).

Certificados

El elemento Certificates describe la colección de certificados de un rol web. Este elemento es el elemento primario del elemento Certificate. Un rol puede tener cualquier número de certificados asociados. Para más información sobre cómo usar el elemento de certificados, vea cómo modificar el archivo de definición de servicio con un certificado.

Certificado

El elemento Certificate describe un certificado que está asociado a un rol web.

En la tabla siguiente se describen los atributos del elemento Certificate:

Atributo	Tipo	Descripción
name	string	Necesario. Un nombre para este certificado, que se usa para referirse a él cuando está asociado con un elemento `InputEndpoint` de HTTPS.
storeLocation	string	Necesario. La ubicación del almacén de certificados donde se puede encontrar este certificado en la máquina local. Los valores posibles son `CurrentUser` y `LocalMachine`.
storeName	string	Necesario. El nombre del almacén de certificados donde reside este certificado en la máquina local. Los valores posibles incluyen nombres de almacén integrados `My`, `Root`, `CA`, `Trust`, `Disallowed`, `TrustedPeople`, `TrustedPublisher`, `AuthRoot`, `AddressBook`, o cualquier otro nombre de almacén personalizado. Si se especifica un nombre de almacén personalizado, se crea automáticamente el almacén.
permissionLevel	string	Opcional. Especifica los permisos de acceso proporcionados a los procesos de rol. Si quiere que los procesos elevados puedan acceder a la clave privada, especifique entonces el permiso `elevated`. El permiso `limitedOrElevated` permite que todos los procesos del rol accedan a la clave privada. Los valores posibles son `limitedOrElevated` o `elevated`. El valor predeterminado es `limitedOrElevated`.

Importaciones

El elemento Imports describe una colección de módulos de importación para un rol web que agregan componentes al sistema operativo invitado. Este elemento es el elemento primario del elemento Import. Este elemento es opcional y un rol solo puede tener un bloque de importaciones.

El elemento Imports solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

Importación

El elemento Import especifica un módulo para agregar al sistema operativo invitado.

El elemento Import solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento Import:

Atributo	Tipo	Descripción
moduleName	string	Necesario. El nombre del módulo que se va a importar. Los módulos de importación válidos son: - RemoteAccess - RemoteForwarder - Diagnostics Los módulos RemoteAccess y RemoteForwarder permiten configurar la instancia de rol para las conexiones a Escritorio remoto. Para más información, consulte Extensiones. El módulo Diagnostics permite recopilar datos de diagnóstico para una instancia de rol.

Tiempo de ejecución

El elemento Runtime describe una colección de configuraciones de variables de entorno para un rol web que controlan el entorno en tiempo de ejecución del proceso de host de Azure. Este elemento es el elemento primario del elemento Environment. Este elemento es opcional y un rol solo puede tener un bloque de tiempo de ejecución.

El elemento Runtime solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento Runtime:

Atributo	Tipo	Descripción
executionContext	string	Opcional. Especifica el contexto en el que se inicia el proceso del rol. El contexto predeterminado es `limited`. - `limited`: el proceso se inicia sin necesidad de privilegios de administrador. - `elevated`: el proceso se inicia con privilegios de administrador.

Entorno

El elemento Environment describe una colección de configuraciones de variables de entorno para un rol web. Este elemento es el elemento primario del elemento Variable. Un rol puede tener cualquier número de conjunto de variables de entorno.

Variable

El elemento Variable especifica una variable de entorno para establecer en el sistema operativo invitado.

El elemento Variable solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento Variable:

Atributo	Tipo	Descripción
name	string	Necesario. El nombre de la variable de entorno que se establece.
value	string	Opcional. El valor que se establece para la variable de entorno. Debe incluir un atributo de valor o un elemento `RoleInstanceValue`.

RoleInstanceValue

El elemento RoleInstanceValue especifica la xPath de la que se recupera el valor de la variable.

En la tabla siguiente se describen los atributos del elemento RoleInstanceValue:

Atributo	Tipo	Descripción
xpath	string	Opcional. Ruta de acceso de ubicación de la configuración de implementación de la instancia. Para más información, vea las variables de configuración con XPath. Debe incluir un atributo de valor o un elemento `RoleInstanceValue`.

EntryPoint

El elemento EntryPoint especifica el punto de entrada de un rol. Este elemento es el elemento primario del elemento NetFxEntryPoint. Estos elementos le permiten especificar una aplicación que no sea la predeterminada WaWorkerHost.exe para que actúe como el punto de entrada del rol.

El elemento EntryPoint solo está disponible cuando se usa la versión 1.5 o posterior de Azure SDK.

NetFxEntryPoint

El elemento NetFxEntryPoint especifica el programa que se ejecutará para un rol.

Nota

El elemento NetFxEntryPoint solo está disponible cuando se usa la versión 1.5 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento NetFxEntryPoint:

Atributo	Tipo	Descripción
assemblyName	string	Necesario. La ruta de acceso y el nombre de archivo del ensamblado que contiene el punto de entrada. La ruta de acceso es relativa a la carpeta \%ROLEROOT%\Approot (no especifique \%ROLEROOT%\Approot en la línea de comandos, se da por supuesto). %ROLEROOT% es una variable de entorno que mantiene Azure y representa la ubicación de la carpeta raíz del rol. La carpeta \%ROLEROOT%\Approot representa la carpeta de aplicaciones para el rol. Para los roles de HWC la ruta de acceso siempre es relativa a la carpeta \%ROLEROOT%\Approot\bin. Para los roles web completos de IIS y IIS Express, si no se puede encontrar el ensamblado en la ruta de acceso relativa a la carpeta \%ROLEROOT%\Approot, se busca en la carpeta \%ROLEROOT%\Approot\bin. Este comportamiento de retroceso para el rol web completo de IIS no es un procedimiento recomendado y, por tanto, puede eliminarse en futuras versiones.
targetFrameworkVersion	string	Necesario. La versión de .NET Framework en la que se compiló el ensamblado. Por ejemplo, `targetFrameworkVersion="v4.0"`.

Sitios

El elemento Sites describe una colección de sitios web y aplicaciones web que se hospedan en un rol web. Este elemento es el elemento primario del elemento Site. Si no especifica un elemento Sites, el rol web se hospeda como un rol web heredado y solo puede tener un sitio web hospedado en el rol web. Este elemento es opcional y un rol solo puede tener un bloque de sitios.

El elemento Sites solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

Sitio

El elemento Site especifica un sitio web o aplicación web que forma parte del rol web.

El elemento Site solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento Site:

Atributo	Tipo	Descripción
name	string	Necesario. Nombre del sitio web o de la aplicación.
physicalDirectory	string	La ubicación del directorio de contenido de la raíz del sitio. La ubicación puede especificarse como una ruta de acceso absoluta o relativa a la ubicación de .csdef.

VirtualApplication

El elemento VirtualApplication define una aplicación de Internet Information Services (IIS) 7 como una agrupación de archivos que ofrece contenido o proporciona servicios a través protocolos como HTTP. Cuando se crea una aplicación en IIS 7, la ruta de acceso de la aplicación se convierte en parte de la dirección URL del sitio.

El elemento VirtualApplication solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento VirtualApplication:

Atributo	Tipo	Descripción
name	string	Necesario. Especifica un nombre para identificar la aplicación virtual.
physicalDirectory	string	Necesario. Especifica la ruta de acceso en el equipo de desarrollo que contiene la aplicación virtual. En el emulador de proceso, IIS se configura para recuperar el contenido desde esta ubicación. Cuando se implementa en Azure, el contenido del directorio físico se empaqueta junto con el resto del servicio. Cuando se implementa el paquete de servicio en Azure, IIS se configura con la ubicación del contenido desempaquetado.

VirtualDirectory

El elemento VirtualDirectory especifica un nombre de directorio (conocido también como ruta de acceso) que se especifica en IIS y se asigna a un directorio físico en un servidor local o remoto.

El elemento VirtualDirectory solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento VirtualDirectory:

Atributo	Tipo	Descripción
name	string	Necesario. Especifica un nombre para identificar el directorio virtual.
value	physicalDirectory	Necesario. Especifica la ruta de acceso en el equipo de desarrollo que incluye contenido del directorio virtual o del sitio web. En el emulador de proceso, IIS se configura para recuperar el contenido desde esta ubicación. Cuando se implementa en Azure, el contenido del directorio físico se empaqueta junto con el resto del servicio. Cuando se implementa el paquete de servicio en Azure, IIS se configura con la ubicación del contenido desempaquetado.

Enlaces

El elemento Bindings describe una colección de enlaces para un sitio web. Se trata del elemento principal del elemento Binding. El elemento es necesario para cada elemento Site. Para más información sobre cómo configurar los puntos de conexión, vea Habilitar la comunicación para instancias de rol en Azure.

El elemento Bindings solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

Enlace

El elemento Binding especifica la información de configuración requerida para que las solicitudes se comuniquen con un sitio web o aplicación web.

El elemento Binding solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

Atributo	Tipo	Descripción
name	string	Necesario. Especifica un nombre para identificar el enlace.
endpointName	string	Necesario. Especifica el nombre del punto de conexión al que enlazar.
hostHeader	string	Opcional. Especifica un nombre de host que le permite hospedar varios sitios, con nombres de host diferentes, en una combinación única de dirección IP/número de puerto.

Inicio

El elemento Startup describe una colección de tareas que se ejecutan cuando se inicia el rol. Este elemento es el elemento primario del elemento Variable. Para más información sobre el uso de las tareas de inicio de rol, vea cómo configurar las tareas de inicio. Este elemento es opcional y un rol solo puede tener un bloque de inicio.

En la tabla siguiente se describen los atributos del elemento Startup.

Atributo	Tipo	Descripción
priority	int	Solo para uso interno.

Tarea

El elemento Task especifica la tarea de inicio que tiene lugar cuando se inicia el rol. Las tareas de inicio pueden usarse para realizar tareas que preparan el rol para ejecutar la instalación de componentes de software o ejecutar otras aplicaciones. Las tareas se ejecutan en el orden en que aparecen en el bloque del elemento Startup.

El elemento Task solo está disponible cuando se usa la versión 1.3 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento Task:

Atributo	Tipo	Descripción
commandLine	string	Necesario. Un script, como un archivo CMD, que contiene los comandos que se van a ejecutar. Los comandos de inicio y los archivos por lotes se deben guardar en formato ANSI. Los formatos de archivo que establecen un marcador de orden de bytes al inicio del archivo no se procesarán correctamente.
executionContext	string	Especifica el contexto en el que se ejecuta el script. - `limited` [valor predeterminado]: se ejecuta con los mismos privilegios que el rol que hospeda el proceso. - `elevated`: se ejecuta con privilegios de administrador.
taskType	string	Especifica el comportamiento de ejecución del comando. - `simple` [valor predeterminado]: el sistema espera a que se cierre la tarea antes de iniciar otra. - `background`: el sistema no espera a que se cierre la tarea. - `foreground`: se parece a background, excepto que el rol no se reinicia hasta que todas las tareas de foreground se cierran.

Contenido

El elemento Contents describe la colección de contenido de un rol web. Este elemento es el elemento primario del elemento Content.

El elemento Contents solo está disponible cuando se usa la versión 1.5 o posterior de Azure SDK.

Contenido

El elemento Content define la ubicación de origen del contenido que se copiará en la máquina virtual de Azure y la ruta de acceso de destino en la que se copia.

El elemento Content solo está disponible cuando se usa la versión 1.5 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento Content:

Atributo	Tipo	Descripción
destination	string	Necesario. Ubicación en la máquina virtual de Azure en la que se coloca el contenido. Esta ubicación es relativa a la carpeta %ROLEROOT%\Approot.

Este elemento es el elemento primario del elemento SourceDirectory.

SourceDirectory

El elemento SourceDirectory define el directorio local desde el que se copia el contenido. Use este elemento para especificar el contenido local para copiar en la máquina virtual de Azure.

El elemento SourceDirectory solo está disponible cuando se usa la versión 1.5 o posterior de Azure SDK.

En la tabla siguiente se describen los atributos del elemento SourceDirectory:

Atributo	Tipo	Descripción
path	string	Necesario. Ruta de acceso absoluta o relativa de un directorio local cuyo contenido se copia en la máquina virtual de Azure. Se admite la expansión de variables de entorno en la ruta de acceso de directorio.

Pasos siguientes

Esquema de definición de Cloud Services (soporte extendido).

Compartir vía

Esquema de rol web de definición de Azure Cloud Services (soporte extendido)

Esquema básico de definición de servicio para un rol web

Elementos de esquema

WebRole

ConfigurationSettings

Configuración

LocalResources

LocalStorage

Puntos de conexión

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Certificados

Certificado

Importaciones

Importación

Tiempo de ejecución

Entorno

Variable

RoleInstanceValue

EntryPoint

NetFxEntryPoint

Sitios

Sitio

VirtualApplication

VirtualDirectory

Enlaces

Enlace

Inicio

Tarea

Contenido

Contenido

SourceDirectory

Pasos siguientes

Comentarios

Recursos adicionales