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

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

Identidad administrada

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.

1. Ejecute el comando az containerapp connection create para 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-identity
   

2. Proporcione la siguiente información en la solicitud de la CLI de Azure:

   Configuración	Descripción
   The resource group that contains the container app	Nombre del grupo de recursos con la aplicación de contenedor.
   Name of the container app	Nombre de la aplicación de contenedor.
   The container where the connection information will be saved	Nombre del contenedor de la aplicación.
   The resource group which contains the storage account	Nombre del grupo de recursos con la cuenta de almacenamiento.
   Name of the storage account	Nombre 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.

Clave de acceso

Advertencia

Microsoft recomienda usar el flujo de autenticación más seguro disponible. El flujo de autenticación que se describe en este procedimiento requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.

1. Ejecute el comando az containerapp connection create para crear una conexión de servicio entre Container Apps y Azure Blob Storage mediante una clave de acceso.

   az containerapp connection create storage-blob --secret
   

2. Proporcione la siguiente información en la solicitud de la CLI de Azure:

   Configuración	Descripción
   The resource group that contains the container app	Nombre del grupo de recursos con la aplicación de contenedor.
   Name of the container app	Nombre de la aplicación de contenedor.
   The container where the connection information will be saved	Nombre del contenedor de la aplicación.
   The resource group which contains the storage account	Nombre del grupo de recursos con la cuenta de almacenamiento.
   Name of the storage account	Nombre de la cuenta de almacenamiento a la que quiere conectarse. En esta guía, se usa una instancia de Blob Storage.

Sugerencia

Si no tiene Blob Storage, puede ejecutar az containerapp connection create storage-blob --new --secret para disponer de uno nuevo y conectarlo directamente a la aplicación de contenedor mediante una cadena de conexión.

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.

Pasos siguientes

Aspectos internos de Service Connector