빠른 시작: Azure CLI를 사용하여 Azure Spring Apps에서 서비스 연결 만들기

이 빠른 시작에서는 Azure CLI 및 서비스 커넥터를 사용하여 Azure Spring Apps를 다른 클라우드 리소스에 연결하는 방법을 보여 줍니다.

서비스 커넥터를 사용하면 연결의 인증 및 네트워킹 설정을 관리하면서 컴퓨팅 서비스를 클라우드 서비스에 신속하게 연결할 수 있습니다.

필수 구성 요소

• Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

• 서비스 커넥터에서 지원하는 지역에 Azure Spring Apps에서 호스트하는 애플리케이션이 하나 이상 있습니다. 애플리케이션이 없는 경우 Azure Spring Apps에 첫 번째 애플리케이션을 배포합니다.

• Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.

  

• CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.

  • 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.

  • 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.

  • az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

• Azure CLI 버전 2.37.0 이상. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.

• Azure Spring Apps 확장은 Azure CLI 또는 Cloud Shell을 설치해야 합니다. 설치하려면 az extension add --name spring를 실행합니다.

초기 설정

1. Service Connector를 처음 사용하는 경우 먼저 az provider register 명령을 실행하여 Service Connector 리소스 공급자를 등록합니다.

   az provider register -n Microsoft.ServiceLinker
   

   팁

   az provider show -n "Microsoft.ServiceLinker" --query registrationState 명령을 실행하여 리소스 공급자가 이미 등록되었는지 확인할 수 있습니다. 출력이 Registered인 경우 서비스 커넥터가 등록되어 있습니다.

2. 필요에 따라 az spring connection list-support-types 명령을 실행하여 Azure Spring Apps에 지원되는 대상 서비스 목록을 가져옵니다.

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

   팁

   시스템에서 az spring 명령을 인식하지 못하는 경우 az extension add --name spring을 실행하여 필요한 확장을 설치했는지 확인합니다.

서비스 연결 만들기

관리 ID 또는 액세스 키를 사용하여 Azure Spring Apps에서 연결을 만듭니다.

관리 ID

Important

관리 ID를 사용하려면 Microsoft Entra ID에서 역할 할당을 수정할 수 있는 권한이 있어야 합니다. 관련 권한이 없으면 연결을 만들 수 없습니다. 구독 소유자에게 역할 할당 권한을 부여하거나 액세스 키를 사용하여 연결을 만들도록 요청합니다.

1. az spring connection create 명령을 실행하여 시스템이 할당한 관리 ID로 Blob Storage에 대한 서비스 연결을 만듭니다.

2. CLI 또는 Cloud Shell 요청 시 다음 정보를 제공합니다.

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

   설정	설명
   The resource group which contains the spring-cloud	Azure Spring Apps에서 호스트하는 앱을 포함하는 리소스 그룹의 이름입니다.
   Name of the spring-cloud service	Azure Spring Apps 리소스의 이름입니다.
   Name of the spring-cloud app	대상 서비스에 연결하는 Azure Spring Apps에서 호스트하는 애플리케이션의 이름입니다.
   The resource group which contains the storage account	스토리지 계정이 있는 리소스 그룹의 이름입니다.
   Name of the storage account	연결하려는 스토리지 계정의 이름입니다. 이 가이드에서는 Blob Storage를 사용합니다.

팁

Blob Storage가 없는 경우 az spring connection create storage-blob --new --system-identity를 실행하여 새 Blob Storage를 프로비전하고 관리 ID를 사용하여 Azure Spring Apps에서 호스트하는 애플리케이션에 직접 연결할 수 있습니다.

액세스 키

Warning

사용 가능한 가장 안전한 인증 흐름을 사용하는 것이 권장됩니다. 이 절차에서 설명된 인증 흐름은 다른 흐름에는 없는 위험을 전달하며, 애플리케이션에서 매우 높은 신뢰 수준을 요구합니다. 이 흐름은 관리 ID와 같은 보다 안전한 다른 흐름을 실행할 수 없는 경우에만 사용되어야 합니다.

1. az spring connection create 명령을 실행하여 Azure Spring Apps와 액세스 키를 사용하는 Azure Blob Storage 간에 서비스 연결을 만듭니다.

   az spring connection create storage-blob --secret
   

2. CLI 또는 Cloud Shell 요청 시 다음 정보를 제공합니다.

   설정	설명
   The resource group which contains the spring-cloud	Azure Spring Apps에서 호스트하는 앱을 포함하는 리소스 그룹의 이름입니다.
   Name of the spring-cloud service	Azure Spring Apps 리소스의 이름입니다.
   Name of the spring-cloud app	대상 서비스에 연결하는 Azure Spring Apps에서 호스트하는 애플리케이션의 이름입니다.
   The resource group which contains the storage account	스토리지 계정이 있는 리소스 그룹의 이름입니다.
   Name of the storage account	연결하려는 스토리지 계정의 이름입니다. 이 가이드에서는 Blob Storage를 사용합니다.

팁

Blob Storage가 없는 경우 az spring connection create storage-blob --new --secret를 실행하여 새 Blob Storage를 프로비전하고 연결 문자열을 사용하여 Azure Spring Apps에서 호스트하는 애플리케이션에 직접 연결할 수 있습니다.

연결 보기

az spring connection list 명령을 실행하여 Azure Spring Apps의 프로비전된 모든 연결을 나열합니다.

아래 명령에서 <azure-spring-apps-resource-group>, <azure-spring-apps-name>, <app-name> 자리 표시자를 Azure Spring Apps 리소스 그룹의 이름, Azure Spring Apps 리소스 이름, 애플리케이션 이름으로 바꿉니다. 연결에 대한 자세한 정보를 볼 수 있는 --output table 옵션을 제거할 수도 있습니다.

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

출력에는 연결의 프로비전 상태(실패 또는 성공)도 표시됩니다.

다음 단계

서비스 커넥터 및 Azure Spring Apps에 대한 자세한 내용은 아래 가이드를 확인하세요.

자습서: Azure Spring 앱 + MySQL

자습서: Confluent Cloud의 Azure Spring 앱 + Apache Kafka