Configuración del proyecto de Azure en Visual Studio para usar varias configuraciones de servicio

Nota

Este artículo se aplica a Azure Azure Cloud Services (soporte extendido). Cloud Services (clásico) se retira a partir del 31 de agosto de 2024. Para obtener más información, consulte el modelo de implementación de Cloud Services (clásico) se va a retirar el 31 de agosto de 2024. Para el nuevo desarrollo, se recomienda usar un tipo de servicio más reciente diseñado para su propósito específico, como Azure App Service, Azure Functionso Azure Container Apps. Para obtener la lista más reciente de los servicios disponibles, consulte Directorio de productos de Azure.

Un proyecto de Azure Cloud Services (soporte extendido) en Visual Studio incluye tres archivos de configuración: ServiceDefinition.csdef, ServiceConfiguration.Local.cscfgy ServiceConfiguration.Cloud.cscfg:

• ServiceDefinition.csdef se implementa en Azure para describir los requisitos del servicio en la nube y sus roles, y para proporcionar la configuración que se aplica a todas las instancias. La configuración se puede leer en tiempo de ejecución mediante la API del entorno de ejecución de hospedaje de servicios de Azure. Este archivo solo se puede actualizar en Azure cuando se detiene el servicio en la nube.
• ServiceConfiguration.Local.cscfg y ServiceConfiguration.Cloud.cscfg proporcionan valores para la configuración en el archivo de definición y especifican el número de instancias que se van a ejecutar para cada rol. El archivo "Local" contiene valores usados en la depuración local; El archivo "Nube" se implementa en Azure como ServiceConfiguration.cscfg y proporciona la configuración del entorno de servidor. Este archivo se puede actualizar mientras el servicio en la nube se ejecuta en Azure.

Las opciones de configuración se administran y modifican en Visual Studio mediante páginas de propiedades para el rol aplicable (haga clic con el botón derecho en el rol y seleccione Propiedadeso haga doble clic en el rol). Los cambios se pueden limitar a cualquier configuración que se elija en la lista desplegable configuración del servicio . Las propiedades de los roles web y de trabajo son similares, excepto donde se describen en las secciones siguientes.

Para obtener información sobre los esquemas subyacentes para los archivos de definición de servicio y configuración del servicio, consulte los artículos esquema XML .csdef y esquema XML .cscfg. Para obtener más información sobre la configuración del servicio, consulte Configuración de Cloud Services.

Página Configuración

Configuración del servicio

Selecciona qué archivo ServiceConfiguration.*.cscfg se ve afectado por los cambios. De forma predeterminada, hay variantes locales y en la nube, y puede usar el comando Administrar... para copiar, cambiar el nombre y quitar archivos de configuración. Estos archivos se agregan al proyecto de servicio en la nube y aparecen en Explorador de soluciones. Sin embargo, el cambio de nombre o eliminación de configuraciones solo se puede realizar desde este control.

Instancias

Establezca la propiedad Número de instancias en el número de instancias que el servicio debe ejecutar para este rol.

Acción de inicio (solo para el rol web)

Establezca esta propiedad para especificar que Visual Studio debe iniciar un explorador web para los puntos de conexión HTTP o los puntos de conexión HTTPS, o ambos al iniciar la depuración.

La opción de punto de conexión HTTPS solo está disponible si ya ha definido un punto de conexión HTTPS para su rol. Puede definir un punto de conexión HTTPS en la página de propiedades Puntos de Conexión .

Si ya ha agregado un punto de conexión HTTPS, la opción punto de conexión HTTPS está habilitada de forma predeterminada y Visual Studio inicia un explorador para este punto de conexión al iniciar la depuración, además de un explorador para el punto de conexión HTTP, suponiendo que ambas opciones de inicio estén habilitadas.

Página Configuración

En la página Configuración, puede agregar la configuración como pares nombre-valor. El código que se ejecuta en el rol puede leer los valores de sus valores de configuración en tiempo de ejecución mediante las clases proporcionadas por la biblioteca administrada de Azure, en particular, el método GetConfigurationSettingValue.

Configuración de una cadena de conexión para una cuenta de almacenamiento

Una cadena de conexión es una configuración que proporciona información de conexión y autenticación para el emulador de almacenamiento o para una cuenta de Azure Storage. Cada vez que el código de un rol accede a Azure Storage (blobs, colas o tablas), necesita una cadena de conexión.

Nota

Una cadena de conexión para la cuenta de Azure Storage debe usar un formato definido (consulte Configuración de cadenas de conexión de Azure Storage).

Puede establecer la cadena de conexión para que use el almacenamiento local según sea necesario y, a continuación, establecer en una cuenta de Azure Storage al implementar la aplicación el servicio en la nube. Si no se establece correctamente la cadena de conexión, es posible que el rol no se inicie o que pase por los estados de inicialización, ocupado y detención.

Para crear una cadena de conexión, seleccione Agregar configuración y establezca el Tipo en "Cadena de conexión".

Para cadenas de conexión nuevas o existentes, seleccione ...* a la derecha del campo Valor para abrir el cuadro de diálogo Crear cadena de conexión de almacenamiento:

1. En Conectar mediante, elija la opción Su suscripción para seleccionar una cuenta de almacenamiento de una suscripción. A continuación, Visual Studio obtiene automáticamente las credenciales de la cuenta de almacenamiento del archivo .publishsettings.
2. Al seleccionar credenciales introducidas manualmente, le permite especificar el nombre y la clave de la cuenta directamente usando información del portal de Azure. Para copiar la clave de cuenta:
   1. Vaya a la cuenta de almacenamiento en Azure Portal y seleccione Administrar claves.
   2. Para copiar la clave de cuenta, vaya a la cuenta de almacenamiento en Azure Portal, seleccione Configuración > Claves de accesoy, a continuación, use el botón Copiar para copiar la clave de acceso principal en el Portapapeles.
3. Seleccione una de las opciones de conexión. Especificar puntos de conexión personalizados le pide que especifique direcciones URL específicas para blobs, tablas y colas. Los puntos de conexión personalizados permiten usar dominios personalizados y controlar el acceso más exactamente. Consulte Configuración de las cadenas de conexión de Azure Storage.
4. Seleccione Aceptar y, después, Archivo > Guardar, para actualizar la configuración con la nueva cadena de conexión.

De nuevo, al publicar la aplicación en Azure, elija la configuración del servicio que contiene la cuenta de Azure Storage para la cadena de conexión. Una vez publicada la aplicación, compruebe que la aplicación funciona según lo previsto en los servicios de Azure Storage.

Para obtener más información sobre cómo actualizar las configuraciones del servicio, consulte la sección Administración de cadenas de conexión para cuentas de almacenamiento.

Página Extremos

Normalmente, un rol web tiene un único punto de conexión HTTP en el puerto 80. En cambio, un rol de trabajo puede tener cualquier número de puntos de conexión HTTP, HTTPS o TCP. Los puntos de conexión pueden ser puntos de conexión de entrada, que están disponibles para clientes externos o puntos de conexión internos, que están disponibles para otros roles que se ejecutan en el servicio.

• Para que un punto de conexión HTTP esté disponible para clientes externos y exploradores web, cambie el tipo de punto de conexión a la entrada y especifique un nombre y un número de puerto público.
• Para que un punto de conexión HTTPS esté disponible para clientes externos y exploradores web, cambie el tipo de punto de conexión a entraday especifique un nombre, un número de puerto público y un nombre de certificado de administración. También debe definir el certificado en la página de propiedades Certificados para poder especificar un certificado de administración.
• Para que un punto de conexión esté disponible para el acceso interno por otros roles del servicio en la nube, cambie el tipo de punto de conexión a interno y especifique un nombre y puertos privados posibles para este punto de conexión.

Página de almacenamiento local

Puede usar la página de propiedades Almacenamiento local para reservar uno o más recursos de almacenamiento local para un rol. Un recurso de almacenamiento local es un directorio reservado en el sistema de archivos de la máquina virtual de Azure en la que se ejecuta una instancia de un rol.

Página Certificados

La página de propiedades Certificados agrega información sobre los certificados a la configuración del servicio. Tenga en cuenta que los certificados no se empaquetan con el servicio; Debe cargar los certificados por separado en Azure a través de Azure Portal.

Agregar un certificado aquí agrega información sobre los certificados a la configuración del servicio. Los certificados no se empaquetan con el servicio; Debe cargar los certificados por separado a través de Azure Portal.

Para asociar un certificado con el rol, proporcione un nombre para el certificado. Use este nombre para hacer referencia al certificado al configurar un punto de conexión HTTPS en la página Endpoints. A continuación, especifique si el almacén de certificados es máquina local o usuario actual y el nombre del almacén. Por último, escriba la huella digital del certificado. Si el certificado está en el almacén Current User\Personal (My), para especificar la huella digital del certificado selecciónelo en una lista rellenada. Si reside en cualquier otra ubicación, escriba el valor de huella digital a mano.

Al agregar un certificado desde el almacén de certificados, los certificados intermedios se agregan automáticamente a los valores de configuración. Además, estos certificados intermedios se deben cargar en Azure para configurar correctamente el servicio para SSL.

Los certificados de administración que asocie al servicio solo se aplican al servicio cuando se ejecuta en la nube. Cuando el servicio se ejecuta en el entorno de desarrollo local, usa un certificado estándar administrado por el emulador de proceso.