Tutorial: Implementación de una aplicación web conectada a Azure Blob Storage con un conector de servicio

En este tutorial, aprenderá a acceder a Azure Blob Storage para acceder a una aplicación web (no un usuario con sesión iniciada) que se ejecuta en Azure App Service mediante identidades administradas. En este tutorial, usaremos la CLI de Azure para completar las siguientes tareas:

• Configurar el entorno inicial con la CLI de Azure
• Crear una cuenta de almacenamiento y un contenedor de Azure Blob Storage.
• Implementación de código en Azure App Service y conexión al almacenamiento con identidad administrada mediante el conector de servicio

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Configuración del entorno inicial

1. Compruebe que la versión de la CLI de Azure es la 2.30.0 o posterior:

   az --version
   

   Si necesita actualizar, ejecute el comando az upgrade (requiere la versión 2.11 o superior).

2. Inicie sesión en Azure mediante la CLI:

   az login
   

   Este comando abre un explorador que recopila las credenciales. Cuando el comando finaliza, muestra una salida JSON que contiene información sobre las suscripciones.

   Una vez que haya iniciado sesión, puede ejecutar comandos de Azure con la CLI de Azure para trabajar con los recursos de su suscripción.

Clonación o descarga de la aplicación de ejemplo

1. Clone el repositorio de ejemplo:

   git clone https://github.com/Azure-Samples/serviceconnector-webapp-storageblob-dotnet.git
   

2. Vaya a la carpeta raíz del repositorio:

   cd serviceconnector-webapp-storageblob-dotnet
   

Creación de la aplicación de App Service

1. En el terminal, asegúrese de que está en la carpeta del repositorio WebAppStorageMISample que contiene el código de la aplicación.

2. Cree una aplicación de App Service (el proceso de host) con el comando az webapp up siguiente y reemplace los marcadores de posición por sus propios datos:

   • En el argumento --location, use una región compatible con el conector de servicio.
   • Reemplace <app-name> por un nombre que sea único en Azure. El punto de conexión del servidor es https://<app-name>.azurewebsites.net. Los caracteres permitidos en <app-name> son A-Z, 0-9 y -. Un buen patrón es usar una combinación del nombre de la empresa y un identificador de la aplicación.

    az webapp up --name <app-name> --sku B1 --location eastus --resource-group ServiceConnector-tutorial-rg
   

Creación de una cuenta de almacenamiento y un contenedor de Blob Storage

Para crear una cuenta de almacenamiento de uso general v2 y un contenedor de Blob Storage, ejecute el siguiente comando en el terminal.

az storage account create --name <storage-name> --resource-group ServiceConnector-tutorial-rg --sku Standard_RAGRS --https-only

Reemplace <storage-name> por un nombre único. El nombre del contenedor debe escribirse en minúsculas, comenzar por una letra o un número y solo puede incluir letras, números y el carácter de guion (-).

Conexión de una aplicación de App Service a un contenedor de Blob Storage con identidad administrada

En el terminal, ejecute el siguiente comando para conectar la aplicación web a una instancia de Blob Storage mediante una identidad administrada.

az webapp connection create storage-blob -g ServiceConnector-tutorial-rg -n <app-name> --tg ServiceConnector-tutorial-rg --account <storage-name> --system-identity

Reemplace los siguientes marcadores de posición por sus propios datos:

• Reemplace <app-name> por el nombre de la aplicación web que usó en el paso 3.
• Reemplace <storage-name> por el nombre de la aplicación de almacenamiento que usó en el paso 4.

Nota:

Si ve el mensaje de error "La suscripción no está registrada para usar Microsoft.ServiceLinker", ejecute az provider register -n Microsoft.ServiceLinker para registrar el proveedor de recursos del conector de servicio y vuelva a ejecutar el comando de conexión.

Ejecución del código de ejemplo

En el terminal, ejecute el siguiente comando para abrir la aplicación de ejemplo en el explorador. Reemplace <app-name> por el nombre de la aplicación web que usó anteriormente.

az webapp browse --name <app-name> 

El código de ejemplo es una aplicación web. Cada vez que actualice la página de índice, la aplicación creará o actualizará un blob con el texto Hello Service Connector! Current is {UTC Time Now} en el contenedor de almacenamiento y volverá a leerlo para mostrarlo en la página de índice.

Paso siguiente

Para más información sobre el conector de servicio, lea las guías que encontrará a continuación.

Conceptos del conector de servicio