빠른 시작: Azure CLI를 사용하여 Azure에서 컨테이너 인스턴스 배포Quickstart: Deploy a container instance in Azure using the Azure CLI

Azure Container Instances를 사용하여 Azure에서 서버리스 Docker 컨테이너를 간단하고 빠르게 실행합니다.Use Azure Container Instances to run serverless Docker containers in Azure with simplicity and speed. Azure Kubernetes Service와 같은 풀 컨테이너 오케스트레이션 플랫폼이 필요하지 않을 경우 애플리케이션을 요청 시 컨테이너 인스턴스에 배포합니다.Deploy an application to a container instance on-demand when you don't need a full container orchestration platform like Azure Kubernetes Service.

이 빠른 시작에서는 Azure CLI를 사용하여 격리된 Docker 컨테이너를 배포하고 해당 애플리케이션을 정규화된 도메인 이름(FQDN)으로 사용 가능하게 합니다.In this quickstart, you use the Azure CLI to deploy an isolated Docker container and make its application available with a fully qualified domain name (FQDN). 단일 배포 명령을 실행한 후 몇 초 내에 컨테이너에서 실행 중인 애플리케이션을 찾아볼 수 있습니다.A few seconds after you execute a single deployment command, you can browse to the application running in the container:

브라우저에서 Azure Container Instances에 배포된 앱 보기

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

Azure Cloud Shell 사용Use Azure Cloud Shell

Azure는 브라우저를 통해 사용할 수 있는 대화형 셸 환경인 Azure Cloud Shell을 호스트합니다.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell에서 Bash 또는 PowerShell을 사용하여 Azure 서비스 작업을 수행할 수 있습니다.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. 로컬 환경에 아무 것도 설치할 필요 없이 Azure Cloud Shell의 미리 설치된 명령을 사용하여 이 문서의 코드를 실행할 수 있습니다.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Azure Cloud Shell을 시작하려면 다음을 수행합니다.To start Azure Cloud Shell:

옵션Option 예제/링크Example/Link
코드 블록의 오른쪽 위 모서리에서 사용을 선택합니다.Select Try It in the upper-right corner of a code block. 사용해보기를 선택하면 코드가 Cloud Shell에 자동으로 복사되지 않습니다.Selecting Try It doesn't automatically copy the code to Cloud Shell. Azure Cloud Shell에 대한 사용 예제
https://shell.azure.com으로 이동하거나 Cloud Shell 시작 버튼을 선택하여 브라우저에서 Cloud Shell을 엽니다.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. 새 창에서 Cloud Shell 시작Launch Cloud Shell in a new window
Azure Portal의 오른쪽 위에 있는 메뉴 모음에서 Cloud Shell 단추를 선택합니다.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Azure Portal의 Cloud Shell 단추

이 문서의 코드를 Azure Cloud Shell에서 실행하려면 다음을 수행합니다.To run the code in this article in Azure Cloud Shell:

  1. Cloud Shell을 시작합니다.Start Cloud Shell.

  2. 코드 블록의 복사 단추를 선택하여 코드를 복사합니다.Select the Copy button on a code block to copy the code.

  3. Windows 및 Linux에서 Ctrl+Shift+V를 선택하거나 macOS에서 Cmd+Shift+V를 선택하여 코드를 Cloud Shell 세션에 붙여넣습니다.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Enter를 선택하여 코드를 실행합니다.Select Enter to run the code.

Azure Cloud Shell 또는 Azure CLI의 로컬 설치를 사용하여 이 빠른 시작을 완료할 수 있습니다.You can use the Azure Cloud Shell or a local installation of the Azure CLI to complete this quickstart. 로컬로 사용하려면 2.0.55 버전 이상이 권장됩니다.If you'd like to use it locally, version 2.0.55 or later is recommended. az --version을 실행하여 버전을 찾습니다.Run az --version to find the version. 설치 또는 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.If you need to install or upgrade, see Install Azure CLI.

리소스 그룹 만들기Create a resource group

모든 Azure 리소스와 마찬가지로 Azure 컨테이너 인스턴스는 리소스 그룹에 배포해야 합니다.Azure container instances, like all Azure resources, must be deployed into a resource group. 리소스 그룹을 사용하면 관련 Azure 리소스를 구성하고 관리할 수 있습니다.Resource groups allow you to organize and manage related Azure resources.

먼저, 다음 az group create 명령을 사용하여 eastus 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다.First, create a resource group named myResourceGroup in the eastus location with the following az group create command:

az group create --name myResourceGroup --location eastus

컨테이너 만들기Create a container

이제 리소스 그룹이 있으므로 Azure에서 컨테이너를 실행할 수 있습니다.Now that you have a resource group, you can run a container in Azure. Azure CLI를 사용하여 컨테이너 인스턴스를 만들려면 az container create 명령에 리소스 그룹 이름, 컨테이너 인스턴스 이름 및 Docker 컨테이너 이미지를 제공합니다.To create a container instance with the Azure CLI, provide a resource group name, container instance name, and Docker container image to the az container create command. 이 빠른 시작에서는 공용 mcr.microsoft.com/azuredocs/aci-helloworld 이미지를 사용합니다.In this quickstart, you use the public mcr.microsoft.com/azuredocs/aci-helloworld image. 이 이미지는 고정 HTML 페이지를 제공하는 Node.js로 작성된 작은 웹앱을 패키징합니다.This image packages a small web app written in Node.js that serves a static HTML page.

열려는 하나 이상의 포트, DNS 이름 레이블 또는 둘 다를 지정하여 컨테이너를 인터넷에 공개할 수 있습니다.You can expose your containers to the internet by specifying one or more ports to open, a DNS name label, or both. 이 빠른 시작에서는 DNS 이름 레이블이 있는 컨테이너를 배포하여 웹앱을 공개적으로 연결할 수 있도록 합니다.In this quickstart, you deploy a container with a DNS name label so that the web app is publicly reachable.

컨테이너 인스턴스를 시작하려면 다음과 유사한 명령을 실행합니다.Execute a command similar to the following to start a container instance. 인스턴스를 만드는 Azure 지역 내에서 고유한 --dns-name-label 값을 설정합니다.Set a --dns-name-label value that's unique within the Azure region where you create the instance. "DNS 이름 레이블을 사용할 수 없습니다"라는 오류 메시지가 표시되면 다른 DNS 이름 레이블을 사용해 보세요.If you receive a "DNS name label not available" error message, try a different DNS name label.

az container create --resource-group myResourceGroup --name mycontainer --image mcr.microsoft.com/azuredocs/aci-helloworld --dns-name-label aci-demo --ports 80

몇 초 내에 Azure CLI로부터 배포가 완료되었음을 알려주는 응답을 받습니다.Within a few seconds, you should get a response from the Azure CLI indicating that the deployment has completed. az container show 명령을 사용하여 상태를 확인합니다.Check its status with the az container show command:

az container show --resource-group myResourceGroup --name mycontainer --query "{FQDN:ipAddress.fqdn,ProvisioningState:provisioningState}" --out table

명령을 실행하면 컨테이너의 FQDN(정규화된 도메인 이름) 및 해당 프로비전 상태가 표시됩니다.When you run the command, the container's fully qualified domain name (FQDN) and its provisioning state are displayed.

FQDN                               ProvisioningState
---------------------------------  -------------------
aci-demo.eastus.azurecontainer.io  Succeeded

컨테이너의 ProvisioningStateSucceeded(성공)이면 브라우저에서 해당 FQDN으로 이동합니다.If the container's ProvisioningState is Succeeded, go to its FQDN in your browser. 다음과 비슷한 웹 페이지가 표시됩니다.If you see a web page similar to the following, congratulations! Docker 컨테이너에서 실행되는 애플리케이션이 Azure에 성공적으로 배포되었습니다.You've successfully deployed an application running in a Docker container to Azure.

브라우저에서 Azure Container Instances에 배포된 앱 보기

처음에 애플리케이션이 표시되지 않으면 DNS가 전파되는 동안 잠시 기다린 후에 브라우저를 새로 고쳐야 할 수 있습니다.If at first the application isn't displayed, you might need to wait a few seconds while DNS propagates, then try refreshing your browser.

컨테이너 로그 끌어오기Pull the container logs

컨테이너 또는 컨테이너가 실행되는 애플리케이션의 문제를 해결해야 하거나 해당 문제에 대한 출력만 보려는 경우 컨테이너 인스턴스의 로그를 확인하면서 시작합니다.When you need to troubleshoot a container or the application it runs (or just see its output), start by viewing the container instance's logs.

az container logs 명령을 사용하여 컨테이너 인스턴스 로그를 끌어옵니다.Pull the container instance logs with the az container logs command:

az container logs --resource-group myResourceGroup --name mycontainer

출력은 컨테이너의 로그를 표시하며, 브라우저에서 애플리케이션을 볼 때 생성된 HTTP GET 요청을 표시해야 합니다.The output displays the logs for the container, and should show the HTTP GET requests generated when you viewed the application in your browser.

listening on port 80
::ffff:10.240.255.55 - - [21/Mar/2019:17:43:53 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"
::ffff:10.240.255.55 - - [21/Mar/2019:17:44:36 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"
::ffff:10.240.255.55 - - [21/Mar/2019:17:44:36 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"

출력 스트림 연결Attach output streams

로그를 확인하는 것 외에도 로컬 표준 출력과 표준 오류 스트림을 컨테이너의 해당 표준 출력 스트림에 연결할 수 있습니다.In addition to viewing the logs, you can attach your local standard out and standard error streams to that of the container.

먼저 az container attach 명령을 실행하여 로컬 콘솔을 컨테이너의 출력 스트림에 연결합니다.First, execute the az container attach command to attach your local console to the container's output streams:

az container attach --resource-group myResourceGroup --name mycontainer

연결되면 브라우저를 몇 번 새로 고쳐 추가 출력을 생성합니다.Once attached, refresh your browser a few times to generate some additional output. 완료되면 Control+C를 사용하여 콘솔을 분리합니다.When you're done, detach your console with Control+C. 다음과 비슷한 내용이 출력됩니다.You should see output similar to the following:

Container 'mycontainer' is in state 'Running'...
(count: 1) (last timestamp: 2019-03-21 17:27:20+00:00) pulling image "mcr.microsoft.com/azuredocs/aci-helloworld"
(count: 1) (last timestamp: 2019-03-21 17:27:24+00:00) Successfully pulled image "mcr.microsoft.com/azuredocs/aci-helloworld"
(count: 1) (last timestamp: 2019-03-21 17:27:27+00:00) Created container
(count: 1) (last timestamp: 2019-03-21 17:27:27+00:00) Started container

Start streaming logs:
listening on port 80

::ffff:10.240.255.55 - - [21/Mar/2019:17:43:53 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"
::ffff:10.240.255.55 - - [21/Mar/2019:17:44:36 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"
::ffff:10.240.255.55 - - [21/Mar/2019:17:44:36 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"
::ffff:10.240.255.55 - - [21/Mar/2019:17:47:01 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"
::ffff:10.240.255.56 - - [21/Mar/2019:17:47:12 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36"

리소스 정리Clean up resources

컨테이너 작업을 완료했으면 az container delete 명령을 사용하여 제거합니다.When you're done with the container, remove it using the az container delete command:

az container delete --resource-group myResourceGroup --name mycontainer

컨테이너가 삭제되었는지 확인하려면 az container list 명령을 실행합니다.To verify that the container has been deleted, execute the az container list command:

az container list --resource-group myResourceGroup --output table

mycontainer 컨테이너가 명령의 출력에 나타나지 않아야 합니다.The mycontainer container should not appear in the command's output. 리소스 그룹에 다른 컨테이너가 없는 경우 표시되는 출력이 없습니다.If you have no other containers in the resource group, no output is displayed.

myResourceGroup 리소스 그룹 및 이 그룹에 포함된 모든 리소스 작업이 완료되었으면 az group delete 명령을 사용하여 해당 그룹을 삭제합니다.If you're done with the myResourceGroup resource group and all the resources it contains, delete it with the az group delete command:

az group delete --name myResourceGroup

다음 단계Next steps

이 빠른 시작에서는 공용 Microsoft 이미지를 사용하여 Azure 컨테이너 인스턴스를 만들었습니다.In this quickstart, you created an Azure container instance by using a public Microsoft image. 컨테이너 이미지를 빌드하고 프라이빗 Azure 컨테이너 레지스트리에서 배포하려면 Azure Container Instances 자습서로 계속 진행하세요.If you'd like to build a container image and deploy it from a private Azure container registry, continue to the Azure Container Instances tutorial.

Azure에서 오케스트레이션 시스템의 컨테이너 실행 옵션을 사용하려면 AKS(Azure Kubernetes Service) 빠른 시작을 참조하세요.To try out options for running containers in an orchestration system on Azure, see the Azure Kubernetes Service (AKS) quickstarts.