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

En este inicio rápido se muestra cómo conectar Azure Spring 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.

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 hospedada por Azure Spring Apps en una región compatible con Service Connector. Si no tiene ninguna, implemente la primera aplicación en Azure Spring 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.

• Versión 2.37.0 o superior 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.

• La extensión de Azure Spring Apps debe instalarse en la CLI de Azure o en Cloud Shell. Para instalarlo, ejecute az extension add --name spring.

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 spring connection list-support-types para obtener una lista de los servicios de destino admitidos por Azure Spring Apps.

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

   Sugerencia

   Si el sistema no reconoce el comando az spring, compruebe que ha instalado la extensión necesaria mediante la ejecución de az extension add --name spring.

Creación de una conexión de servicio

Crear una conexión desde Azure Spring Apps mediante una clave de acceso o una identidad administrada.

Clave de acceso

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

   az spring connection create storage-blob --secret
   

2. Proporcione la siguiente información en la CLI o en la solicitud de Cloud Shell:

   Configuración	Descripción
   The resource group which contains the spring-cloud	Nombre del grupo de recursos que contiene la aplicación hospedada por Azure Spring Apps.
   Name of the spring-cloud service	Nombre del recurso de Azure Spring Apps.
   Name of the spring-cloud app	Nombre de la aplicación hospedada por Azure Spring Apps que se conecta al servicio de destino.
   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 spring connection create storage-blob --new --secret para disponer de uno nuevo y conectarlo directamente a la aplicación hospedada por Azure Spring Apps mediante una cadena de conexión.

Identidad administrada

Importante

Para usar una identidad administrada, debe tener permiso para modificar las asignaciones de roles de Microsoft Entra ID. 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 un permiso de asignación de roles o usar una clave de acceso para crear la conexión.

1. Ejecute el comando az spring connection create para crear una conexión de servicio a Blob Storage con una identidad administrada asignada por el sistema.

2. Proporcione la siguiente información en la CLI o en la solicitud de Cloud Shell:

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

   Configuración	Descripción
   The resource group which contains the spring-cloud	Nombre del grupo de recursos que contiene una aplicación hospedada por Azure Spring Apps.
   Name of the spring-cloud service	Nombre del recurso de Azure Spring Apps.
   Name of the spring-cloud app	Nombre de la aplicación hospedada por Azure Spring Apps que se conecta al servicio de destino.
   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 spring connection create storage-blob --new --system-identity para disponer de uno nuevo y conectarlo directamente a la aplicación hospedada por Azure Spring Apps mediante una identidad administrada.

Ver conexiones

Ejecute el comando az spring connection list para enumerar todas las conexiones aprovisionadas de Azure Spring Apps.

Reemplace los marcadores de posición <azure-spring-apps-resource-group>, <azure-spring-apps-name> y <app-name> del comando siguiente por el nombre del grupo de recursos de Azure Spring Apps, el nombre del recurso de Azure Spring Apps y el nombre de la aplicación. También puede quitar la opción --output table para consultar más información sobre las conexiones.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

La salida también muestra el estado de aprovisionamiento de las conexiones: error o correcto.

Pasos siguientes

Consulte las guías siguientes para obtener más información sobre Service Connector y Azure Spring Apps.

Tutorial: Azure Spring Apps y MySQL

Tutorial: Azure Spring Apps y Apache Kafka en la nube de Confluent