Azure CLI 설치 방법, 윈도우·맥·리눅스 완벽 정리

클라우드 서비스가 기업 IT 인프라의 핵심으로 부상함에 따라, Azure CLI 설치는 많은 개발자와 운영 담당자에게 중요한 이슈가 되었습니다. 그래픽 인터페이스 대신 명령줄을 통해 리소스를 직접 제어할 수 있다는 점은 반복 작업을 자동화하고, 다양한 시스템과의 연동을 간소화하는 큰 이점을 제공합니다. 이 글을 통해 여러분은 az cli 설치, azure cli install, azure cli 다운로드 등 핵심 키워드와 함께 Azure CLI를 제대로 활용하는 방법을 배울 수 있을 것입니다.

이 글에서 알 수 있는 내용

• Azure CLI란 무엇인지, 왜 필요한지
• Windows, macOS, Linux에서 Azure CLI 설치 방법
• Azure CLI를 활용한 기본 명령어 및 사용법
• 설치 오류 발생 시 해결 방법
• Azure CLI 업데이트 및 제거 방법

핵심 정보 미리 보기

• Azure CLI는 명령어를 통해 Azure 리소스를 관리하는 도구입니다.
• Windows, macOS, Linux에서 각각 다른 설치 방법을 사용합니다.
• ‘az login’을 사용해 Azure 계정에 로그인할 수 있습니다.
• CLI 버전 관리를 위해 ‘az upgrade’ 명령어를 활용할 수 있습니다.
• 설치 오류가 발생하면 관리자 권한 실행 및 인터넷 연결을 확인하세요.

Azure CLI란 무엇인가

Azure CLI는 Microsoft Azure의 다양한 리소스를 명령줄(Command Line)에서 손쉽게 제어할 수 있도록 해주는 크로스 플랫폼(Command, PowerShell, Bash 등) 기반 툴입니다. 단순히 명령 한 줄로 가상 머신을 생성하거나, 스토리지 계정을 생성하고, 네트워크 보안을 설정하는 등 GUI(그래픽 사용자 인터페이스)로 처리하기 번거로운 작업을 빠르게 수행할 수 있도록 도와줍니다.

• 크로스 플랫폼 지원
  Windows, macOS, Linux 어디서든 사용할 수 있는 확장성 높은 도구입니다.
• 자동화와 스크립팅에 적합
  반복 작업을 스크립트로 만들어 서버나 개발 환경에 쉽게 배포할 수 있습니다.
• Azure Portal보다 빠른 조작
  웹에서 클릭으로 설정하는 것보다 명령줄이 더 빠르고 직관적일 때가 많습니다.

개인적으로 클라우드 환경을 다루면서 그래픽 포털에 매번 로그인해 여러 단계를 거치는 것보다, Azure CLI를 활용해 명령줄로 바로 리소스를 제어하는 편이 훨씬 효율적이었습니다. 특히 인프라를 코드화(Infrastructure as Code)하는 과정에서 Azure CLI는 거의 필수적인 도구라고 생각합니다.

Azure CLI를 사용하는 이유

1. 생산성 향상
   반복적인 인프라 설정을 간단한 스크립트로 처리할 수 있어, 실수 없이 빠른 작업이 가능합니다.
2. 자동화 용이
   CI/CD 파이프라인(예: GitHub Actions, Azure DevOps 등)에 손쉽게 통합하여 빌드-배포-테스트 과정을 완전 자동화할 수 있습니다.
3. 버전 관리
   Azure CLI 버전을 고정하거나 업데이트 전략을 세워 환경을 안정적으로 운영할 수 있습니다.
   예를 들어, 여러 프로젝트가 동시에 운영되는 환경에서 특정 버전에 맞춰 작업해야 할 때는 Docker 컨테이너를 이용해 CLI 버전을 격리하는 방식을 쓸 수도 있습니다.
4. 멀티 클라우드 또는 하이브리드 환경 호환
   Azure CLI만의 장점은 여러 플랫폼과 연동이 쉽다는 점입니다. 예컨대 온프레미스 서버와 Azure를 혼합해 사용하는 하이브리드 시나리오에서도, CLI를 이용해 공통된 자동화 스크립트를 작성할 수 있습니다.

Azure CLI 설치를 위한 사전 준비

Azure CLI를 원활하게 설치하고 사용하기 위해서는 다음 사항을 확인해야 합니다.

• 관리자 권한
  Windows에서는 보통 MSI 파일 설치나 PowerShell을 통한 설치 시 관리자 권한이 필요할 수 있습니다. macOS나 Linux 환경에서도 패키지 관리자 사용 시 sudo 권한이 요구됩니다.
• 인터넷 연결
  최신 버전을 다운로드하고, 설치 패키지를 정상적으로 받기 위해 안정적인 네트워크 환경이 필요합니다.
• 파이썬(Python) 환경 (선택)
  최신 버전의 Azure CLI는 자체 실행 파일 형태로 배포되므로 별도의 파이썬 환경이 필수는 아닙니다. 다만 파이썬 스크립트와 연동하거나, pip를 통한 설치를 시도하는 경우에는 파이썬이 필요할 수 있습니다.
• 기존 CLI 버전 충돌 주의
  다른 버전의 CLI 도구(예: Azure PowerShell 모듈 등)와 경로 충돌이 날 수 있으므로, 기존 버전을 삭제하고 설치하는 것이 권장됩니다.

운영체제별 Azure CLI 설치 방법

아래 표는 운영체제별로 “azure cli install” 과정을 간략하게 비교한 것입니다.

운영체제	설치 방법	명령어 예시	특징
Windows	MSI 설치파일 or PowerShell 스크립트	az --version	GUI 기반 설치 가능, PowerShell을 통한 자동화 지원
macOS	Homebrew	brew install azure-cli	Homebrew로 버전 관리 편리
Linux	배포판별 패키지 관리자	예) apt-get install azure-cli	Ubuntu, CentOS, Arch 등 다양한 환경 지원

이제 실제로 각 OS에서 az cli 설치와 관련된 자세한 가이드를 살펴보겠습니다.

Windows에서 Azure CLI 설치

1) MSI 파일을 통한 설치

1. MSI 다운로드
   Azure CLI 다운로드 페이지에서 최신 MSI 설치 관리자를 받습니다.
2. 설치 진행
   다운로드한 MSI 파일을 더블 클릭해 설치 마법사를 실행하고, 안내에 따라 진행합니다.
3. 설치 확인
   명령 프롬프트(CMD)나 PowerShell을 열어 다음 명령어를 입력합니다. az --version CLI 버전 정보가 정상적으로 표시되면 설치가 완료된 것입니다.

2) PowerShell 스크립트를 통한 설치

1. PowerShell 관리자 권한 실행
   “Windows PowerShell”을 관리자(우클릭 → 관리자 권한으로 실행)로 실행합니다.
2. 설치 스크립트 실행
   공식 설치 스크립트를 통해 Azure CLI를 자동으로 다운로드하고 설치할 수 있습니다. $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi
3. 설치 확인 az --version

개인 팁: 자동화된 서버 환경(예: AWS EC2 Windows 서버)에서 Azure CLI를 사용하는 경우 PowerShell 스크립트를 이용하면 훨씬 편리합니다.

macOS에서 Azure CLI 설치

macOS에서는 Homebrew를 활용하면 CLI 설치와 관리를 쉽게 할 수 있습니다.

1. Homebrew 설치 확인 brew --version 버전이 출력되지 않으면 Homebrew 공식 사이트의 안내에 따라 설치하세요.
2. Azure CLI 다운로드 및 설치 brew update && brew install azure-cli 설치가 끝나면 az --version으로 확인합니다.
3. 업데이트 brew upgrade azure-cli 이 명령어로 최신 버전을 간단히 유지할 수 있습니다.

개인 팁: macOS 개발 환경에서 Visual Studio Code, Xcode, Docker 등과 함께 Azure CLI를 사용하면, 로컬에서 개발한 코드를 Azure에 신속하게 배포할 수 있어 매우 유용합니다.

Linux에서 Azure CLI 설치

Linux는 다양한 배포판이 존재하므로, 대표적인 Ubuntu/Debian 계열과 CentOS/RHEL 계열, 그리고 Arch 계열을 위주로 살펴봅니다.

Ubuntu/Debian 계열

1. 패키지 업데이트 및 필수 패키지 설치 sudo apt update && sudo apt install ca-certificates curl apt-transport-https lsb-release gnupg
2. Microsoft 서명 키 추가 curl -sLS https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /usr/share/keyrings/microsoft-archive-keyring.gpg > /dev/null
3. Azure CLI 저장소 등록 echo "deb [signed-by=/usr/share/keyrings/microsoft-archive-keyring.gpg] https://packages.microsoft.com/repos/azure-cli/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/azure-cli.list
4. Azure CLI 설치 sudo apt update && sudo apt install azure-cli

CentOS/RHEL 계열

1. Microsoft 서명 키 추가 sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
2. 저장소 구성 파일 생성 sudo sh -c 'echo -e "[azure-cli]\nname=Azure CLI\nbaseurl=https://packages.microsoft.com/yumrepos/azure-cli\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/azure-cli.repo'
3. Azure CLI 설치 sudo yum install azure-cli

Arch Linux 계열

1. AUR(Arch User Repository) 사용 yay -S azure-cli 또는 paru -S azure-cli

설치 후 az --version을 통해 정상 설치 여부를 확인하세요.

Azure CLI 사용법 기본

Azure CLI 설치가 끝났다면, 이제 주요 명령어를 익혀봐야 합니다. “azure cli 사용법”을 빠르게 파악하면 각종 Azure 리소스를 제어하는 데 큰 도움이 됩니다.

로그인 및 구독 관리

1. 로그인az login
   • 브라우저가 열리며 Azure 계정에 로그인할 수 있습니다.
   • 서버 환경 등 브라우저 접근이 어려운 경우: az login --use-device-code 명령줄에 표시되는 코드를 웹 브라우저에서 입력해 인증하는 방식입니다.
2. 구독 목록 확인 az account list --output table 여러 개의 구독이 있는 경우, 어떤 구독을 사용할지 확인하고 설정해야 합니다.
3. 구독 변경 az account set --subscription "SUBSCRIPTION_NAME_OR_ID" 이후 명령어는 지정된 구독에 대해 실행됩니다.

리소스 그룹 관리

Azure 리소스 그룹은 여러 Azure 리소스를 논리적으로 묶어 관리하는 단위입니다.

• 리소스 그룹 생성 az group create --name MyResourceGroup --location eastus
• 리소스 그룹 목록 조회 az group list --output table
• 리소스 그룹 삭제 az group delete --name MyResourceGroup (확인 메시지에 ‘Y’를 입력하면 삭제가 진행됩니다.)

가상 머신(VM) 관리

1. VM 생성az vm create \ --resource-group MyResourceGroup \ --name MyVM \ --image UbuntuLTS \ --admin-username azureuser \ --generate-ssh-keys
   • --image 옵션으로 원하는 OS 이미지를 선택할 수 있습니다.
   • 기본적으로 SSH 키가 자동 생성되며, ~/.ssh/ 폴더에 저장됩니다.
2. VM 시작/중지/삭제 # VM 시작 az vm start --resource-group MyResourceGroup --name MyVM # VM 중지 az vm stop --resource-group MyResourceGroup --name MyVM # VM 삭제 az vm delete --resource-group MyResourceGroup --name MyVM
3. VM 목록 조회 az vm list --output table

스토리지 계정 및 네트워크 관리

1. 스토리지 계정 생성 az storage account create \ --name mystorage1234 \ --resource-group MyResourceGroup \ --location eastus \ --sku Standard_LRS
2. 가상 네트워크(VNet) 생성 az network vnet create \ --name MyVnet \ --resource-group MyResourceGroup \ --address-prefix 10.0.0.0/16 \ --subnet-name MySubnet \ --subnet-prefix 10.0.1.0/24

이처럼 다양한 Azure 리소스를 CLI 기반으로 빠르게 제어할 수 있습니다.

Azure CLI 고급 사용법

기본 사용법을 익혔다면, 이제는 좀 더 복잡한 자동화와 통합 시나리오를 살펴보겠습니다.

스크립트 자동화

• Bash 스크립트
  Linux나 macOS 환경에서 Bash 스크립트를 사용해 여러 CLI 명령어를 순차 실행할 수 있습니다. 아래 예시는 리소스 그룹 생성 → VM 배포 → 완료 후 메시지 출력 과정을 자동화한 예시입니다. #!/usr/bin/env bash RG_NAME="AutomatedRG" VM_NAME="AutoVM" echo "=== 리소스 그룹 생성 중... ===" az group create --name $RG_NAME --location eastus echo "=== VM 생성 중... ===" az vm create --resource-group $RG_NAME --name $VM_NAME --image UbuntuLTS --admin-username azureuser --generate-ssh-keys echo "=== 모든 작업이 완료되었습니다. ==="
• PowerShell 스크립트
  Windows 환경에서는 .ps1 파일로 스크립트를 만들어 동일한 로직을 수행할 수 있습니다.

이렇게 작성된 스크립트는 팀 내에서 공유하기도 쉬우며, CI 파이프라인 등에 연계하기도 편리합니다.

CI/CD 파이프라인 통합

Azure DevOps, GitHub Actions, Jenkins 등과 같은 CI/CD 도구에서 Azure CLI를 사용하면 빌드 → 테스트 → 배포 과정을 일괄 자동화할 수 있습니다.

1. GitHub Actions 예시 name: Azure Deployment on: [push] jobs: build-and-deploy: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v2 - name: Login to Azure uses: azure/login@v1 with: creds: ${{ secrets.AZURE_CREDENTIALS }} - name: Deploy Azure Resources run: | az group create --name MyRG --location eastus az vm create --resource-group MyRG --name MyVM --image UbuntuLTS --admin-username azureuser --generate-ssh-keys
2. Azure DevOps Pipeline 예시
   Azure DevOps의 azure-pipelines.yml 파일에서도 az cli 명령어를 직접 호출해 배포 작업을 진행할 수 있습니다.

개인 경험: 대규모 마이크로서비스 프로젝트에서, 각 서비스마다 Docker 이미지를 생성하고 Azure Kubernetes Service(AKS)에 배포하기 위해 Azure CLI 명령어를 CI/CD 스크립트로 구성한 적이 있습니다. 덕분에 코드가 커밋되는 순간 자동 빌드·배포가 진행되어, 개발 속도가 크게 향상되었습니다.

클라우드 쉘에서 CLI 사용

Azure 포털에는 “Cloud Shell” 기능이 내장되어 있어, 별도의 설치 없이 브라우저만으로 Azure CLI를 실행할 수 있습니다.

• Cloud Shell 시작
  1. Azure Portal에 로그인합니다.
  2. 화면 상단의 Cloud Shell 아이콘(터미널 모양)을 클릭합니다.
  3. Bash 또는 PowerShell 중 하나를 선택해 Shell 환경을 설정합니다.

Cloud Shell 환경은 Azure에서 호스팅되는 Linux 컨테이너로, Azure CLI가 이미 설치되어 있습니다. 별도의 설치 과정 없이 즉시 사용 가능하므로 간편하지만, 장시간 사용 시 세션이 만료될 수 있으므로 필요한 스크립트는 GitHub나 Azure Repos에 미리 저장해두는 것이 좋습니다.

Azure CLI 업데이트 & 제거 가이드

CLI를 최신 상태로 유지하거나 필요에 따라 제거해야 할 때도 있습니다.

• Windows
  • 업데이트: az upgrade (또는 새 MSI 파일을 다운로드 후 재설치)
  • 제거:
    제어판 → 프로그램 → “Microsoft Azure CLI” 제거 또는 wmic product where name="Microsoft Azure CLI" call uninstall
• macOS
  • 업데이트: brew upgrade azure-cli
  • 제거: brew uninstall azure-cli
• Linux
  • 업데이트(Ubuntu/Debian 기준): sudo apt update && sudo apt upgrade azure-cli
  • 제거: sudo apt remove azure-cli

버전을 특정 릴리스로 고정해야 하는 상황이라면, 해당 버전의 설치 패키지나 Docker 이미지를 활용하는 방법을 추천드립니다.

설치 중 발생 가능한 문제와 해결법

“az” 명령어를 찾을 수 없음

• PATH 환경 변수 확인
  Windows라면 “시스템 속성 → 고급 → 환경 변수”에서 C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin이 등록되어 있는지 확인하세요.
  Linux, macOS에서는 echo $PATH 명령어로 확인 후, /usr/local/bin 혹은 /usr/bin 등이 포함되어 있는지 점검해야 합니다.
• 터미널 재실행
  설치 후에는 새 터미널 세션을 열어야 PATH가 제대로 반영될 때가 많습니다.

패키지 다운로드 오류

• 네트워크 점검
  안정적인 인터넷 연결을 확보합니다. 방화벽이나 프록시가 있는 환경에서는 다음처럼 환경 변수를 설정해야 할 수 있습니다. export HTTPS_PROXY=http://proxy.example.com:8080
• 설치 저장소 경로 오류
  배포판별로 저장소가 제대로 등록되지 않았을 수 있으니, 저장소 URL 및 GPG 키를 다시 확인해 보세요.

인증(로그인) 문제

• 로그인 만료
  세션이 만료되면 다시 az login을 통해 인증해야 합니다.
• 자격 증명 충돌
  여러 Azure 계정을 사용 중이면, az account clear 명령어로 임시 캐시를 비우고 다시 로그인합니다.

기타 이슈

• 버전 호환성
  특정 모듈(예: Azure PowerShell)과 충돌하는 경우, 해당 모듈을 업데이트하거나 CLI 버전을 조정해보세요.
• CLI 확장 오류
  az extension list 명령어로 설치된 확장 목록을 확인한 뒤, 필요없는 확장을 제거하거나 최신 버전으로 업데이트할 수 있습니다.

알아두면 좋은 팁 & 추가 정보

스토리지 에뮬레이터

개발 환경에서 실제 Azure 스토리지 대신 Azurite 같은 스토리지 에뮬레이터를 사용할 수 있습니다. 로컬에서 테스트한 뒤 실제 Azure 계정에 배포하면 비용과 시간 모두 절약할 수 있습니다.

CLI 자동완성 기능

• bash-completion
  Linux 환경에서는 az 명령어의 하위 옵션 자동완성을 설정할 수 있습니다. az interactive 을 실행하면 대화형 모드가 시작되어, 명령 자동완성을 더 쉽게 활용 가능합니다.

ARM 템플릿과의 연계

인프라 구성을 YAML/JSON 형태로 선언하는 Azure Resource Manager(ARM) 템플릿에 CLI를 연동하면, 대규모 인프라를 더욱 안전하게 배포할 수 있습니다.

az deployment group create \
  --name MyDeployment \
  --resource-group MyResourceGroup \
  --template-file azuredeploy.json

Terraform, Bicep 등 서드파티 도구와 혼용

Azure CLI가 편리하더라도, Terraform이나 Bicep 같은 IaC(Infrastructure as Code) 도구를 함께 사용할 때도 많습니다.

• Terraform은 멀티 클라우드 지원이 강점이고,
• Bicep은 Azure 네이티브 IaC 솔루션으로 ARM 템플릿의 간편한 문법을 제공합니다.

CLI와 병행해 사용하면 배포 후 네트워킹 세부 설정이나 장애 조치(Azure Load Balancer 재설정 등)를 명령어로 처리하는 방식도 가능합니다.

참고 자료

• Azure CLI 공식 문서: https://learn.microsoft.com/ko-kr/cli/azure/
• Azure CLI GitHub: https://github.com/Azure/azure-cli
• Microsoft Learn 튜토리얼: https://learn.microsoft.com/ko-kr/training/

결론 (요약)

az cli 설치 과정을 제대로 이해하면, Microsoft Azure 환경에서 리소스를 더욱 빠르고 효율적으로 제어할 수 있습니다. Windows, macOS, Linux 등 어떤 플랫폼을 쓰더라도 명령줄 도구의 간결함과 속도, 자동화 가능성은 개발과 운영 모두에 큰 장점을 제공합니다.

• 간편한 설치와 업데이트
  • Windows에서는 MSI 또는 PowerShell 스크립트
  • macOS에서는 Homebrew
  • Linux에서는 배포판별 패키지 관리자를 사용
• 강력한 자동화 기능
  • 스크립트, CI/CD 파이프라인, 클라우드 쉘 등을 통해 어디서든 Azure 리소스를 손쉽게 관리
• 확장성과 호환성
  • ARM 템플릿, Terraform, Bicep 등과 연동하여 대규모 인프라 운영 가능

Azure Portal에 일일이 접속하지 않아도, 명령어만 알면 원하는 리소스를 빠르고 정확하게 처리할 수 있다는 점이 CLI 사용의 가장 큰 매력입니다. 직접 azure cli 다운로드 후 azure cli 사용법을 익혀 보시면, Azure 관리를 한층 더 효율적으로 할 수 있을 것입니다.

이 글이 도움이 되셨다면, 주위 분들과 공유해 주시고 의견이나 궁금한 점이 있다면 댓글로 남겨 주세요! 즐거운 Azure 라이프 되시길 바랍니다.

자주 묻는 질문

Azure CLI는 무료인가요?

네, Azure CLI는 무료로 사용할 수 있습니다. 하지만 Azure 서비스를 이용하려면 해당 서비스 요금이 부과될 수 있습니다.

Azure CLI를 설치할 수 없는 경우 어떻게 해결하나요?

설치 과정에서 오류가 발생한다면, 관리자 권한으로 실행하거나, 인터넷 연결 상태를 확인한 후 다시 시도해 보세요. Linux에서는 패키지 관리자를 사용하여 최신 버전을 설치하는 것도 방법입니다.

Azure CLI에서 특정 명령어 실행 시 오류가 발생하면?

일부 명령어 실행 시 오류가 발생할 경우, ‘az upgrade’ 명령어로 최신 버전으로 업데이트하거나, 관련 확장(extension)이 필요한지 확인해야 합니다.

Azure CLI를 사용하여 자동화할 수 있나요?

네, Azure CLI는 스크립트와 함께 사용하여 리소스 배포, 관리 및 모니터링을 자동화할 수 있습니다. Bash 스크립트 또는 PowerShell을 활용하면 반복적인 작업을 자동화할 수 있습니다.