Esquema WebRole de definición de Azure Cloud Services (clásico)
Importante
Cloud Services (clásico) ahora está en desuso para los nuevos clientes y se retirará el 31 de agosto de 2024 para todos los clientes. Las nuevas implementaciones deben utilizar el nuevo modelo de implementación basado en Azure Resource Manager Azure Cloud Services (soporte extendido) .
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 sucesivas secciones de este tema:
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 veinticinco puntos de conexión de entrada, internos y de entrada de instancia que se pueden asignar entre los veinticinco roles permitidos en un servicio. Por ejemplo, si tiene cinco roles, puede asignar cinco puntos de conexión de entrada por rol, veinticinco puntos de conexión de entrada a un único rol o asignar un punto de conexión de entrada a cada veinticinco 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. Esto 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 quita 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 puertos 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 escucharán 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. Esto 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, vea cómo habilitar la conexión a Escritorio remoto. 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 commandLine, se supone). %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 de IIS Express, si el ensamblado no se encuentra en relación con la carpeta \%ROLEROOT%\Approot, se busca \%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 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 primario 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 copiará en la máquina virtual de Azure. Se admite la expansión de variables de entorno en la ruta de acceso de directorio. |
Consulte también
Cloud Service (classic) Definition Schema (Esquema de definición de servicio en la nube [clásico])