Inicio rápido: Conexión de Azure Container Apps a bases de datos y servicios con Service Connector (versión preliminar)

Introducción a Service Connector para conectar Azure Container Apps a bases de datos, cuentas de almacenamiento y otros servicios de Azure. Service Connector simplifica la autenticación y la configuración, lo que le permite conectarse a recursos mediante identidades administradas u otros métodos de autenticación.

En este artículo se proporcionan instrucciones paso a paso para Azure Portal y la CLI de Azure. Elija su método preferido con las pestañas anteriores.

Importante

La compatibilidad con Service Connector (versión preliminar) en Azure Container Apps finaliza el 30 de marzo de 2026. Después de esa fecha, las nuevas conexiones de servicio que usan Service Connector (versión preliminar) no están disponibles a través de ninguna interfaz. Para más información, consulte RETIRADA: Service Connector (versión preliminar) en Azure Container Apps.

Requisitos previos

Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
Una aplicación implementada en Container Apps en una región compatible con Service Connector.
Un recurso de destino al que conectar Container Apps, como una cuenta de Blob Storage.
Los permisos necesarios para crear y administrar conexiones de servicio.

Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
Una aplicación implementada en Container Apps en una región compatible con Service Connector.
Un recurso de destino al que conectar Container Apps, como una cuenta de Blob Storage.
Los permisos necesarios para crear y administrar conexiones de servicio.

Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a 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 Autenticación en Azure mediante 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 obtener más información sobre las extensiones, consulte Uso y administración 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. 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.

Configuración del entorno

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.
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 (versión preliminar)

Use Service Connector para crear una conexión de servicio entre Azure Container Apps y Azure Blob Storage. En este ejemplo se muestra cómo conectarse a Blob Storage, pero puede usar el mismo proceso para otros servicios de Azure compatibles.

Seleccione la barra de búsqueda Buscar recursos, servicios y documentos (G +/) en la parte superior de Azure Portal, escriba Container Apps en el filtro y seleccione Container Apps.
Seleccione el nombre del recurso de Container Apps que quiera conectar a un recurso de destino.
Seleccione Conector de servicio (versión preliminar) en la tabla de contenido de la izquierda. Seleccione Crear.

En la pestaña Aspectos básicos, seleccione o escriba la siguiente configuración.

Configuración	Ejemplo	Descripción
Contenedor	my-container-app	Contenedor de la aplicación contenedora.
Tipo de servicio	Storage - Blob	El tipo de servicio que desea conectar a la aplicación contenedora.
Suscripción	my-subscription	La suscripción que contiene el servicio al que desea conectarse. El valor predeterminado es la suscripción que contiene esta aplicación contenedora.
Nombre de la conexión	storageblob_700ae	El nombre de conexión que identifica la conexión entre su aplicación contenedora y el servicio de destino. Use el nombre de conexión proporcionado por Service Connector o elija su propio nombre de conexión.
Cuenta de almacenamiento	my-storage-account	La cuenta de almacenamiento de destino a la que desea conectarse. Si elige otro tipo de servicio, seleccione la instancia del servicio de destino correspondiente.
Tipo de cliente	.NET	La pila de aplicación que funciona con el servicio de destino que ha seleccionado. El valor predeterminado es Ninguno, que genera una lista de configuraciones. Si conoce la pila de aplicaciones o el SDK de cliente en su selección, seleccione la misma pila de aplicaciones para el tipo de cliente.

Seleccione Siguiente: Autenticación para elegir un método de autenticación: identidad administrada asignada por el sistema (SMI), identidad administrada asignada por el usuario (UMI), cadena de conexión o entidad de servicio.
Seleccione Identidad administrada asignada por el sistema para conectarse a través de una identidad generada automáticamente en Microsoft Entra ID y vinculada al ciclo de vida de la instancia de servicio. Esta es la opción de autenticación recomendada.
Seleccione Identidad administrada asignada por el usuario para autenticarse a través de una identidad independiente asignada a una o varias instancias de un servicio de Azure. Seleccione una suscripción que contenga una identidad administrada asignada por el usuario y, a continuación, seleccione la identidad.

Si aún no tiene una identidad administrada asignada por el usuario, cree una:
1. Abra la plataforma de Azure en una nueva pestaña y busque Identidades administradas.
2. Seleccione Identidades administradas y seleccione Crear.
3. Escriba una suscripción, un grupo de recursos, una región y un nombre de instancia.
4. Seleccione Revisar y crear y, a continuación, Crear
5. Una vez implementada la identidad administrada, vuelva a la pestaña Service Connector, seleccione Anterior y, a continuación, Siguiente para actualizar los datos del formulario. En Identidad administrada asignada por el usuario, seleccione la identidad que creó.
Para más información, consulte crear una identidad administrada asignada por el usuario.
1. Seleccione Entidad de servicio para usar una entidad de servicio que defina la directiva de acceso y los permisos para el usuario o la aplicación en Microsoft Entra ID.
2. Seleccione una entidad de servicio de la lista e introduzca un secreto
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.

Seleccione Cadena de conexión para generar o configurar uno o varios pares clave-valor con secretos puros o tokens.
Seleccione Siguiente: Redes para seleccionar la configuración de red y seleccione Configurar reglas de firewall para habilitar el acceso al servicio de destino para que la aplicación contenedora pueda acceder a Blob Storage.
Seleccione Siguiente: Revisar y crear para revisar la información proporcionada. La ejecución de la validación final tarda unos segundos.
Seleccione Crear para crear la conexión de servicio. La operación puede tardar hasta un minuto en completarse.

Identidad administrada (recomendada)
Cadena de conexión

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. Puede ejecutar este comando de dos maneras diferentes:

Genere la nueva conexión paso a paso.

az containerapp connection create storage-blob --system-identity

Genere la nueva conexión a la vez. Reemplace los marcadores de posición por su propia información: <source-subscription>, <source_resource_group>, <app>, <target-subscription>, <target_resource_group> y <account>.

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Sugerencia

Si no tiene una cuenta de Blob Storage, ejecute az containerapp connection create storage-blob --new --system-identity para crear una y conectarla a la aplicación contenedora mediante una identidad administrada.

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.

Ejecute el comando az containerapp connection create para crear una conexión de servicio desde Container Apps a Blob Storage con una cadena de conexión. Puede ejecutar este comando de dos maneras diferentes:

Genere la nueva conexión paso a paso.

az containerapp connection create storage-blob --secret

Genere la nueva conexión a la vez. Reemplace los marcadores de posición por su propia información: <source-subscription>, <source_resource_group>, <app><target-subscription>, <target_resource_group>, <account>, <secret-name> y <secret>.

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --secret name=<secret-name> secret=<secret>

Sugerencia

Si no tiene una cuenta de Blob Storage, ejecute az containerapp connection create storage-blob --new --secret para crear una y conectarla a la aplicación contenedora mediante una identidad administrada.

Ver conexiones de servicio

Las conexiones de Container Apps se muestran en Configuración > Conector de servicio (versión preliminar). Seleccione > para expandir la lista y ver las propiedades requeridas por su aplicación.
Seleccione la conexión y, a continuación, elija Validar para preguntar al conector de servicio y comprobar la conexión.
Seleccione Más información para revisar los detalles de validación de conexión.

Ejecute el comando az containerapp connection list 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 siguiente por su propia información. También puede quitar la opción --output table para consultar más información sobre las conexiones.

az containerapp connection list --resource-group "<container-app-resource-group>" --name "<container-app-name>" --output table

La salida también muestra el estado de aprovisionamiento de las conexiones.

Consulte las siguientes guías para obtener más información sobre Service Connector:

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-09-19