¿Qué es el modelo de servicio en la nube (clásico) y cómo se empaqueta?

Un servicio en la nube se crea a partir de tres componentes: la definición de servicio (.csdef), la configuración de servicio (.cscfg) y un paquete de servicio (.cspkg). Los archivos ServiceDefinition.csdef y ServiceConfig.cscfg se basan ambos en XML y describen la estructura del servicio en la nube y cómo se configura; lo que se conoce en conjunto como modelo. ServicePackage.cspkg es un archivo ZIP que se genera a partir de ServiceDefinition.csdef y, entre otros, contiene todas las dependencias necesarias basadas en archivos binarios. Azure crea un servicio en la nube a partir de ServicePackage.cspkg y ServiceConfig.cscfg.

Una vez que se ejecuta el servicio en la nube en Azure, puede volver a configurarlo mediante el archivo ServiceConfig.cscfg , pero no puede alterar la definición.

¿Sobre qué le gustaría saber más?

• Quiero saber más sobre los archivos ServiceDefinition.csdef y ServiceConfig.cscfg.
• Eso ya lo sé. Deme algunos ejemplos sobre lo que puedo configurar.
• Quiero crear el archivo ServicePackage.cspkg.
• Estoy usando Visual Studio y quiero...
  • Creación de un servicio en la nube
  • Volver a configurar un servicio en la nube existente
  • Implementar un proyecto de servicio en la nube
  • Escritorio remoto en una instancia de servicio en la nube

ServiceDefinition.csdef

El archivo ServiceDefinition.csdef especifica los valores que usa Azure para configurar un servicio en la nube. El esquema de definición de servicio de Azure (archivo .csdef) proporciona el formato permitido para un archivo de definición de servicio. En el ejemplo siguiente se muestra la configuración que se puede definir para los roles web y de trabajo:

<?xml version="1.0" encoding="utf-8"?>
<ServiceDefinition name="MyServiceName" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition">
  <WebRole name="WebRole1" vmsize="Medium">
    <Sites>
      <Site name="Web">
        <Bindings>
          <Binding name="HttpIn" endpointName="HttpIn" />
        </Bindings>
      </Site>
    </Sites>
    <Endpoints>
      <InputEndpoint name="HttpIn" protocol="http" port="80" />
      <InternalEndpoint name="InternalHttpIn" protocol="http" />
    </Endpoints>
    <Certificates>
      <Certificate name="Certificate1" storeLocation="LocalMachine" storeName="My" />
    </Certificates>
    <Imports>
      <Import moduleName="Connect" />
      <Import moduleName="Diagnostics" />
      <Import moduleName="RemoteAccess" />
      <Import moduleName="RemoteForwarder" />
    </Imports>
    <LocalResources>
      <LocalStorage name="localStoreOne" sizeInMB="10" />
      <LocalStorage name="localStoreTwo" sizeInMB="10" cleanOnRoleRecycle="false" />
    </LocalResources>
    <Startup>
      <Task commandLine="Startup.cmd" executionContext="limited" taskType="simple" />
    </Startup>
  </WebRole>

  <WorkerRole name="WorkerRole1">
    <ConfigurationSettings>
      <Setting name="DiagnosticsConnectionString" />
    </ConfigurationSettings>
    <Imports>
      <Import moduleName="RemoteAccess" />
      <Import moduleName="RemoteForwarder" />
    </Imports>
    <Endpoints>
      <InputEndpoint name="Endpoint1" protocol="tcp" port="10000" />
      <InternalEndpoint name="Endpoint2" protocol="tcp" />
    </Endpoints>
  </WorkerRole>
</ServiceDefinition>

Puede hacer referencia al esquema de definición de servicio para entender mejor el esquema XML que se usa aquí; sin embargo, a continuación se da una explicación rápida de algunos de los elementos:

Sites
contiene las definiciones de sitios web o aplicaciones web que se hospedan en IIS7.

InputEndpoints
contiene las definiciones de los extremos que se usan para ponerse en contacto con el servicio en la nube.

InternalEndpoints
contiene las definiciones de los extremos que se usan en las instancias de rol para comunicarse entre sí.

ConfigurationSettings
contiene las definiciones de configuración de las características de un rol concreto.

Certificados
contiene las definiciones de los certificados que son necesarios para un rol. En el ejemplo de código anterior se muestra un certificado que se usa para la configuración de Azure Connect.

LocalResources
contiene las definiciones de los recursos de almacenamiento local. Un recurso de almacenamiento local es un directorio reservado en el sistema de archivos de la máquina virtual en la que se ejecuta una instancia de un rol.

Importaciones
contiene las definiciones de los módulos importados. El ejemplo de código anterior muestra los módulos de Conexión a Escritorio remoto y Azure Connect.

Startup
contiene las tareas que se ejecutan cuando se inicia el rol. Las tareas se definen en un archivo ejecutable o .cmd.

ServiceConfiguration.cscfg

La configuración de los valores del servicio en la nube viene determinada por los valores del archivo ServiceConfiguration.cscfg . Especifique el número de instancias que desea implementar para cada rol en este archivo. Los valores de configuración que ha definido en el archivo de definición de servicio se agregan al archivo de configuración de servicio. Las huellas digitales de los certificados de administración que están asociados con el servicio en la nube también se agregan al archivo. El esquema de configuración de servicio de Azure (archivo .cscfg) proporciona el formato permitido para un archivo de configuración de servicio.

El archivo de configuración de servicio no se empaqueta con la aplicación, sino que se carga en Azure como un archivo independiente y se usa para configurar el servicio en la nube. Puede cargar un nuevo archivo de configuración de servicio sin volver a implementar el servicio en la nube. Los valores de configuración del servicio en la nube pueden cambiarse mientras el servicio en la nube se está ejecutando. En el ejemplo siguiente se muestran los valores de configuración que se pueden definir para los roles web y de trabajo:

<?xml version="1.0"?>
<ServiceConfiguration serviceName="MyServiceName" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration">
  <Role name="WebRole1">
    <Instances count="2" />
    <ConfigurationSettings>
      <Setting name="SettingName" value="SettingValue" />
    </ConfigurationSettings>

    <Certificates>
      <Certificate name="CertificateName" thumbprint="CertThumbprint" thumbprintAlgorithm="sha1" />
      <Certificate name="Microsoft.WindowsAzure.Plugins.RemoteAccess.PasswordEncryption"
         thumbprint="CertThumbprint" thumbprintAlgorithm="sha1" />
    </Certificates>
  </Role>
</ServiceConfiguration>

Puede hacer referencia al esquema de configuración de servicio para comprender mejor el esquema XML que se usa aquí; sin embargo, a continuación se da una explicación rápida de los elementos:

Instancias
configura el número de instancias en ejecución para el rol. Para evitar la posibilidad de que el servicio en la nube deje de estar disponible durante las actualizaciones, es recomendable que implemente más de una instancia de los roles accesibles a través de web. Al hacerlo, estará siguiendo las instrucciones del Acuerdo de Nivel de Servicio de Azure Compute, que garantiza la conectividad externa del 99,95 % para los roles accesibles a través de Internet cuando se implementan dos o más instancias de rol para un servicio.

ConfigurationSettings
configura los valores de las instancias en ejecución de un rol. El nombre de los elementos <Setting> debe coincidir con las definiciones de configuración del archivo de definición de servicio.

Certificados
configura los certificados usados por el servicio. En el ejemplo de código anterior se muestra cómo definir el certificado para el módulo RemoteAccess. El valor del atributo thumbprint debe establecerse en la huella digital del certificado que se va a usar.

Definición de los puertos de las instancias de rol

Azure permite un solo punto de entrada a un rol web. Esto significa que todo el tráfico se produce a través de una dirección IP. Puede configurar sus sitios web para que compartan un puerto configurando el encabezado host para dirigir la solicitud a la ubicación correcta. También puede configurar las aplicaciones para que escuchen en puertos conocidos de la dirección IP.

En el ejemplo siguiente se muestra la configuración de un rol web con un sitio web y una aplicación web. El sitio web se configura como la ubicación de entrada predeterminada en el puerto 80 y las aplicaciones web se configuran para recibir solicitudes de un encabezado host alternativo que se llama "mail.mysite.cloudapp.net".

<WebRole>
  <ConfigurationSettings>
    <Setting name="DiagnosticsConnectionString" />
  </ConfigurationSettings>
  <Endpoints>
    <InputEndpoint name="HttpIn" protocol="http" port="80" />
    <InputEndpoint name="Https" protocol="https" port="443" certificate="SSL"/>
    <InputEndpoint name="NetTcp" protocol="tcp" port="808" certificate="SSL"/>
  </Endpoints>
  <LocalResources>
    <LocalStorage name="Sites" cleanOnRoleRecycle="true" sizeInMB="100" />
  </LocalResources>
  <Site name="Mysite" packageDir="Sites\Mysite">
    <Bindings>
      <Binding name="http" endpointName="HttpIn" />
      <Binding name="https" endpointName="Https" />
      <Binding name="tcp" endpointName="NetTcp" />
    </Bindings>
  </Site>
  <Site name="MailSite" packageDir="MailSite">
    <Bindings>
      <Binding name="mail" endpointName="HttpIn" hostHeader="mail.mysite.cloudapp.net" />
    </Bindings>
    <VirtualDirectory name="artifacts" />
    <VirtualApplication name="storageproxy">
      <VirtualDirectory name="packages" packageDir="Sites\storageProxy\packages"/>
    </VirtualApplication>
  </Site>
</WebRole>

Cambio de la configuración de un rol

Puede actualizar la configuración de su servicio en la nube mientras se ejecuta en Azure, sin necesidad de desconectarlo. Para cambiar la información de configuración, puede cargar un nuevo archivo de configuración, o editar el archivo de configuración existente y aplicarlo al servicio en ejecución. Pueden realizarse los siguientes cambios en la configuración de un servicio:

• Cambiar los valores de configuración
  : cuando los valores de una configuración cambian, una instancia de rol puede elegir aplicar el cambio mientras la instancia está en línea, o bien reciclar la instancia correctamente y aplicar el cambio mientras la instancia está sin conexión.
• Cambiar la topología de servicio de las instancias de rol
  : los cambios en la topología no afectan a las instancias en ejecución, excepto donde se vaya a eliminar una instancia. Por lo general, el resto de instancias no es necesario reciclarlas; sin embargo, puede decidir hacerlo en respuesta a un cambio en la topología.
• Cambiar la huella digital del certificado
  : solo puede actualizar un certificado cuando una instancia de rol está sin conexión. Si un certificado se agrega, elimina o cambia mientras la instancia de rol está en línea, Azure dejará la instancia sin conexión para actualizar el certificado y la volverá a poner en línea una vez completado el cambio.

Control de los cambios de configuración con eventos de tiempo de ejecución de servicio

La biblioteca en tiempo de ejecución de Azure incluye el espacio de nombres Microsoft.WindowsAzure.ServiceRuntime, que proporciona clases para interactuar con el entorno de Azure desde un rol. La clase RoleEnvironment define los siguientes eventos que se producen antes y después de un cambio de configuración:

• Cambiar evento
  Esto se produce antes de que el cambio de configuración se aplique a una instancia especificada de un rol, lo que le ofrece la oportunidad de dar de baja las instancias de rol, en caso necesario.
• Evento cambiado
  : se produce después de que el cambio de configuración se aplica a una instancia especificada de un rol.

ServicePackage.cspkg

Para implementar una aplicación como un servicio en la nube de Azure, primero debe empaquetar la aplicación en el formato adecuado. Puede usar la herramienta de línea de comandos CSPack (que se instala con el SDK de Azure) para crear el archivo de paquete como una alternativa a Visual Studio.

CSPack usa el contenido del archivo de configuración de servicio y del archivo de definición de servicio para definir el contenido del paquete. CSPack genera un archivo de paquete de aplicación (.cspkg) que puede cargar en Azure mediante el Portal de Azure. De forma predeterminada, el paquete se denomina [ServiceDefinitionFileName].cspkg, pero puede especificar un nombre diferente mediante la opción /out de CSPack.

CSPack se encuentra en:
C:\Program Files\Microsoft SDKs\Azure\.NET SDK\[sdk-version]\bin\

Comando de ejemplo para empaquetar un servicio en la nube

En el ejemplo siguiente se crea un paquete de aplicación que contiene la información de un rol web. El comando especifica el archivo de definición de servicio que se usará, el directorio donde se pueden encontrar los archivos binarios y el nombre del archivo de paquete.

cspack [DirectoryName]\[ServiceDefinition]
       /role:[RoleName];[RoleBinariesDirectory]
       /sites:[RoleName];[VirtualPath];[PhysicalPath]
       /out:[OutputFileName]

Si la aplicación contiene un rol web y un rol de trabajo, se usa el siguiente comando:

cspack [DirectoryName]\[ServiceDefinition]
       /out:[OutputFileName]
       /role:[RoleName];[RoleBinariesDirectory]
       /sites:[RoleName];[VirtualPath];[PhysicalPath]
       /role:[RoleName];[RoleBinariesDirectory];[RoleAssemblyName]

Donde las variables se definen como de la manera siguiente:

Pasos siguientes

Voy a crear un paquete de servicio en la nube y quiero...

• Configurar Escritorio remoto para una instancia de servicio en la nube
• Implementar un proyecto de servicio en la nube

Estoy usando Visual Studio y quiero...

• Crear un nuevo servicio en la nube
• Volver a configurar un servicio en la nube existente
• Implementar un proyecto de servicio en la nube
• Configurar Escritorio remoto para una instancia de servicio en la nube