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
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.ServiceLinkerSugerencia
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 fueraRegistered, el conector de servicio ya se habrá registrado.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
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.
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.