빠른 시작: 로컬 소스 코드에서 Azure Container Apps로 빌드 및 배포
이 문서에서는 선택한 프로그래밍 언어를 사용하여 로컬 소스 코드에서 마이크로 서비스를 빌드하고 Azure Container Apps에 배포하는 방법을 보여 줍니다. 이 빠른 시작에서는 음악 앨범의 정적 컬렉션을 반환하는 백 엔드 웹 API 서비스를 만듭니다.
다음 스크린샷은 배포하는 앨범 API 서비스의 출력을 보여 줍니다.
필수 조건
이 프로젝트를 완료하려면 다음 항목이 필요합니다.
| 요건 | 지침 |
|---|---|
| Azure 계정 | 계정이 없으면 무료 계정을 만듭니다. 계속 진행하려면 Azure 구독에 대한 기여자 또는 소유자 권한이 필요합니다. 자세한 내용은 Azure Portal을 사용하여 Azure 역할 할당을 참조하세요. |
| Git | Git를 설치합니다. |
| Azure CLI | Azure CLI를 설치합니다. |
설정
CLI에서 Azure에 로그인하려면 다음 명령을 실행하고 프롬프트에 따라 인증 프로세스를 완료합니다.
az login
최신 버전의 CLI를 실행하고 있는지 확인하려면 업그레이드 명령을 실행합니다.
az upgrade
그런 다음 CLI용 Azure Container Apps 확장을 설치하거나 업데이트합니다.
az extension add --name containerapp --upgrade --allow-preview true
이제 현재 확장이 설치되었으므로 네임스페이스와 네임스페이 Microsoft.App Microsoft.OperationalInsights 스를 등록합니다.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
환경 변수 만들기
CLI 설정이 완료되었으므로 이 문서 전체에서 사용되는 환경 변수를 정의할 수 있습니다. CLI 설정이 완료되었으므로 이 문서 전체에서 사용되는 환경 변수를 정의할 수 있습니다.
bash 셸에서 다음 변수를 정의합니다.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
샘플 코드 가져오기
다음 명령을 실행하여 선택한 언어로 샘플 애플리케이션을 복제하고 프로젝트 원본 폴더로 변경합니다.
git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src
컨테이너 앱 빌드 및 배포
먼저 다음 명령을 실행하여 이 빠른 시작에서 만든 리소스를 포함하는 리소스 그룹을 만듭니다.
az group create --name $RESOURCE_GROUP --location $LOCATION
containerapp up 명령을 사용하여 첫 번째 컨테이너 앱을 빌드하고 배포합니다. 이 명령은 다음을 수행합니다.
- 리소스 그룹 만들기
- Azure Container Registry 만들기
- 컨테이너 이미지를 빌드하고 레지스트리에 푸시합니다.
- Log Analytics 작업 영역을 사용하여 Container Apps 환경 만들기
- 빌드된 컨테이너 이미지를 사용하여 컨테이너 앱 만들기 및 배포
이 up 명령은 프로젝트 폴더의 Dockerfile을 사용하여 컨테이너 이미지를 빌드합니다. EXPOSE Dockerfile의 명령은 컨테이너에 수신 트래픽을 보내는 데 사용되는 포트인 대상 포트를 정의합니다.
다음 코드 예제 . 에서 (점)은 Dockerfile도 포함하는 프로젝트의 현재 디렉터리에서 실행하도록 지시 containerapp up 합니다.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
참고 항목
명령이 "AADSTS50158: 외부 보안 챌린지가 충족되지 않음"이라는 메시지와 함께 오류를 반환하는 경우 필요한 az login --scope https://graph.microsoft.com//.default 권한으로 로그인한 다음 명령을 다시 실행 az containerapp up 합니다.
배포 확인
명령의 출력에서 컨테이너 앱의 URL을 찾습니다 az containerapp up . 브라우저에서 URL로 이동합니다. URL의 끝에 추가하여 /albums API의 응답을 확인합니다.
제한
소스 코드 업로드의 최대 크기는 200MB입니다. 업로드가 한도를 초과하면 오류 413이 반환됩니다.
리소스 정리
프런트 엔드 배포 자습서를 계속 진행하지 않으려면 다음 명령을 사용하여 이 빠른 시작 중에 만들어진 Azure 리소스를 제거할 수 있습니다.
주의
다음 명령은 지정된 리소스 그룹과 그 안에 포함된 모든 리소스를 삭제합니다. 그룹에 이 빠른 시작의 범위를 벗어나는 리소스가 포함되어 있으면 해당 리소스도 삭제됩니다.
az group delete --name $RESOURCE_GROUP
팁
문제가 있나요? Azure Container Apps 리포지토리에서 문제를 열어 GitHub에 알려주세요.
다음 단계
이 빠른 시작을 완료한 후 자습서: Azure Container Apps에서 마이크로 서비스 간 통신으로 계속 진행하여 API를 호출하는 프런트 엔드 애플리케이션을 배포하는 방법을 알아볼 수 있습니다.