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

이 빠른 시작에서는 Azure CLI를 사용하여 Azure App Service에서 서비스 연결을 만드는 단계를 설명합니다.

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

필수 조건

• 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.30.0 이상이 필요합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
• 이 빠른 시작에서는 적어도 Azure에서 이미 실행 중인 App Service가 있다고 가정합니다. App Service가 없는 경우 새로 만듭니다.

초기 설정

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

   az provider register -n Microsoft.ServiceLinker
   

   팁

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

2. 필요에 따라 Azure CLI az webapp connection list 명령을 사용하여 App Service에 지원되는 대상 서비스 목록을 가져옵니다.

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

서비스 연결 만들기

관리 ID 사용

Important

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

Azure CLI az webapp connection 명령을 사용해 Blob Storage에 대한 서비스 연결과 시스템이 할당한 관리 ID를 만들고 다음 정보를 제공할 수 있습니다.

• App Service가 포함된 리소스 그룹의 이름
• App Service 이름
• 스토리지 계정이 포함된 리소스 그룹의 이름
• 스토리지 계정의 이름

az webapp connection create storage-blob

참고 항목

Blob Storage가 없는 경우 az webapp connection create storage-blob --new --system-identity를 실행하여 새 Blob Storage 리소스를 프로비전하고 App Service 인스턴스에 직접 연결할 수 있습니다.

액세스 키 사용

Warning

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

Azure CLI az webapp connection create 명령을 사용하여 Azure Blob Storage에 대한 서비스 연결과 액세스 키를 만들고 다음 정보를 제공합니다.

• 원본 컴퓨팅 서비스 리소스 그룹 이름: App Service의 리소스 그룹 이름입니다.
• App Service 이름: 대상 서비스에 연결하는 App Service의 이름입니다.
• 대상 서비스 리소스 그룹 이름: Blob Storage의 리소스 그룹 이름입니다.
• 스토리지 계정 이름: Blob Storage의 계정 이름입니다.

az webapp connection create storage-blob --secret

팁

Blob Storage가 없는 경우 az webapp connection create storage-blob --new --secret를 실행해 새로운 스토리지를 프로비전해 App Service 리소스에 바로 연결할 수 있습니다.

연결 보기

Azure CLI az webapp connection 명령을 실행해 App Service에 대한 연결을 나열하고 다음 정보를 제공할 수 있습니다.

• App Service가 포함된 리소스 그룹의 이름
• App Service 이름

az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

다음 단계

아래 자습서에 따라 서비스 커넥터로 사용자만의 애플리케이션을 빌드할 수 있습니다.

자습서: WebApp + Azure CLI를 사용하는 스토리지

자습서: WebApp + Azure CLI를 사용하는 PostgreSQL