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

아티클
10/16/2024

이 빠른 시작에서는 Azure CLI 및 서비스 커넥터를 사용하여 Azure Container Apps를 다른 클라우드 리소스에 연결하는 방법을 보여 줍니다. 서비스 커넥터를 사용하면 연결의 인증 및 네트워킹 설정을 관리하면서 컴퓨팅 서비스를 클라우드 서비스에 신속하게 연결할 수 있습니다.

Important

Container Apps의 서비스 커넥터는 현재 미리 보기로 제공됩니다. 베타, 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 약관은 Microsoft Azure 미리 보기에 대한 추가 사용 약관을 참조하세요.

필수 구성 요소

Azure 구독 Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
서비스 커넥터에서 지원하는 지역의 Container Apps에 배포된 하나 이상의 애플리케이션입니다. 없는 경우 컨테이너를 만들고 Container 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을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
Container Apps 확장은 Azure CLI 또는 Cloud Shell을 설치해야 합니다. 설치하려면 az extension add --name containerapp를 실행합니다.

초기 설정

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

az provider show -n "Microsoft.ServiceLinker" --query registrationState 명령을 실행하여 리소스 공급자가 이미 등록되었는지 확인할 수 있습니다. 출력이 Registered인 경우 서비스 커넥터가 등록되어 있습니다.
필요에 따라 az containerapp connection list-support-types 명령을 실행하여 Container Apps에 대해 지원되는 대상 서비스 목록을 가져옵니다.
```
az containerapp connection list-support-types --output table
```

서비스 연결 만들기

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

관리 ID
액세스 키

Important

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

az containerapp connection create 명령을 실행하여 시스템이 할당한 관리 ID로 Container Apps에서Blob Storage로 서비스 연결을 만듭니다.
```
az containerapp connection create storage-blob --system-identity
```

Azure CLI의 요청에 다음 정보를 제공합니다.

설정	설명
`The resource group that contains the container app`	리소스 그룹의 이름을 컨테이너 앱으로 바꿉니다.
`Name of the container app`	컨테이너 앱의 이름입니다.
`The container where the connection information will be saved`	컨테이너 앱 컨테이너의 이름입니다.
`The resource group which contains the storage account`	스토리지 계정이 있는 리소스 그룹의 이름입니다.
`Name of the storage account`	연결하려는 스토리지 계정의 이름입니다. 이 가이드에서는 Blob Storage를 사용합니다.

참고 항목

Blob Storage가 없는 경우 az containerapp connection create storage-blob --new --system-identity를 실행하여 새 Blob Storage를 프로비전하고 관리 ID를 사용하여 컨테이너 앱에 직접 연결할 수 있습니다.

Warning

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

az containerapp connection create 명령을 실행하여 액세스 키를 통해 Container Apps와 zure Blob Storage 간에 서비스 연결을 만듭니다.
```
az containerapp connection create storage-blob --secret
```

Azure CLI의 요청에 다음 정보를 제공합니다.

설정	설명
`The resource group that contains the container app`	리소스 그룹의 이름을 컨테이너 앱으로 바꿉니다.
`Name of the container app`	컨테이너 앱의 이름입니다.
`The container where the connection information will be saved`	컨테이너 앱 컨테이너의 이름입니다.
`The resource group which contains the storage account`	스토리지 계정이 있는 리소스 그룹의 이름입니다.
`Name of the storage account`	연결하려는 스토리지 계정의 이름입니다. 이 가이드에서는 Blob Storage를 사용합니다.

팁

Blob Storage가 없는 경우 az containerapp connection create storage-blob --new --secret를 실행하여 새 Blob Storage를 프로비전하고 연결 문자열을 사용하여 컨테이너 앱에 직접 연결할 수 있습니다.

연결 보기

Azure CLI 명령 az containerapp connection list를 사용하여 모든 컨테이너 앱의 프로비전된 연결을 나열합니다. 아래 명령에서 <container-app-resource-group> 및 <container-app-name> 자리 표시자를 컨테이너 앱의 리소스 그룹 및 이름으로 바꿉니다. 연결에 대한 자세한 정보를 볼 수 있는 --output table 옵션을 제거할 수도 있습니다.

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

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

다음 단계

서비스 커넥터 내부

다음을 통해 공유