Azure Container Instances를 사용하여 단순성과 속도로 Azure에서 서버리스 Docker 컨테이너를 실행합니다. Azure Kubernetes Service와 같은 전체 컨테이너 오케스트레이션 플랫폼이 필요하지 않은 경우 주문형 컨테이너 인스턴스에 애플리케이션을 배포합니다.
이 빠른 시작에서는 Azure CLI를 사용하여 격리된 Docker 컨테이너를 배포하고 FQDN(정규화된 도메인 이름)으로 애플리케이션을 사용할 수 있도록 합니다. 단일 배포 명령을 실행한 후 몇 초 후에 컨테이너에서 실행되는 애플리케이션으로 이동할 수 있습니다.
Azure 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
Prerequisites
Bash 환경을 Azure Cloud Shell에서 사용합니다. 자세한 내용은 Azure Cloud Shell 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치하십시오. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 Azure에 인증을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI로 확장 사용 및 관리를 참조하세요.
az version을 실행하여 설치된 버전과 관련 종속 라이브러리를 확인합니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
이 빠른 시작에는 Azure CLI 버전 2.0.55 이상이 필요합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
Warning
모범 사례: CLI(명령줄 인터페이스)를 통해 전달된 사용자의 자격 증명은 백 엔드에 일반 텍스트로 저장됩니다. 일반 텍스트에 자격 증명을 저장하는 것은 보안 위험입니다. Microsoft는 백 엔드에 저장할 때 암호화/변환되도록 CLI 환경 변수에 사용자 자격 증명을 저장하도록 고객에게 권고합니다.
리소스 그룹 만들기
모든 Azure 리소스와 마찬가지로 Azure 컨테이너 인스턴스는 리소스 그룹에 배포되어야 합니다. 리소스 그룹을 사용하면 관련 Azure 리소스를 구성하고 관리할 수 있습니다.
먼저 az group create 명령을 사용하여 eastus 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다.
az group create --name myResourceGroup --___location eastus
컨테이너 만들기
이제 리소스 그룹이 있으므로 Azure에서 컨테이너를 실행할 수 있습니다. Azure CLI를 사용하여 컨테이너 인스턴스를 만들려면 az container create 명령에 리소스 그룹 이름, 컨테이너 인스턴스 이름 및 Docker 컨테이너 이미지를 제공합니다. 이 빠른 시작에서는 공용 mcr.microsoft.com/azuredocs/aci-helloworld 이미지를 사용합니다. 이 이미지는 정적 HTML 페이지를 제공하는 Node.js 작성된 작은 웹앱을 패키지합니다.
열려는 하나 이상의 포트, DNS 이름 레이블 또는 둘 다를 지정하여 컨테이너를 인터넷에 노출할 수 있습니다. 이 빠른 시작에서는 웹앱에 공개적으로 연결할 수 있도록 DNS 이름 레이블이 있는 컨테이너를 배포합니다.
다음과 유사한 명령을 실행하여 컨테이너 인스턴스를 시작합니다. Azure 지역 내에서 인스턴스를 만들 때, 고유한 --dns-name-label 값을 설정하세요. "DNS 이름 레이블을 사용할 수 없음" 오류 메시지가 표시되면 다른 DNS 이름 레이블을 사용해 보세요.
az container create --resource-group myResourceGroup --name mycontainer --image mcr.microsoft.com/azuredocs/aci-helloworld --dns-name-label aci-demo --ports 80 --os-type linux --memory 1.5 --cpu 1
컨테이너를 특정 가용성 영역에 배포하려면 인수를 --zone 사용하고 논리 영역 번호를 지정합니다.
az container create --resource-group myResourceGroup --name mycontainer --image mcr.microsoft.com/azuredocs/aci-helloworld --dns-name-label aci-demo --ports 80 --os-type linux --memory 1.5 --cpu 1 --zone 1
중요합니다
영역 배포는 가용성 영역을 지원하는 지역에서만 사용할 수 있습니다. 지역에서 가용성 영역을 지원하는지 확인하려면 Azure 지역 목록을 참조하세요.
몇 초 내에 배포가 완료되었음을 나타내는 Azure CLI의 응답을 받아야 합니다. az container show 명령을 사용하여 상태를 확인합니다.
az container show --resource-group myResourceGroup --name mycontainer --query "{FQDN:ipAddress.fqdn,ProvisioningState:provisioningState}" --out table
명령을 실행하면 컨테이너의 FQDN(정규화된 도메인 이름) 및 해당 프로비저닝 상태가 표시됩니다.
FQDN ProvisioningState
--------------------------------- -------------------
aci-demo.eastus.azurecontainer.io Succeeded
컨테이너가 ProvisioningState성공하면 브라우저에서 해당 FQDN으로 이동합니다. 다음과 유사한 웹 페이지가 표시되면 축하합니다. Docker 컨테이너에서 실행되는 애플리케이션을 Azure에 성공적으로 배포했습니다.
처음에 애플리케이션이 표시되지 않으면 DNS가 전파되는 동안 몇 초 정도 기다려야 할 수 있습니다. 그런 다음 브라우저를 새로 고쳐 보세요.
컨테이너 로그 끌어오기
실행되는 컨테이너 또는 애플리케이션의 문제를 해결해야 하는 경우(또는 출력만 표시) 먼저 컨테이너 인스턴스의 로그를 확인합니다.
az container logs 명령을 사용하여 컨테이너 인스턴스 로그를 끌어오세요.
az container logs --resource-group myResourceGroup --name mycontainer
출력은 컨테이너에 대한 로그를 표시하며 브라우저에서 애플리케이션을 볼 때 생성된 HTTP GET 요청을 표시해야 합니다.
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"
출력 스트림 연결
로그를 보는 것 외에도 로컬 표준 출력 및 표준 오류 스트림을 컨테이너의 로그에 연결할 수 있습니다.
먼저 az container attach 명령을 실행하여 로컬 콘솔을 컨테이너의 출력 스트림에 연결합니다.
az container attach --resource-group myResourceGroup --name mycontainer
연결되면 브라우저를 몇 번 새로 고쳐 출력을 더 생성합니다. 완료되면 콘솔 Control+C을 분리합니다. 다음 샘플과 유사한 출력이 표시됩니다.
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"
자원을 정리하세요
컨테이너를 완료했으면 az container delete 명령을 사용하여 제거합니다.
az container delete --resource-group myResourceGroup --name mycontainer
컨테이너가 삭제되었는지 확인하려면 az container list 명령을 실행합니다.
az container list --resource-group myResourceGroup --output table
mycontainer 컨테이너는 명령의 출력에 표시되지 않아야 합니다. 리소스 그룹에 다른 컨테이너가 없으면 출력이 표시되지 않습니다.
myResourceGroup 리소스 그룹 및 포함된 모든 리소스를 완료한 경우 az group delete 명령을 사용하여 삭제합니다.
az group delete --name myResourceGroup
다음 단계
이 빠른 시작에서는 공용 Microsoft 이미지를 사용하여 Azure 컨테이너 인스턴스를 만들었습니다. 컨테이너 이미지를 빌드하고 프라이빗 Azure 컨테이너 레지스트리에서 배포하려면 Azure Container Instances 자습서를 계속 진행합니다.
Azure의 오케스트레이션 시스템에서 컨테이너를 실행하는 옵션을 사용해 보려면 AKS(Azure Kubernetes Service) 빠른 시작을 참조하세요.