Inicio rápido: Creación de una conexión de servicio en Azure Container Apps con la CLI de Azure
En este inicio rápido se muestra cómo conectar Azure Container Apps a otros recursos en la nube mediante la CLI de Azure y Service Connector. Service Connector permite conectar con rapidez los servicios de proceso a los servicios en la nube, a la vez que administra la autenticación y la configuración de red de la conexión.
Importante
Conector de servicio de Container Apps se encuentra actualmente en versión preliminar. Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.
Requisitos previos
Suscripción a Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Al menos una aplicación implementada en Container Apps en una región compatible con Service Connector. Si no tiene uno, cree e implemente un contenedor en Container Apps.
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.
La versión 2.37.0 o superior de la CLI de Azure debe estar instalada. Para realizar la actualización a la versión más reciente, ejecute
az upgrade. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.La extensión Container Apps debe instalarse en la CLI de Azure o en Cloud Shell. Para instalarlo, ejecute
az extension add --name containerapp.
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, ejecute el comando az containerapp connection list-support-types para obtener una lista de los servicios de destino admitidos por Container Apps.
az containerapp connection list-support-types --output table
Creación de una conexión de servicio
Cree una conexión mediante una identidad administrada o una clave de acceso.
Importante
Para usar una identidad administrada, debe tener permiso para modificar la asignación de roles de Microsoft Entra. Si no tiene este permiso, se producirá un error en la creación de la 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.
Ejecute el comando
az containerapp connection createpara crear una conexión de servicio desde Container Apps a Blob Storage con una identidad administrada asignada por el sistema.az containerapp connection create storage-blob --system-identityProporcione la siguiente información en la solicitud de la CLI de Azure:
Configuración Descripción The resource group that contains the container appNombre del grupo de recursos con la aplicación de contenedor. Name of the container appNombre de la aplicación de contenedor. The container where the connection information will be savedNombre del contenedor de la aplicación. The resource group which contains the storage accountNombre del grupo de recursos con la cuenta de almacenamiento. Name of the storage accountNombre de la cuenta de almacenamiento a la que quiere conectarse. En esta guía, se usa una instancia de Blob Storage.
Nota:
Si no tiene Blob Storage, puede ejecutar az containerapp connection create storage-blob --new --system-identity para disponer de uno nuevo y conectarlo directamente a la aplicación de contenedor mediante una identidad administrada.
Ver conexiones
Use el comando az containerapp connection list de la CLI de Azure para enumerar todas las conexiones aprovisionadas de la aplicación contenedora. Reemplace los marcadores de posición <container-app-resource-group> y <container-app-name> del comando a continuación por el grupo de recursos y el nombre de la aplicación de contenedor. También puede quitar la opción --output table para consultar más información sobre las conexiones.
az containerapp connection list -g "<container-app-resource-group>" --name "<container-app-name>" --output table
La salida también muestra el estado de aprovisionamiento de las conexiones: error o correcto.