Docker 컨테이너에서 Azure CLI를 실행하는 방법

2025-06-21

Docker를 사용하여 Azure CLI를 미리 설치한 독립 실행형 Linux 컨테이너를 실행하여 Azure CLI를 사용하기 위한 빠르고 격리된 환경을 제공할 수 있습니다. 이 컨테이너 이미지는 사용자 지정 배포의 기반이 될 수도 있습니다.

경고

Azure CLI 2.63.0(2024년 8월 릴리스)은 Alpine 기반 Docker 이미지에서 지원되는 최종 버전입니다. Microsoft는 더 이상 이 이미지에 대한 업데이트 또는 버그 수정을 제공하지 않습니다. 지속적인 지원을 보장하려면 완전히 유지 관리되는 Azure Linux 기반 이미지(Azure Linux 3.0)로 마이그레이션합니다. Azure Linux 3.0 사용에 대한 다음 예제를 참조하세요.

경고 메시지를 억제하려면 다음 az config set core.only_show_errors=yes을 실행합니다. 구성 옵션에 대한 자세한 내용은 Azure CLI 구성 값 및 환경 변수를 참조하세요.

Azure CLI를 미리 설치하여 Docker 컨테이너 시작

명령 프롬프트를 열고 다음 명령을 사용하여 미리 설치된 Azure CLI를 사용하여 Docker 컨테이너를 시작합니다. 파이프라인에서 이 명령을 사용하는 경우 결정적 태그(예: azurelinux3.0)를 사용하여 일관된 동작을 보장합니다.

docker run -it mcr.microsoft.com/azure-cli:azurelinux3.0

비고

컨테이너 내에서 로컬 SSH 키를 사용하려면 다음 옵션을 --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh포함하여 .ssh 디렉터리를 탑재합니다. 이 옵션을 사용하면 컨테이너가 사용자 환경에서 SSH 키에 액세스할 수 있습니다.

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

Azure CLI는 이미지 안에서 /usr/local/bin/az에 위치한 az 명령으로 사용할 수 있습니다.

특정 버전의 Azure CLI를 사용하여 Docker 컨테이너 실행

Azure CLI 릴리스 정보에서 사용 가능한 버전을 찾을 수 있습니다.

Docker 컨테이너에서 특정 버전의 Azure CLI를 실행하려면 다음 명령을 사용하여 원하는 버전으로 대체 2.74.0 합니다.

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

Docker 이미지 업데이트

Docker를 사용할 때 Azure CLI를 업데이트하려면 최신 이미지를 끌어와 기존 컨테이너를 다시 만들어야 합니다. 이 업데이트 프로세스로 인해 Azure CLI 컨테이너를 영구 데이터 저장소로 사용하지 않도록 합니다.

다음 명령을 사용하여 로컬 이미지를 업데이트합니다.

docker pull mcr.microsoft.com/azure-cli:latest

Docker 이미지 제거

Azure CLI를 제거하기로 결정하셨다니 떠나게 되어 아쉽습니다. 제거하기 전에 이 명령을 사용하여 az feedback 개선 또는 수정할 수 있는 사항을 알려주세요. 우리 목표는 Azure CLI를 버그가 없고 사용자에게 친숙하게 만드는 것입니다. 버그를 발견한 경우 GitHub 문제를 제출하면 감사하겠습니다.

Docker 이미지를 제거하려면 먼저 실행 중인 컨테이너를 중지한 다음 다음을 실행합니다.

docker rmi mcr.microsoft.com/azure-cli

다음 단계

이제 Docker 컨테이너에서 Azure CLI를 사용할 준비가 되었으므로 주요 기능과 일반적으로 사용되는 명령을 빠르게 둘러보고 시작합니다.

Azure CLI 시작