Linux에 Azure CLI 설치

이 문서에서는 Linux에 Azure CLI를 설치하는 방법을 설명합니다. 페이지 맨 위에 있는 옵션에서 배포에 적합한 패키지 관리자를 선택합니다. Linux 배포판의 패키지 관리자를 사용하는 것이 좋지만 설치 스크립트 옵션을 선택하여 Linux에 Azure CLI를 수동으로 설치할 수 있습니다.

Azure CLI의 현재 버전은 2.67.0입니다. 최신 릴리스에 대한 자세한 내용은 릴리스 정보를 참조하세요. 설치된 버전을 찾고 업데이트해야 하는지 확인하려면 az 버전을 실행합니다.

시작하기 전에

• Azure CLI 2.38.2 (2024년 6월 21일에 릴리스됨)는 RHEL 7 및 Centos 7에서 지원되는 마지막 버전입니다. Microsoft는 더 이상 이러한 배포에 대한 업데이트 또는 버그 수정을 제공하지 않습니다.

• Microsoft는 Azure CLI 및 Linux 설치 스크립트를 계속 개발하고 지원합니다.

• 패키지 관리자를 yum 지원하지 않는 Linux 시스템을 사용하는 경우 패키지 관리자를 dnf 사용합니다.

Azure CLI 설치

Azure CLI를 설치하려면 다음 단계를 수행합니다.

1. Microsoft 리포지토리 키를 가져옵니다.

   sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

2. RHEL 9 또는 CentOS Stream의 경우 리포지토리를 추가 packages-microsoft-com-prod 합니다.

   sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
   

   RHEL 8의 경우 리포지토리를 추가 packages-microsoft-com-prod 합니다.

   sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
   

   RHEL 7의 경우 리포지토리를 추가 azure-cli 합니다.

   echo -e "[azure-cli]
   name=Azure CLI
   baseurl=https://packages.microsoft.com/yumrepos/azure-cli
   enabled=1
   gpgcheck=1
   gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo
   

   주의

   CentOS 7 EOL(수명 종료)은 2024년 6월 30일이었습니다. Azure CLI 지원 환경에 대한 자세한 내용은 Azure CLI 지원 수명 주기를 참조 하세요.

3. 명령을 사용하여 설치합니다 dnf install .

   sudo dnf install azure-cli
   

특정 버전 설치

먼저 이전에 표시된 것처럼 리포지토리 정보를 구성 azure-cli 해야 합니다. 사용 가능한 버전은 Azure CLI 릴리스 정보에서 확인할 수 있습니다.

1. 명령을 사용하여 사용 가능한 버전을 보려면 다음을 수행합니다.

   dnf list --showduplicates azure-cli
   

2. 특정 버전을 설치하려면

   sudo dnf install azure-cli-<version>-1.el7
   

Azure CLI 업데이트

버전 2.11.0부터 Azure CLI는 최신 버전으로 업데이트하는 도구 내 명령을 제공합니다.

az upgrade

또한 이 명령은 기본적으로 설치된 모든 확장을 업데이트합니다. 자세한 az upgrade 옵션은 명령 참조 페이지를 참조 하세요. 2.11.0 이전 Azure CLI 버전의 경우 Azure CLI 설치에 설명된 대로 다시 설치하여 업데이트합니다.

또한 dnf update 명령을 사용하여 Azure CLI를 업데이트할 수 있습니다.

sudo dnf update azure-cli

Azure CLI 제거

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

1. 시스템에서 패키지를 제거합니다.

   sudo dnf remove azure-cli
   

2. CLI를 다시 설치하지 않으려면 리포지토리 정보를 제거합니다.

   sudo rm /etc/yum.repos.d/azure-cli.repo
   

3. 다른 Microsoft 패키지를 사용하지 않는 경우 서명 키를 제거합니다.

   MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
   sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
   

데이터 제거

Azure CLI를 다시 설치하지 않으려면 해당 데이터를 제거합니다.

rm -rf ~/.azure

문제 해결

를 사용하여 설치 dnf할 때 발생하는 몇 가지 일반적인 문제는 다음과 같습니다. 여기서 다루지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.

Python 3 없이 RHEL 7.6 또는 기타 시스템에 설치

가능하면 패키지를 공식적으로 지원하는 python 3.6+ 버전으로 시스템을 업그레이드합니다. 그렇지 않으면 먼저 패키지를 설치한 python3 다음 종속성 없이 Azure CLI를 설치해야 합니다.

다음 명령을 사용하여 원본에서 빌드된 Azure CLI 설치 스크립트 python 3.6 를 다운로드하고 설치할 수 있습니다.

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

단계별로 수행할 수도 있습니다.

먼저 Azure CLI는 다음을 SSL 1.1+ 빌드python3하기 전에 원본에서 빌드 openssl 1.1 해야 합니다.

sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v

그런 다음, 원본에서 Python 3을 빌드합니다.

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

마지막으로, 설치 지침의 1단계와 2단계를 수행하여 Azure CLI 리포지토리를 추가합니다. 이제 패키지를 다운로드하고 종속성 없이 설치할 수 있습니다.

참고 항목

dnf 다운로드 플러그 인이 아직 설치되어 있지 않으면 다음 코드를 실행할 때 오류가 발생 command not found 합니다. dnf install 'dnf-command(download)'를 사용하여 dnf 다운로드 플러그 인을 설치합니다.

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

또는 다른 리포지토리를 사용하여 Python 3을 설치할 수도 있습니다. 설정 python3 했지만 여전히 오류가 python3: command not found표시되는 경우 이 메서드를 사용합니다. 경로에 포함되어 있는지 확인합니다.

scl enable rh-python36 bash

프록시 연결 차단

프록시로 인해 외부 리소스에 연결할 수 없는 경우 셸에서 변수 및 HTTPS_PROXY 변수를 HTTP_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]

Important

프록시 뒤에 있는 경우 CLI를 사용하여 Azure 서비스에 연결하도록 이러한 셸 변수를 설정해야 합니다. 기본 인증을 사용하지 않는 경우 파일에서 .bashrc 이러한 변수를 내보내는 것이 좋습니다. 항상 비즈니스의 보안 정책 및 시스템 관리자의 요구 사항을 따릅니다.

이 프록시를 항상 사용하도록 명시적으로 구성할 dnf 수도 있습니다. 다음 줄이 다음 섹션 /etc/dnf/dnf.conf아래에 [main] 표시되는지 확인합니다.

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

Microsoft 서명 키와 패키지를 리포지토리에서 가져오기 위해 프록시는 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.

• https://packages.microsoft.com

CLI가 Linux용 Windows 하위 시스템 설치 또는 실행하지 못함

WSL(Linux용 Windows 하위 시스템)은 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를 설치하는 것이 좋습니다.

시작하기 전에

• Azure CLI 2.38.2 (2024년 6월 21일에 릴리스됨)는 SLES(SUSE Linux Enterprise Server) 및 OpenSUSE(Leap)에서 지원되는 최신 버전입니다. Microsoft는 더 이상 이러한 배포에 대한 업데이트 또는 버그 수정을 제공하지 않습니다.

• Microsoft는 계속해서 Azure CLI 및 Linux 설치 스크립트를 개발하고 지원합니다. SUSE는 SUSE/OpenSUSE 리포지토리에서 제공하는 패키지를 유지 관리하고 지원합니다.

• Azure에서 Azure Marketplace 이미지를 기반으로 하는 SUSE 및 OpenSUSE VM(가상 머신)에는 이미 Azure CLI가 설치되어 있습니다.

Azure CLI 설치

SUSE/OpenSUSE에 Azure CLI를 설치하려면 다음 방법 중 하나를 선택합니다.

1. SUSE/OpenSUSE 리포지토리에서 SUSE 에서 제공하는 Enterprise 패키지를 사용합니다.

2. "설치 스크립트(임의의)" 탭에 설명된 설치 방법을 사용합니다.

3. Microsoft 리포지토리에서 설치

SUSE 또는 OpenSUSE 리포지토리에서 설치

Azure CLI의 RPM 패키지는 python3 패키지에 따라 달라집니다.

sudo zypper install -y azure-cli

설치 스크립트를 사용하여 설치

설치 스크립트 옵션을 사용하여 모든 버전의 Linux에 Azure CLI를 수동으로 설치할 수 있습니다.

이 메서드를 사용하여 최신 버전으로 업데이트하는 경우 먼저 이전 버전과 해당 버전에 대해 추가한 리포지토리를 제거해야 합니다.

Microsoft 리포지토리에서 설치

Microsoft 리포지토리를 사용하여 Azure CLI의 최신 기록 버전을 설치하려면 다음 단계를 수행합니다.

(이 패키지는 에서 테스트되었습니다.SLES 15 및 OpenSUSE Leap 15.1)

1. curl 설치:

   sudo zypper install -y curl
   

2. Microsoft 리포지토리 키를 가져옵니다.

   sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

3. 로컬 azure-cli 리포지토리 정보 만들기:

   sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
   

4. 패키지 인덱스 zypper 업데이트 및 설치:

   sudo zypper install --from azure-cli azure-cli
   

   종속성 중 일부를 무시하여 설치를 계속하려면 2를 입력합니다.

특정 버전 설치

먼저 이전에 표시된 것처럼 리포지토리 정보를 구성 azure-cli 해야 합니다. 사용 가능한 버전은 Azure CLI 릴리스 정보에서 찾을 수 있습니다.

1. 다음 명령을 사용하여 사용 가능한 버전을 봅니다.

   zypper search --details --match-exact azure-cli
   

2. 특정 버전을 설치하려면

   sudo zypper install --from azure-cli azure-cli=<version>-1.el7
   

Azure CLI 업데이트

버전 2.11.0부터 Azure CLI는 최신 버전으로 업데이트하는 도구 내 명령을 제공합니다.

az upgrade

또한 이 명령은 기본적으로 설치된 모든 확장을 업데이트합니다. 자세한 az upgrade 옵션은 명령 참조 페이지를 참조 하세요. 2.11.0 이전 Azure CLI 버전의 경우 Azure CLI 설치에 설명된 대로 다시 설치하여 업데이트합니다.

명령을 사용하여 패키지를 zypper update 업데이트할 수도 있습니다.

sudo zypper refresh
sudo zypper update azure-cli

Azure CLI 제거

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

1. 시스템에서 패키지를 제거합니다.

   sudo zypper remove -y azure-cli
   

2. CLI를 다시 설치하지 않으려면 리포지토리 정보를 제거합니다.

   sudo zypper removerepo azure-cli
   

3. 다른 Microsoft 패키지를 사용하지 않는 경우 Microsoft 서명 키를 제거합니다.

   MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
   sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
   

데이터 제거

Azure CLI를 다시 설치하지 않으려면 해당 데이터를 제거합니다.

rm -rf ~/.azure

문제 해결

를 사용하여 설치 zypper할 때 발생하는 몇 가지 일반적인 문제는 다음과 같습니다. 여기서 다루지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.

Python 3 없이 설치

Important

Azure CLI의 RPM 패키지는 python3 패키지에 따라 달라집니다. 시스템에서 이 패키지는 Python 3.6.x 요구 사항 이전의 Python 버전일 수 있습니다. 이로 인해 영향을 받는 경우 python3 대체 패키지를 찾습니다.

Python 2는 2020년 1월 1일에 EOL(수명 종료)에 도달했으며 더 이상 업데이트를 받지 않습니다. Azure CLI는 버전 2.1.0 이후 Python 2.7에 대한 지원을 삭제했습니다. 최신 버전의 CLI는 Python 2.7을 사용하여 제대로 실행되지 않을 수 있습니다.

OpenSUSE 15 VM의 NotImplementedError

OpenSUSE 15 VM에는 버전 2.0.45와 함께 미리 설치된 Azure CLI가 있습니다. 이 CLI는 오래되었으며 문제가 있습니다 az login. 최신 Azure CLI를 추가하려면 설치 지침에 따라 이 버전을 종속성과 함께 제거합니다.

sudo zypper rm -y --clean-deps azure-cli

버전 2.0.45의 종속성을 제거하지 않고 Azure CLI를 업데이트한 경우 이전 종속성이 최신 버전의 Azure CLI에 영향을 줄 수 있습니다. 종속성에 연결하기 위해 이전 버전을 다시 추가한 다음 종속성과 함께 제거 azure-cli 해야 합니다.

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

Python 3.6 없이 SLES 12 또는 기타 시스템에 설치

SLES 12에서 기본 python3 패키지는 3.4이며 Azure CLI에서 지원되지 않습니다. 먼저 설치 지침의 1-3단계에 따라 리포지토리를 azure-cli 추가할 수 있습니다. 그런 다음 원본에서 더 높은 버전을 python3 빌드합니다. 마지막으로 Azure CLI 패키지를 다운로드하여 종속성 없이 설치할 수 있습니다.

다음 명령을 사용하여 위의 단계에 따라 Azure CLI를 설치하거나 업데이트할 수 있습니다. 이 스크립트는 Python 3.8을 설치 /usr/local/azcli 하고 별칭 az PATH=/usr/local/azcli/bin:$PATH az을 로 설정하여 Azure CLI에서 이를 사용하도록 합니다. 필요에 따라 스크립트를 다운로드하고 수정할 수도 있습니다. 예를 들어 Python 버전을 변경하거나 위치를 설치할 수 있습니다.

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

처음 설치하는 경우 다음 명령을 실행하여 별칭을 활성화해야 합니다.

source ~/.bashrc

프록시 연결 차단

프록시로 인해 외부 리소스에 연결할 수 없는 경우 셸에서 변수 및 HTTPS_PROXY 변수를 HTTP_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]

Important

프록시 뒤에 있는 경우 CLI를 사용하여 Azure 서비스에 연결하도록 이러한 셸 변수를 설정해야 합니다. 기본 인증을 사용하지 않는 경우 파일에서 .bashrc 이러한 변수를 내보내는 것이 좋습니다. 항상 비즈니스의 보안 정책 및 시스템 관리자의 요구 사항을 따릅니다.

이 프록시를 항상 사용하도록 명시적으로 구성 zypper (통해 yast2)할 수도 있습니다. 이렇게 하려면 명령을 superuser로 실행하고 yast2 proxy 양식에 표시된 정보를 입력합니다. 시스템에서 창 관리자를 사용할 수 있는 경우 창의 Network Services > Proxy YaST Control Center창을 사용할 수도 있습니다.

고급 구성 또는 자세한 내용은 OpenSUSE 프록시 구성 설명서를 참조 하세요.

Microsoft 서명 키를 가져와 리포지토리에서 패키지를 얻으려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.

• https://packages.microsoft.com
• https://download.opensuse.org

CLI가 Linux용 Windows 하위 시스템 설치 또는 실행하지 못함

WSL(Linux용 Windows 하위 시스템)은 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를 설치하는 것이 좋습니다.

SSL 인증서 문제

컴퓨터에서 인증서가 끊어지거나 오래된 경우 curl이 서버의 정당성을 확인하지 못하여 보안 연결을 설정할 수 없음을 나타내는 오류가 표시될 수 있습니다. 인증서를 업데이트하여 문제를 해결하세요.

sudo zypper update-ca-certificates

시작하기 전에

• apt 패키지 관리자에는 다음 배포판에서 테스트된 Azure CLI에 대한 x86_64 및 ARM64 패키지가 포함되어 있습니다.

  배포	버전
  Ubuntu	20.04 LTS (Focal Fossa), 22.04 (잠미 해파리), 24.04 (귀족 마비)
  Debian	11 (불스아이), 12 (책벌레)

• Ubuntu 20.04(Focal Fossa) 및 20.10(Groovy Gorilla)에는 리포지토리에서 제공하는 버전 2.0.81 이 포함된 universe 패키지가 포함되어 azure-cli 있습니다. 이 패키지는 오래된 것이며 권장하지 않습니다. 이 패키지가 설치된 경우 명령을 sudo apt remove azure-cli -y && sudo apt autoremove -y실행하여 계속하기 전에 패키지를 제거합니다. 자세한 내용은 apt removeUbuntu 패키지 관리를 참조하거나 ubuntu에 문의하세요.

Azure CLI 설치

시스템에 Azure CLI를 설치하는 두 가지 옵션이 있습니다. 설치 명령을 실행하는 설치 스크립트를 다운로드하거나 단계별 프로세스에서 설치 명령을 직접 실행할 수 있습니다. 두 방법 모두 여기에 제공됩니다.

옵션 1: 하나의 명령으로 설치

Azure CLI를 설치하는 가장 쉬운 방법은 Azure CLI 팀에서 유지 관리하는 스크립트를 사용하는 것입니다. 이 스크립트는 모든 설치 명령을 한 단계로 실행합니다. 이 스크립트는 curl을 통해 다운로드되고 CLI를 설치하기 위해 bash에 직접 파이프됩니다.

실행하기 전에 스크립트의 콘텐츠를 직접 검사하려면 먼저 curl을 사용하여 스크립트를 다운로드하고 즐겨 사용하는 텍스트 편집기에서 검사합니다.

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

옵션 2: 단계별 설치 지침

단계별 설치 프로세스를 선호하는 경우 다음 단계를 완료하여 Azure CLI를 설치합니다.

1. 설치 프로세스에 필요한 패키지를 가져옵니다.

   sudo apt-get update
   sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
   

2. Microsoft 서명 키를 다운로드하고 설치합니다.

   sudo mkdir -p /etc/apt/keyrings
   curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
     gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
   sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
   

3. Azure CLI 소프트웨어 리포지토리를 추가합니다.

   AZ_DIST=$(lsb_release -cs)
   echo "Types: deb
   URIs: https://packages.microsoft.com/repos/azure-cli/
   Suites: ${AZ_DIST}
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
   

4. 리포지토리 정보를 업데이트하고 패키지를 설치합니다 azure-cli .

   sudo apt-get update
   sudo apt-get install azure-cli
   

특정 버전 설치

앞서 설명한 azure-cli 대로 리포지토리 정보를 구성합니다. 사용 가능한 버전은 Azure CLI 릴리스 정보에서 확인할 수 있습니다.

1. 사용 가능한 버전의 Azure CLI를 봅니다.

   apt-cache policy azure-cli
   

2. 특정 버전을 설치합니다.

   # Obtain the currently installed distribution
   AZ_DIST=$(lsb_release -cs)
   
   # Store an Azure CLI version of choice
   AZ_VER=2.51.0
   
   # Install a specific version
   sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}
   

   변수 없이 특정 버전을 설치하려면 표시된 Azure CLI 버전 및 Linux 배포 이름을 바꿉니다.

   sudo apt-get install azure-cli=2.51.0-1~bullseye
   

패키지 azure-cliazure-cli를 찾을 수 없다는 오류 메시지가 표시되면 리포지토리 정보가 구성되지 않습니다. 옵션 2: 단계별 설치 지침에 지정된 단계를 따릅니다.

azure-cli에 대한 Version x.xx.x-1~distributionName 오류 메시지가 표시되는 경우 실행 중인 배포를 찾는 데 사용합니다lsb_release -cs.

Azure CLI 업데이트

버전 2.11.0부터 Azure CLI는 최신 버전으로 업데이트하는 도구 내 명령을 제공합니다.

az upgrade

또한 이 명령은 기본적으로 설치된 모든 확장을 업데이트합니다. 자세한 az upgrade 옵션은 명령 참조 페이지를 참조 하세요. 2.11.0 이전 Azure CLI 버전의 경우 Azure CLI 설치에 설명된 대로 다시 설치하여 업데이트합니다.

또한 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 제거

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

1. 다음을 apt-get remove사용하여 제거합니다.

   sudo apt-get remove -y azure-cli
   

2. CLI를 다시 설치하지 않으려면 Azure CLI 리포지토리 정보를 제거합니다.

   sudo rm /etc/apt/sources.list.d/azure-cli.sources
   

3. Microsoft에서 다른 패키지를 사용하지 않는 경우 서명 키를 제거합니다.

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. 불필요한 패키지를 제거합니다.

   sudo apt autoremove
   

데이터 제거

Azure CLI를 다시 설치하지 않으려면 해당 데이터를 제거합니다.

rm -rf ~/.azure

문제 해결

를 사용하여 설치 apt할 때 발생하는 몇 가지 일반적인 문제는 다음과 같습니다. 여기서 다루지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.

이 패키지는 azure-cli CLI 버전 2.46.0의 ARM64 아키텍처를 지원합니다.

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 올바른 기본 배포 버전을 반환하지 않습니다.

일부 Ubuntu 또는 기타 Debian 파생 배포(예: Linux Mint)는 올바른 버전 이름을 lsb_release반환하지 않을 수 있습니다. 이 값은 설치 프로세스에서 설치할 패키지를 결정하는 데 사용됩니다. 배포에서 파생된 Ubuntu 또는 Debian 버전의 코드 이름을 알고 있는 경우 리포지토리를 AZ_REPO 추가할 때 수동으로 값을 설정할 수 있습니다. 그렇지 않으면 기본 배포 코드 이름을 확인하고 올바른 값으로 설정하는 AZ_REPO 방법에 대한 배포 정보를 조회합니다.

배포용 패키지 없음

배포 버전 릴리스 후에 업데이트된 Azure CLI 패키지를 즉시 사용할 수 없는 경우가 있습니다. Azure CLI는 향후 종속성 버전에 탄력적이 되도록 설계되었으며 가능한 한 적은 수의 종속성을 사용합니다. 기본 배포에 사용할 수 있는 패키지가 없는 경우 이전 배포용 패키지를 사용해 보세요.

이전 배포에 대한 패키지를 시도하려면 리포지토리를 추가할 때 수동으로 값을 AZ_REPO 설정합니다. Ubuntu 배포의 경우 최신 jammy 리포지토리를 사용합니다.

AZ_REPO="jammy"

Debian 배포의 경우 최신 bookworm 리포지토리를 사용합니다.

AZ_REPO="bookworm"

Important

Ubuntu Bionic 및 Debian Buster 이전에 릴리스된 배포는 지원되지 않습니다.

기본 OS(EOS)가 Azure CLI를 설치하지 못함

EOS 릴리스 이름인 반환 HERA때문에 EOS에서 Azure CLI lsb_release 를 설치하지 못합니다. 이 솔루션은 파일 /etc/apt/sources.list.d/azure-cli.sources를 수정하고 Suites: hera을 Suites: bionic으로 변경하는 것입니다.

원본 파일 내용:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

수정된 파일 내용

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

프록시 연결 차단

프록시로 인해 외부 리소스에 연결할 수 없는 경우 셸에서 변수 및 HTTPS_PROXY 변수를 HTTP_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]

Important

프록시 뒤에 있는 경우 CLI를 사용하여 Azure 서비스에 연결하도록 이러한 셸 변수를 설정해야 합니다. 기본 인증을 사용하지 않는 경우 파일에서 .bashrc 이러한 변수를 내보내는 것이 좋습니다. 항상 비즈니스의 보안 정책 및 시스템 관리자의 요구 사항을 따릅니다.

이 프록시를 항상 사용하도록 명시적으로 구성할 apt 수도 있습니다. 구성 파일에 다음 줄이 표시되는지 apt 확인합니다 /etc/apt/apt.conf.d/. 기존 전역 구성 파일, 기존 프록시 구성 파일 40proxies또는 99local시스템 관리 요구 사항을 따르는 것이 좋습니다.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

프록시에서 기본 인증 을 사용하지 않는 경우 프록시 URI 부분을 제거 [username]:[password]@ 합니다. 프록시 구성에 대한 자세한 내용은 다음과 같은 공식 Ubuntu 문서를 참조하세요.

• apt.conf man 페이지
• Ubuntu wiki - apt-get howto

Microsoft 서명 키를 가져와 리포지토리에서 패키지를 얻으려면 프록시가 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.https://packages.microsoft.com.

CLI가 Linux용 Windows 하위 시스템 설치 또는 실행하지 못함

WSL(Linux용 Windows 하위 시스템)은 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를 설치하는 것이 좋습니다.

Azure CLI 설치

RRPM은 CBL-Mariner를 통해 Azure Linux용으로 릴리스됩니다. 이 패키지는 azure-cli CLI 버전 2.46.0의 ARM64 아키텍처를 지원합니다.

Azure CLI를 설치하려면 다음 단계를 수행합니다.

1. 신뢰할 수 있는 루트 인증서의 공식 Microsoft 큐레이팅 집합을 설치합니다.

   sudo tdnf install ca-certificates
   

2. Azure CLI 설치:

   sudo tdnf install azure-cli
   

특정 버전 설치

사용 가능한 버전은 Azure CLI 릴리스 정보에서 확인할 수 있습니다.

명령을 사용하여 사용 가능한 버전을 보려면 다음을 수행합니다.

tdnf list azure-cli

특정 버전을 설치하려면 다음을 수행합니다.

sudo tdnf install azure-cli-<version>-1

Azure CLI 업데이트

tdnf update 명령을 사용하여 Azure CLI를 업데이트합니다.

sudo tdnf update azure-cli

Azure CLI 제거

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

시스템에서 패키지를 제거합니다.

sudo tdnf remove azure-cli

데이터 제거

Azure CLI를 다시 설치하지 않으려면 해당 데이터를 제거합니다.

rm -rf ~/.azure

시작하기 전에

패키지 관리자를 사용하여 CLI를 설치하는 것이 좋습니다. 패키지 관리자는 항상 최신 업데이트를 받도록 하고 CLI 구성 요소의 안정성을 보장합니다. 수동으로 설치하기 전에 배포용 패키지가 있는지 확인하고 확인합니다.

Azure CLI에 대한 설치 스크립트에는 다음 소프트웨어가 필요합니다.

• Python 3.8.x, 3.9.x, 3.10.x - 자세한 내용은 지원 수명 주기 - Python 종속성을 참조 하세요.
• libffi
• OpenSSL 1.0.2

Azure CLI 설치 또는 업데이트

Important

설치 스크립트는 Python 3.8.x, 3.9.x 또는 3.10.x에서만 작동합니다. 이 설치 스크립트는 Python 3.11.x 이상 버전에서는 작동하지 않습니다.

Azure CLI를 설치하고 업데이트하려면 설치 스크립트를 다시 실행해야 합니다.

curl -L https://aka.ms/InstallAzureCli | bash

또한 스크립트를 다운로드하여 로컬로 실행할 수 있습니다. 변경 내용을 적용하려면 셸을 다시 시작해야 할 수 있습니다.

Azure CLI 제거

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

설치 시 선택한 위치에서 파일을 직접 삭제하여 CLI를 제거합니다. 기본 설치 위치는 사용자의 홈 디렉터리($HOME)입니다.

1. 설치된 CLI 파일을 제거합니다.

   rm -r <install location>/lib/azure-cli
   rm <install location>/bin/az
   

2. $HOME/.bash_profile 파일을 수정하여 다음 선을 제거합니다.

   <install location>/lib/azure-cli/az.completion
   

3. 사용하거나 zsh사용하는 bash 경우 셸의 명령 캐시를 다시 로드합니다.

   hash -r
   

데이터 제거

Azure CLI를 다시 설치하지 않으려면 해당 데이터를 제거합니다.

rm -rf ~/.azure

문제 해결

수동 설치 중에 몇 가지 공통 문제가 발견됐습니다. 여기서 다루지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.

Python 3 없이 설치

Azure CLI는 버전 2.1.0 이후 Python 2.7에 대한 지원을 삭제했습니다. 시스템에서 Python 3.6.x의 요구 사항보다 이전의 Python 버전이 있을 수 있습니다. 대체 python3 패키지를 찾습니다.

“개체 이동됨” curl 오류

매개 변수와 관련된 -L 오류 curl 나 "개체 이동" 텍스트를 포함한 오류 메시지가 표시되면 리디렉션 대신 전체 URL을 aka.ms 사용해 보세요.

curl https://azurecliprod.blob.core.windows.net/install | bash

az 명령을 찾을 수 없음

설치 bash zsh후 명령을 실행할 수 없거나 셸의 명령 해시 캐시를 지우고 문제가 해결되었는지 확인합니다.

hash -r

설치 후 셸을 다시 시작하지 않아도 이 문제가 발생할 수 있습니다. 명령의 위치가 az .에 있는지 확인합니다 $PATH. 명령의 az 위치는 ...

 <install path>/bin

프록시 연결 차단

프록시로 인해 외부 리소스에 연결할 수 없는 경우 셸에서 변수 및 HTTPS_PROXY 변수를 HTTP_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]

Important

프록시 뒤에 있는 경우 CLI를 사용하여 Azure 서비스에 연결하도록 이러한 셸 변수를 설정해야 합니다. 기본 인증을 사용하지 않는 경우 파일에서 .bashrc 이러한 변수를 내보내는 것이 좋습니다. 항상 비즈니스의 보안 정책 및 시스템 관리자의 요구 사항을 따릅니다.

설치 스크립트를 가져오려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.

• https://aka.ms/
• https://azurecliprod.blob.core.windows.net/
• https://pypi.python.org
• 배포의 패키지 관리자(있는 경우)에서 사용하는 코어 패키지에 대한 엔드포인트

CLI가 Linux용 Windows 하위 시스템 설치 또는 실행하지 못함

WSL(Linux용 Windows 하위 시스템)은 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를 설치하는 것이 좋습니다.

다음 단계

Azure CLI를 설치한 후 해당 기능 및 일반 명령을 잠시 둘러보세요.

Azure CLI 시작