Azure CLI는 Linux 컴퓨터에 로컬로 설치할 수 있는 플랫폼 간 명령줄 도구입니다. Linux용 Azure CLI를 사용하면 Azure에 연결하고 Azure 리소스에서 관리 명령을 실행할 수 있습니다. Linux에서 CLI를 사용하면 대화형 명령줄 프롬프트 또는 스크립트를 사용하여 터미널을 통해 다양한 명령을 실행할 수 있습니다. Linux에 Azure CLI를 설치할 준비가 되면 Linux 배포의 패키지 관리자를 사용하는 것이 좋습니다. 위의 옵션에서 배포에 적합한 패키지 관리자를 선택합니다. 나열된 패키지 관리자 중 하나가 없는 경우 설치 스크립트 옵션을 선택하여 Linux에 Azure CLI를 수동으로 설치할 수 있습니다.
Azure CLI의 현재 버전은 2.35.0 입니다. 최신 릴리스에 대한 자세한 내용은 릴리스 정보를 참조하세요. 설치된 버전을 찾고 업데이트해야 할지 여부를 확인하려면 az version을 실행합니다.
개요
apt 패키지 관리자에는 다음 배포에서 테스트된 Azure CLI용 x86_64 패키지가 포함되어 있습니다.
| Ubuntu | 16.04 LTS(Xenial Xerus), 18.04 LTS(Bionic Beaver), 20.04 LTS(Focal Fossa), 21.10(Impish Indri), 22.04(Jammy Jellyfish) |
| Debian | 9(Stretch), 10(Buster), 11(Bullseye) |
경고
Azure CLI 2.34.0부터 Ubuntu 14.04(Trusty Tahir) 및 Debian 8(Jessie)에 대한 DEB 패키지가 릴리스되지 않습니다. 이러한 시스템에서 Azure CLI의 이전 버전을 계속 사용할 수 있지만 업데이트 또는 버그 수정은 없습니다. 최신 Azure CLI를 사용하도록 최신 버전의 Ubuntu 또는 Debian으로 업그레이드하는 것이 좋습니다.
경고
Ubuntu 20.04(Focal Fossa) 및 20.10(Groovy Gorilla)에는 universe 리포지토리에서 제공하는 2.0.81 버전의 azure-cli 패키지가 있습니다. 이 패키지는 오래된 것이며 권장하지 않습니다. 이 패키지가 설치된 경우 계속하기 전에 sudo apt remove azure-cli -y && sudo apt autoremove -y 명령을 실행하여 패키지를 제거합니다.
azure-cli deb 패키지는 ARM64 아키텍처를 지원하지 않습니다.
설치 옵션
시스템에 Azure CLI를 설치하는 두 가지 옵션이 있습니다. 먼저 설치 스크립트를 다운로드하고 설치 명령을 실행하는 단일 명령을 실행할 수 있습니다. 또는 원하는 경우 단계별 프로세스에서 직접 설치 명령을 실행할 수 있습니다. 두 방법 모두 아래에 제공됩니다.
옵션 1: 하나의 명령을 사용하여 설치
Azure CLI 팀은 모든 설치 명령을 한 번에 실행하는 스크립트를 관리합니다. 이 스크립트는 curl을 통해 다운로드하고 bash에 직접 파이프하여 CLI를 설치할 수 있습니다.
실행하기 전에 스크립트의 내용을 직접 검사하려면 먼저 curl을 사용하여 스크립트를 다운로드하고 선호하는 텍스트 편집기에서 검사합니다.
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
옵션 2: 단계별 설치 지침
단계별 설치 프로세스를 선호하는 경우 다음 단계를 완료하여 Azure CLI를 설치합니다.
- 설치 프로세스에 필요한 패키지를 가져옵니다.
sudo apt-get update sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg - Bash복사
- Microsoft 서명 키를 다운로드하고 설치합니다.
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null - Bash복사
-
Azure CLI 소프트웨어 리포지토리를 추가합니다.Bash복사
AZ_REPO=$(lsb_release -cs) echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" | sudo tee /etc/apt/sources.list.d/azure-cli.list - 리포지토리 정보를 업데이트하고 azure-cli 패키지를 설치합니다.
sudo apt-get update sudo apt-get install azure-cli - Bash복사
특정 버전 설치
먼저 위와 같이 azure-cli 리포지토리 정보를 구성해야 합니다. 사용 가능한 버전은 Azure CLI 릴리스 정보에서 확인할 수 있습니다.
- 명령을 사용하여 사용 가능한 버전을 보려면 다음을 수행합니다.
apt-cache policy azure-cli - Bash복사
- 특정 버전을 설치하려면 다음을 수행합니다.
sudo apt-get install azure-cli=<version>-1~bullseye - Bash복사
문제 해결
apt을 사용해 설치할 때 몇 가지 일반적인 문제가 여기에 표시됩니다. 여기에서 다루지 않는 문제가 발생하는 경우, github에 문제를 제출합니다.
Ubuntu 20.04(Focal)/WSL에서 모듈 문제 없음
수동 설치 지침의 3단계에서 또는 스크립트를 사용하여 Azure CLI 소프트웨어 리포지토리를 추가하지 않고 Focal에 azure-cli를 설치한 경우 설치한 패키지가 focal/universe 리포지토리의 오래된 azure-cli 2.0.81이므로 '디코레이터' 또는 'antlr4'라는 이름의 모듈이 없는 등의 문제가 발생할 수 있습니다. 먼저 sudo apt remove azure-cli -y && sudo apt autoremove -y를 실행하여 제거한 후 위의 지침을 따라 최신 azure-cli 패키지를 설치하세요.
lsb_release가 올바른 기본 배포 버전을 반환하지 않습니다.
Linux Mint 같은 일부 Ubuntu 또는 Debian 파생 배포판은 lsb_release로부터 올바른 버전 이름을 반환하지 않을 수 있습니다. 이 값은 설치 과정에서 패키지 설치를 확인하는 데 사용됩니다. 배포본이 파생된 Ubuntu 또는 Debian 버전의 코드 이름을 알고 있다면 리포지토리를 추가할 때 수동으로 AZ_REPO 값을 설정할 수 있습니다. 그렇지 않은 경우 귀하의 배포에 대해 기본 배포 코드 이름을 확인하고 AZ_REPO를 올바른 값으로 설정 하는 방법에 대해 알아봅니다.
배포에 필요한 패키지가 없음
배포본이 릴리스된 후에 Azure CLI 패키지가 제공되기까지는 어느 정도 시간이 걸릴 수 있습니다. Azure CLI는 향후 버전의 종속성에 대해 탄력성을 갖도록 설계되었으며 가능한 한 적게 의존합니다. 기본 배포에 사용할 수 있는 패키지가 없는 경우 이전 배포 패키지를 시도합니다.
이를 위해, 리포지토리를 추가할 때 수동으로 AZ_REPO 값을 설정합니다. Ubuntu 배포의 경우 bionic 리포지토리를 사용하고 Debian 배포판의 경우 stretch를 사용합니다. Ubuntu Trusty 및 Debian Wheezy 이전에 릴리스된 배포는 지원되지 않습니다.
기본 OS(EOS)가 Azure CLI를 설치하지 못함
lsb_release가 EOS 릴리스 이름인 HERA를 반환하므로 EOS가 Azure cli를 설치하지 못합니다. 이 솔루션은 파일 /etc/apt/sources.list.d/azure-cli.list를 수정하고 hera main을 bionic main으로 변경하는 것입니다.
원래 파일 콘텐츠:
deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main
수정된 파일 콘텐츠
deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main
프록시 연결 차단
프록시로 인해 외부 리소스에 연결할 수 없는 경우 셸에서 HTTP_PROXY 및 HTTPS_PROXY 변수를 올바르게 설정했는지 확인합니다. 이러한 프록시에 사용할 호스트와 포트를 확인하려면 시스템 관리자에게 문의해야 합니다.
이러한 값은 설치 프로세스에서 사용되는 값을 포함하여 많은 Linux 프로그램에서 사용합니다. 이러한 값을 설정하려면 다음을 수행합니다.
# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]
# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]
중요
프록시를 지원하는 경우 CLI를 사용하여 이러한 셸 변수를 Azure 서비스에 연결하도록 설정해야 합니다. 기본 인증을 사용하지 않는 경우 .bashrc 파일에서 이러한 변수를 내보내는 것이 좋습니다. 항상 회사의 보안 정책과 시스템 관리자의 요구 사항을 따르세요.
이 프록시를 항상 사용하도록 명시적으로 apt를 구성할 수도 있습니다. /etc/apt/apt.conf.d/의 apt 구성 파일에 다음 줄이 표시되는지 확인합니다 기존 글로벌 구성 파일, 기존 프록시 구성 파일, 40proxies 또는 99local을 사용하는 것이 좋지만, 시스템 관리 요구 사항을 따릅니다.
Acquire {
http::proxy "http://[username]:[password]@[proxy]:[port]";
https::proxy "https://[username]:[password]@[proxy]:[port]";
}
프록시에서 기본 인증을 사용하지 않는 경우 프록시 URI의 [username]:[password]@ 부분을 제거 합니다. 프록시 구성에 대한 자세한 내용은 다음과 같은 공식 Ubuntu 문서를 참조하세요.
Microsoft 서명 키를 가져오고 리포지토리에서 패키지를 가져오려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.
CLI가 Linux 용 Windows 하위 시스템에서 설치 또는 실행 실패
Linux용 Windows 하위 시스템(WSL)이 Windows 플랫폼 상단의 시스템 호출 변환 레이어이기 때문에 Azure CLI를 설치하거나 실행할 때 오류가 발생할 수 있습니다. CLI는 WSL에서 버그가 있을 수 있는 몇 가지 기능을 사용합니다. CLI를 설치 하는 방법에 관계 없이 오류가 발생하는 경우, 이는 CLI 설치 프로세스는 상관 없이 WSL 문제일 가능성이 높습니다.
WSL 설치 문제를 해결하려면 다음을 수행합니다.
- 가능한 경우 Linux 컴퓨터 또는 VM에 동일한 설치 프로세스를 실행하여 성공하는지 알아봅니다. 성공하는 경우 문제는 거의 확실히 WSL과 관련이 있습니다. Azure에서 Linux VM을 시작하려면 Azure Portal에서 Linux VM 만들기 설명서를 참조합니다.
- 최신 버전의 WSL를 실행하고 있는지 확인합니다. 최신 버전을 가져오려면 Windows 10 설치를 업데이트합니다.
- WSL의 미해결 문제가 있는지 확인하여 문제를 해결할 수도 있습니다. 종종 문제를 해결하는 방법에 대한 제안이나 문제가 해결될 릴리스에 대한 정보가 제공됩니다.
- 문제에 대한 기존 문제가 없는 경우 WSL로 새로운 문제를 제기하고 최대한 많은 정보를 포함시켜야 합니다.
WSL에서 설치 또는 실행 문제가 계속되면 Windows용 CLI 설치를 고려해 보세요.
업데이트
CLI는 최신 버전으로 업데이트하기 위한 도구 내 명령을 제공합니다.
az upgrade
참고
az upgrade 명령은 버전 2.11.0에 추가되었으며 2.11.0 이전 버전에서는 작동하지 않습니다. Azure CLI 설치의 설명에 따라 다시 설치하여 이전 버전을 업데이트할 수 있습니다.
이 명령은 기본적으로 설치된 모든 확장도 업데이트합니다. az upgrade 옵션에 대한 자세한 내용은 명령 참조 페이지를 참조하세요.
또한 apt-get upgrade를 사용하여 CLI 패키지를 업데이트할 수 있습니다.
sudo apt-get update && sudo apt-get upgrade
참고
이 명령은 시스템에 설치되었지만 종속성이 변경되지 않은 모든 패키지를 업그레이드합니다. CLI만 업그레이드하려면 apt-get install을 사용하세요.
sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli
제거
Azure CLI를 제거하려는 경우 유감스럽게 생각합니다. 제거하기 전에 az feedback 명령을 사용하여 향상 또는 수정할 사항을 알려주세요. 우리 목표는 Azure CLI를 버그가 없고 사용자에게 친숙하게 만드는 것입니다. 버그가 발생한 경우 GitHub 문제를 제출해주시면 감사하겠습니다.
- apt-get remove를 사용하여 제거합니다.
sudo apt-get remove -y azure-cli - Bash복사
- CLI를 다시 설치할 계획이 없으면 Azure CLI 리포지토리 정보를 제거합니다.
sudo rm /etc/apt/sources.list.d/azure-cli.list - Bash복사
- Microsoft의 다른 패키지를 사용하지 않는 경우 다음과 같이 서명 키를 제거합니다.
sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg - Bash복사
- 불필요한 패키지를 제거합니다.
sudo apt autoremove - Bash복사
데이터 제거
Azure CLI를 다시 설치할 계획이 없는 경우 해당 데이터를 제거합니다.
rm -rf ~/.azure'AZURE > CLI' 카테고리의 다른 글
| Azure Cloud Shell의 기능 및 도구 (0) | 2022.05.02 |
|---|---|
| Docker 컨테이너에서 Azure CLI를 실행하는 방법 (0) | 2022.05.02 |
| az account (0) | 2022.04.25 |
| az rest (0) | 2022.04.25 |
| Windows 사용자용 Azure Cloud Shell의 PowerShell (0) | 2022.04.21 |