Inicio rápido: Creación de una conexión de servicio en App Service con la CLI de Azure

En este inicio rápido se describen los pasos para crear una conexión de servicio en Azure App Service con la CLI de Azure.

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

Requisitos previos

• 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.

• Para realizar este inicio rápido es necesaria la versión 2.30.0 o posterior de la CLI de Azure. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.
• En este inicio rápido, se da por supuesto que ya tiene al menos una instancia de App Service en ejecución en Azure. Si no tiene una instancia de App Service, créela.

Configuración inicial

1. Si usa Service Connector por primera vez, empiece ejecutando el comando az provider register para registrar el proveedor de recursos de Service Connector.

   az provider register -n Microsoft.ServiceLinker
   

   Sugerencia

   Es posible comprobar si el proveedor de recursos ya se ha registrado ejecutando el comando az provider show -n "Microsoft.ServiceLinker" --query registrationState. Si la salida fuera Registered, el conector de servicio ya se habrá registrado.

2. Opcionalmente, use el comando az webapp connection list-support-types de la CLI de Azure para obtener una lista de los servicios de destino admitidos por App Service.

   az webapp connection list-support-types --output table
   

Creación de una conexión de servicio

Uso de una identidad administrada

Importante

El uso de una identidad administrada requiere que tenga el permiso para la asignación de roles de Microsoft Entra. Si no tiene este permiso, se producirá un error en la creación de una conexión. Pida al propietario de la suscripción que le conceda este permiso o use una clave de acceso para crear la conexión.

Use el comando az webapp connection de la CLI de Azure para crear una conexión de servicio a una instancia de Blob Storage con una identidad administrada asignada por el sistema, proporcionando la siguiente información:

• El nombre del grupo de recursos que contiene la aplicación de App Service
• El nombre de la aplicación de App Service
• El nombre del grupo de recursos donde se incluye la cuenta de almacenamiento
• El nombre de la cuenta de almacenamiento

az webapp connection create storage-blob

Nota:

Si no tiene una instancia de Blob Storage, puede ejecutar az webapp connection create storage-blob --new --system-identity para aprovisionar un recurso de Blob Storage nuevo y conectarse directamente a la instancia de App Service.

Uso de una clave de acceso

Use el comando az webapp connection de la CLI de Azure para crear una conexión de servicio a Azure Blob Storage con una clave de acceso, proporcionando la siguiente información:

• Nombre del grupo de recursos del servicio de proceso de origen: el nombre del grupo de recursos de la aplicación de App Service.
• Nombre de la aplicación de App Service: el nombre de la aplicación de App Service que se conecta al servicio de destino.
• Nombre del grupo de recursos del servicio de destino: el nombre del grupo de recursos de la aplicación del almacenamiento de blobs.
• Nombre de cuenta de almacenamiento: el nombre de la cuenta de Blob Storage.

az webapp connection create storage-blob --secret

Sugerencia

Si no tiene una instancia de Blob Storage, ejecute az webapp connection create storage-blob --new --secret para aprovisionar uno nuevo y conectarse directamente al recurso de App Service.

Ver conexiones

Ejecute el comando az webapp connection de la CLI de Azure para mostrar las conexiones a la aplicación de App Service, proporcionando la siguiente información:

• El nombre del grupo de recursos que contiene la aplicación de App Service
• El nombre de la aplicación de App Service

az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

Pasos siguientes

Complete los tutoriales a continuación para empezar a crear su propia aplicación con el conector de servicio.

Tutorial: Aplicación web y Storage con la CLI de Azure

Tutorial: Aplicación web y PostgreSQL con la CLI de Azure