Azure에서 사용자 지정 컨테이너 실행

Azure App Service on Linux는 .NET, PHP, Node.js 등과 같은 언어 지원을 통해 Linux에서 미리 정의된 애플리케이션 스택을 제공합니다. 사용자 지정 Docker 이미지를 사용하여 Azure에 아직 정의되지 않은 애플리케이션 스택에서 웹앱을 실행할 수도 있습니다. 이 빠른 시작에서는 ACR(Azure Container Registry)에서 App Service로 이미지를 배포하는 방법을 보여 줍니다.

참고 항목

서버리스 환경에서 컨테이너화된 애플리케이션을 실행하는 방법에 대한 자세한 내용은 Container Apps를 참조하세요.

이 빠른 시작을 완료하려면 다음이 필요합니다.

Azure 계정
Docker
Visual Studio Code
VS Code용 Azure App Service 확장. 이 확장을 사용하여 Azure PaaS(Platform as a Service)에서 Linux Web Apps를 만들고, 관리하고, 배포할 수 있습니다.
VS Code용 Docker 확장. 이 확장을 사용하여 로컬 Docker 이미지 및 명령 관리를 간소화하고 빌드된 앱 이미지를 Azure에 배포할 수 있습니다.

1 - 컨테이너 레지스트리 만들기

이 빠른 시작에서는 Azure Container Registry를 선택한 레지스트리로 사용합니다. 다른 레지스트리도 자유롭게 사용할 수 있지만 단계는 약간 다를 수 있습니다.

빠른 시작: Azure Portal을 사용하여 프라이빗 컨테이너 레지스트리 만들기의 지침에 따라 컨테이너 레지스트리를 만듭니다.

Important

Azure 컨테이너 레지스트리를 만들 때 관리 사용자 옵션을 사용으로 설정해야 합니다. Azure Portal 레지스트리 페이지의 액세스 키 섹션에서 설정할 수도 있습니다. 이 설정은 App Service 액세스에 필요합니다. 관리 ID에 대한 내용은 ACR에서 배포 자습서를 참조하세요.

Visual Studio Code를 시작합니다.
작업 표시줄에서 Azure 로고를 선택하고 APP SERVICE 탐색기로 이동한 다음, Azure에 로그인을 선택하고 지침을 따릅니다.
아래쪽의 상태 표시줄에서 Azure 계정 메일 주소를 확인합니다. APP SERVICE 탐색기에 사용자의 구독이 표시되어야 합니다.
작업 표시줄에서 Docker 로고를 선택합니다. REGISTRIES 탐색기에서 만든 컨테이너 레지스트리가 나타나는지 확인합니다.

3 - 필수 구성 요소 확인

Docker가 설치되어 실행 중인지 확인합니다. 다음 명령은 실행 중인 경우 Docker 버전을 표시합니다.

docker --version

4 - 이미지 만들기 및 빌드

Visual Studio Code에서 빈 폴더를 열고 Dockerfile이라는 파일을 추가합니다. Dockerfile에서 원하는 언어 프레임워크를 기준으로 콘텐츠를 붙여넣습니다.

FROM mcr.microsoft.com/appsvc/dotnetcore:lts

ENV PORT 8080
EXPOSE 8080

ENV ASPNETCORE_URLS "http://*:${PORT}"

ENTRYPOINT ["dotnet", "/defaulthome/hostingstart/hostingstart.dll"]

이 Dockerfile에서 부모 이미지는 App Service의 기본 제공 .NET 컨테이너 중 하나입니다. 이에 대한 원본 파일은 GenerateDockerFiles/dotnetcore 아래에 있는 Azure-App-Service/ImageBuilder GitHub 리포지토리에서 찾을 수 있습니다. 해당 Dockerfile은 간단한 .NET 앱을 /defaulthome/hostingstart로 복사합니다. Dockerfile은 간단히 해당 앱을 시작합니다.

FROM mcr.microsoft.com/appsvc/node:10-lts

ENV HOST 0.0.0.0
ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["pm2", "start", "--no-daemon", "/opt/startup/default-static-site.js"]

이 Dockerfile에서 부모 이미지는 App Service의 기본 제공 Node.js 컨테이너 중 하나입니다. 이에 대한 원본 파일은 GenerateDockerFiles/node/node-template 아래에 있는 Azure-App-Service/ImageBuilder GitHub 리포지토리에서 찾을 수 있습니다. 해당 Dockerfile은 간단한 Node.js 앱을 /opt/startup으로 복사합니다. Dockerfile은 부모 이미지에 이미 설치되어 있는 PM2를 사용하여 간단히 해당 앱을 시작합니다.

FROM mcr.microsoft.com/appsvc/python:latest

ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["gunicorn", "--timeout", "600", "--access-logfile", "'-'", "--error-logfile", "'-'", "--chdir=/opt/defaultsite", "application:app"]

이 Dockerfile에서 부모 이미지는 App Service의 기본 제공 Python 컨테이너 중 하나입니다. 이에 대한 원본 파일은 GenerateDockerFiles/python/template-3.9 아래에 있는 Azure-App-Service/ImageBuilder GitHub 리포지토리에서 찾을 수 있습니다. 해당 Dockerfile은 간단한 Python 앱을 /opt/defaultsite로 복사합니다. Dockerfile은 부모 이미지에 이미 설치되어 있는 Gunicorn을 사용하여 간단히 해당 앱을 시작합니다.

FROM mcr.microsoft.com/azure-app-service/java:11-java11_stable

ENV PORT 80
EXPOSE 80

ENTRYPOINT ["java", "-Dserver.port=80", "-jar", "/tmp/appservice/parkingpage.jar"]

이 Dockerfile에서 부모 이미지는 App Service의 기본 제공 Java 컨테이너 중 하나입니다. 이에 대한 소스 파일은 java/tree/dev/java11-alpine의 Azure-App-Service/java GitHub 리포지토리에서 찾을 수 있습니다. 해당 Dockerfile은 간단한 Java 앱을 /tmp/appservice로 복사합니다. Dockerfile은 간단히 해당 앱을 시작합니다.

명령 팔레트를 열고Docker Images: Build Image를 입력합니다. Enter를 입력하여 명령을 실행합니다.
이미지 태그 상자에서 원하는 태그를 <acr-name>.azurecr.io/<image-name>/<tag> 형식으로 지정합니다. 여기서 <acr-name>은 사용자가 만든 컨테이너 레지스트리의 이름입니다. Enter 키를 누릅니다.
이미지 빌드가 완료되면 IMAGES 탐색기 위쪽에서 새로 고침을 클릭하여 이미지가 성공적으로 빌드되었는지 확인합니다.

5 - 컨테이너 레지스트리에 배포

작업 표시줄에서 Docker 아이콘을 클릭합니다. IMAGES 탐색기에서 빌드한 이미지를 찾습니다.
이미지를 확장하고, 원하는 태그를 마우스 오른쪽 단추로 클릭한 후, 푸시를 클릭합니다.
이미지 태그가 <acr-name>.azurecr.io로 시작하는지 확인하고 Enter 키를 누릅니다.
Visual Studio Code가 컨테이너 레지스트리에 이미지를 푸시하는 작업을 완료하면 REGISTRIES 탐색기의 맨 위에 있는 새로 고침을 클릭하여 이미지가 성공적으로 푸시되었는지 확인합니다.

6 - App Service에 배포

REGISTRIES 탐색기에서 이미지를 확장하고 태그를 마우스 오른쪽 단추로 클릭한 다음 Azure App Service에 이미지 배포를 선택합니다.
표시되는 메시지에 따라 구독, 전역적으로 고유한 앱 이름, 리소스 그룹 및 App Service 요금제를 선택합니다. 가격 책정 계층으로 B1 기본을 선택하고 가까운 지역을 선택합니다.

배포 후에는 http://<app-name>.azurewebsites.net에서 앱을 사용할 수 있습니다.

리소스 그룹은 Azure에 있는 모든 애플리케이션 리소스의 명명된 컬렉션입니다. 예를 들어 리소스 그룹에는 웹 사이트, 데이터베이스 및 Azure 함수에 대한 참조가 포함될 수 있습니다.

App Service 계획은 웹 사이트를 호스트하는 데 사용되는 물리적 리소스를 정의합니다. 이 빠른 시작에서는 Linux 인프라의 기본 호스팅 계획을 사용하므로, 사이트가 다른 웹 사이트와 함께 Linux 머신에 호스트됩니다. 기본 계획으로 시작하는 경우, Azure Portal을 사용하여 해당 웹 사이트만 머신에서만 실행되도록 강화할 수 있습니다. 가격 책정에 대해서는 App Service 가격을 참조하세요.

7 - 웹 사이트 찾아보기

출력 패널에 배포 작업의 상태가 표시됩니다. 작업이 완료되면 팝업 알림에서 사이트 열기를 선택하여 브라우저에서 사이트를 엽니다.

문제가 발생했습니다.

8 - 리소스 정리

Azure Portal 메뉴 또는 홈 페이지에서 리소스 그룹을 선택합니다. 그런 다음, 리소스 그룹 페이지에서 myResourceGroup을 선택합니다.

myResourceGroup 페이지에서 나열된 리소스가 삭제하려는 리소스인지 확인합니다.

리소스 그룹 삭제를 선택하고, 텍스트 상자에서 myResourceGroup을 입력하여 확인한 다음, 삭제를 선택합니다.

다음 단계

축하합니다. 이 빠른 시작을 성공적으로 완료하셨습니다.

App Service 앱은 시작할 때마다 컨테이너 레지스트리에서 이미지를 가져옵니다. 이미지를 다시 빌드하는 경우 컨테이너 레지스트리에 푸시하기만 하면 앱이 다시 시작될 때 업데이트된 이미지를 가져옵니다. 업데이트된 이미지를 즉시 가져오도록 앱에 지시하려면 다시 시작합니다.

다른 Azure 확장:

Azure Cosmos DB
Azure Functions
Azure CLI 도구
Azure Resource Manager 도구
Azure 도구 확장 팩에는 위의 확장이 모두 포함되어 있습니다.

Azure App Service on Linux는 .NET, PHP, Node.js 등과 같은 언어 지원을 통해 Linux에서 미리 정의된 애플리케이션 스택을 제공합니다. 사용자 지정 Docker 이미지를 사용하여 Azure에 아직 정의되지 않은 애플리케이션 스택에서 웹앱을 실행할 수도 있습니다. 이 빠른 시작에서는 이미지를 Azure Container Registry에서 Azure App Service로 배포하는 방법을 보여 줍니다.

참고 항목

서버리스 환경에서 컨테이너화된 애플리케이션을 실행하는 방법에 대한 자세한 내용은 Container Apps를 참조하세요.

이 빠른 시작을 완료하려면 다음이 필요합니다.

1 - 샘플 리포지토리 복제

다음 명령을 사용하여 .NET 6.0 샘플 앱을 복제합니다.

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - Azure Container Registry에 이미지 푸시

복제된 리포지토리의 루트 폴더에 있는지 확인합니다. 이 리포지토리에는 Dockerfile.linux 파일이 포함되어 있습니다.

Azure CLI에 로그인합니다.
```
az login
```
Azure Container Registry에 로그인합니다.
```
az acr login -n <your_registry_name>
```
컨테이너 이미지를 빌드합니다. 이미지 이름을 dotnetcore-docs-hello-world-linux로 지정합니다.
```
docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux . 
```
컨테이너 이미지를 Azure Container Registry에 푸시합니다.
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
```
참고 항목

Dockerfile은 내부적으로 포트 번호를 80으로 설정합니다. 컨테이너를 구성하는 방법에 대한 자세한 내용은 사용자 지정 컨테이너 구성을 참조하세요.

3 - Azure에 배포

Azure Portal에 로그인합니다.

Azure 리소스 만들기

검색에 앱 서비스를 입력합니다. 서비스 아래에서 App Services를 선택합니다.
App Services 페이지에서 + 만들기를 선택합니다.
기본 탭의 프로젝트 세부 정보 아래에서 올바른 구독이 선택되어 있는지 확인한 다음, 새 리소스 그룹 만들기를 선택합니다. 이름으로 myResourceGroup을 입력합니다.
인스턴스 세부 정보 아래에서 전역적으로 고유한 웹앱 이름을 입력하고, Docker 컨테이너를 선택합니다. 운영 체제에 대해 Linux를 선택합니다. 앱을 제공하려는 지역을 선택합니다.
App Service 요금제에서 새 App Service 요금제 만들기를 선택합니다. 이름으로 myAppServicePlan을 입력합니다. 무료 계층으로 변경하려면 크기 변경, 개발/테스트 탭, F1을 차례로 선택하고, 페이지 아래쪽에서 적용 단추를 선택합니다.
페이지 아래쪽에서 다음: Docker > 단추를 선택합니다.
Docker 탭의 옵션 아래에서 단일 컨테이너를 선택하고, 이미지 원본에 대해 Azure Container Registry를 선택합니다. Azure Container Registry 옵션 아래에서 다음 값을 설정합니다.
- 레지스트리: Azure Container Registry를 선택합니다.
- 이미지: dotnetcore-docs-hello-world-linux를 선택합니다.
- 태그: latest를 선택합니다.
페이지 아래쪽에서 검토 + 만들기 단추를 선택합니다.
유효성 검사를 실행한 후 페이지 아래쪽에서 생성하기 단추를 선택합니다.
배포가 완료되면 리소스로 이동을 선택합니다.

4 - 앱으로 이동

웹 브라우저에서 배포된 애플리케이션(URL: http://<app-name>.azurewebsites.net)으로 이동합니다.

배포된 애플리케이션 스크린샷

5 - 리소스 정리

Azure Portal 메뉴 또는 홈 페이지에서 리소스 그룹을 선택합니다. 그런 다음, 리소스 그룹 페이지에서 myResourceGroup을 선택합니다.

myResourceGroup 페이지에서 나열된 리소스가 삭제하려는 리소스인지 확인합니다.

리소스 그룹 삭제를 선택하고, 텍스트 상자에서 myResourceGroup을 입력하여 확인한 다음, 삭제를 선택합니다.

다음 단계

축하합니다. 이 빠른 시작을 성공적으로 완료하셨습니다.

이 빠른 시작에서는 Windows 이미지의 ASP.NET 앱을 Azure Container Registry에서 Azure App Service로 배포하는 방법을 보여 줍니다.

이 빠른 시작을 완료하려면 다음이 필요합니다.

1 - 샘플 리포지토리 복제

다음 명령을 사용하여 .NET 6.0 샘플 앱을 복제합니다.

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - Azure Container Registry에 이미지 푸시

복제된 리포지토리의 루트 폴더에 있는지 확인합니다. 이 리포지토리에는 Dockerfile.windows 파일이 포함되어 있습니다. Windows Nano Server LTSC(장기 서비스 채널) 2022를 기본 운영 체제로 사용하여 Windows 베이스를 명시적으로 호출합니다.

참고 항목

Windows 컨테이너인 경우에도 경로에서 여전히 슬래시를 사용해야 합니다. 자세한 내용은 Dockerfile 작성을 참조하세요.

Azure CLI에 로그인합니다.
```
az login
```
Azure Container Registry에 로그인합니다.
```
az acr login -n <your_registry_name>
```
컨테이너 이미지를 빌드합니다. 이미지 이름을 dotnetcore-docs-hello-world-windows로 지정합니다.
```
docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows . 
```
컨테이너 이미지를 Azure Container Registry에 푸시합니다.
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
```
참고 항목

Dockerfile은 내부적으로 포트 번호를 80으로 설정합니다. 컨테이너를 구성하는 방법에 대한 자세한 내용은 사용자 지정 컨테이너 구성을 참조하세요.

3 - Azure에 배포

Azure Portal에 로그인합니다.

Azure 리소스 만들기

검색에 앱 서비스를 입력합니다. 서비스 아래에서 App Services를 선택합니다.
App Services 페이지에서 + 만들기를 선택합니다.
기본 탭의 프로젝트 세부 정보 아래에서 올바른 구독이 선택되어 있는지 확인한 다음, 새 리소스 그룹 만들기를 선택합니다. 이름으로 myResourceGroup을 입력합니다.
인스턴스 세부 정보 아래에서 전역적으로 고유한 웹앱 이름을 입력하고, Docker 컨테이너를 선택합니다. 운영 체제에 대해 Windows를 선택합니다. 앱을 제공하려는 지역을 선택합니다.
App Service 요금제에서 새 App Service 요금제 만들기를 선택합니다. 이름으로 myAppServicePlan을 입력합니다. 무료 계층으로 변경하려면 크기 변경, 개발/테스트 탭, P1v3을 차례로 선택하고, 페이지 아래쪽에서 적용 단추를 선택합니다.
페이지 아래쪽에서 다음: Docker > 단추를 선택합니다.
Docker 탭에서 이미지 원본에 대해 Azure Container Registry를 선택합니다. Azure Container Registry 옵션 아래에서 다음 값을 설정합니다.
- 레지스트리: Azure Container Registry를 선택합니다.
- 이미지: dotnetcore-docs-hello-world-windows를 선택합니다.
- 태그: latest를 선택합니다.
페이지 아래쪽에서 검토 + 만들기 단추를 선택합니다.
유효성 검사를 실행한 후 페이지 아래쪽에서 생성하기 단추를 선택합니다.
배포가 완료되면 리소스로 이동을 선택합니다.

4 - 앱으로 이동

웹 브라우저에서 배포된 애플리케이션(URL: http://<app-name>.azurewebsites.net)으로 이동합니다.

포트가 공개되지 않은 컨테이너가 백그라운드 모드에서 실행된다는 메시지가 포함된 Windows App Service의 스크린샷

호스트 운영 체제가 바닥글에 표시되어 Windows 컨테이너에서 실행되고 있음을 확인합니다.

5 - 리소스 정리

Azure Portal 메뉴 또는 홈 페이지에서 리소스 그룹을 선택합니다. 그런 다음, 리소스 그룹 페이지에서 myResourceGroup을 선택합니다.

myResourceGroup 페이지에서 나열된 리소스가 삭제하려는 리소스인지 확인합니다.

리소스 그룹 삭제를 선택하고, 텍스트 상자에서 myResourceGroup을 입력하여 확인한 다음, 삭제를 선택합니다.

다음 단계

축하합니다. 이 빠른 시작을 성공적으로 완료하셨습니다.

이 빠른 시작에서는 Microsoft Artifact Registry에서 Azure App Service로 Windows의 ASP.NET 앱을 배포하는 방법을 보여 줍니다.

이 빠른 시작을 완료하려면 다음이 필요합니다.

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
Azure PowerShell.

1 - Azure에 연결

Connect-AzAccount 명령을 사용하고 프롬프트에 따라 Azure 계정에 로그인합니다.

Connect-AzAccount

2 - 리소스 그룹 만들기

New-AzResourceGroup 명령을 사용하여 리소스 그룹을 만듭니다. Azure 리소스 그룹은 Azure 리소스가 배포 및 관리되는 논리적 컨테이너입니다.

다음 예제에서는 eastus 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다. App Service에 지원되는 모든 위치를 확인하려면 Get-AzLocation 명령을 실행합니다.

New-AzResourceGroup -Name myResourceGroup -Location eastus

완료되면 이 명령은 Login Succeeded를 반환합니다.

3 - App Service 플랜 만들기

New-AzAppServicePlan 명령을 사용하여 새 App Service 계획을 만듭니다.

다음 예제에서는 PremiumV3 가격 책정 계층(-Tier PremiumV3)에 myAppServicePlan이라는 App Service 계획을 만듭니다. -HyperV 매개 변수는 Windows 컨테이너를 지정합니다.

New-AzAppServicePlan -Name myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -Tier PremiumV3 -HyperV

4 - 웹앱 만들기

New-AzWebApp 명령을 사용하여 새 앱을 만듭니다.

New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Name 매개 변수는 웹앱 이름을 지정합니다.
AppServicePlan 매개 변수는 App Service 계획 이름을 지정합니다.
Location 매개 변수는 위치를 지정합니다.
ResourceGroupName 매개 변수는 리소스 그룹의 이름을 지정합니다.
ContainerImageName 매개 변수는 컨테이너 이미지 이름과 선택적 태그를 지정합니다.

명령을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

5 - 앱으로 이동

웹 브라우저에서 배포된 애플리케이션(URL: http://<app-name>.azurewebsites.net)으로 이동합니다.

포트가 공개되지 않은 컨테이너가 백그라운드 모드에서 실행된다는 메시지가 포함된 Windows App Service의 스크린샷

6 - 리소스 정리

Remove-AzResourceGroup 명령을 사용하여 리소스 그룹을 제거합니다.

Remove-AzResourceGroup myResourceGroup

다음 단계

축하합니다. 이 빠른 시작을 성공적으로 완료하셨습니다.

이 빠른 시작에서는 Microsoft Artifact Registry에서 Azure App Service로 Windows의 ASP.NET 앱을 배포하는 방법을 보여 줍니다.

이 빠른 시작을 완료하려면 다음이 필요합니다.

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
Azure CLI

1 - Azure에 연결

az login 명령을 사용하고 프롬프트에 따라 Azure 계정에 로그인합니다.

az login

2 - 리소스 그룹 만들기

az group create 명령을 사용하여 리소스 그룹을 만듭니다. Azure 리소스 그룹은 Azure 리소스가 배포 및 관리되는 논리적 컨테이너입니다.

다음 예제에서는 eastus 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다. App Service에 지원되는 모든 위치를 확인하려면 az appservice list-locations 명령을 실행합니다.

az group create --name myResourceGroup --location eastus

3 - App Service 플랜 만들기

az appservice plan create 명령을 사용하여 리소스 그룹에 App Service 계획을 만듭니다.

다음 예제에서는 P1V3 가격 책정 계층(--sku P1V3)에서 myAppServicePlan이라는 App Service 요금제를 만듭니다.

az appservice plan create --resource-group myResourceGroup --location eastus --name myAppServicePlan --hyper-v --sku p1v3

참고 항목

"이 명령의 동작이 다음 확장인 appservice-kube에 의해 변경되었습니다."라는 오류가 발생하면 appservice-kube 확장을 제거합니다.

4 - 웹앱 만들기

az webapp create 명령을 사용하여 myAppServicePlan App Service 계획에서 사용자 지정 컨테이너 웹앱을 만듭니다. myContainerApp을 고유한 앱 이름으로 바꿔야 합니다(유효한 문자는 a-z, 0-9 및 -임).

az webapp create --name myContainerApp --plan myAppServicePlan --location eastus --resource-group myResourceGroup --deployment-container-image-name mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Name 매개 변수는 웹앱 이름을 지정합니다.
AppServicePlan 매개 변수는 App Service 계획 이름을 지정합니다.
Location 매개 변수는 위치를 지정합니다.
ResourceGroupName 매개 변수는 리소스 그룹의 이름을 지정합니다.
deployment-container-image-name 매개 변수는 컨테이너 이미지 이름과 선택적 태그를 지정합니다.

5 - 앱으로 이동

웹 브라우저에서 배포된 애플리케이션(URL: http://<app-name>.azurewebsites.net)으로 이동합니다.

포트가 공개되지 않은 컨테이너가 백그라운드 모드에서 실행된다는 메시지가 포함된 Windows App Service의 스크린샷

6 - 리소스 정리

az group delete 명령을 사용하여 리소스 그룹을 제거합니다.

az group delete --no-wait --name <resource_group>

다음 단계

축하합니다. 이 빠른 시작을 성공적으로 완료하셨습니다.