macOS에 Azure CLI 설치

CLI(Azure 명령줄 인터페이스)를 사용하면 대화형 명령줄 프롬프트 또는 스크립트를 사용하여 터미널을 통해 명령을 실행할 수 있습니다. macOS 컴퓨터에 로컬로 Azure CLI를 설치할 수 있습니다. macOS의 Azure CLI를 사용하면 대화형 명령줄 프롬프트 또는 스크립트를 사용하여 터미널을 통해 다양한 명령을 실행할 수 있습니다.

macOS 플랫폼의 경우 homebrew 패키지 관리자를 사용하여 Azure CLI를 설치할 수 있습니다. Homebrew를 사용하면 CLI 업데이트를 최신 상태로 쉽게 설치할 수 있습니다. CLI 패키지는 macOS 버전 10.9 이상에서 테스트 되었습니다.

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

Homebrew를 사용하여 설치

Homebrew는 CLI 설치를 관리하는 가장 쉬운 방법입니다. 설치, 업데이트 및 제거할 수 있는 편리한 방법을 제공합니다. 시스템에서 homebrew를 사용할 수 없는 경우 계속하기 전에 homebrew 를 설치합니다.

brew 리포지토리 정보를 업데이트한 다음 명령을 실행하여 macOS에 Azure CLI를 설치할 install 수 있습니다.

brew update && brew install azure-cli

문제 해결

Homebrew를 통해 CLI를 설치할 때 문제가 발생하는 경우 몇 가지 일반적인 오류는 다음과 같습니다. 여기서 다루지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.

완료가 작동하지 않음

Azure CLI의 Homebrew 수식은 Homebrew 관리 완료 디렉터리에 명명된 az 완료 파일을 설치합니다(기본 위치는 /usr/local/etc/bash_completion.d/). 완료를 사용하도록 설정하려면 여기에 있는 Homebrew의 지침을 따르세요.

Zsh의 .zshrc 경우 파일 아래쪽에 다음 두 줄을 추가한 다음 Zsh 프로필을 저장하고 다시 로드합니다.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Python 또는 설치된 패키지를 찾을 수 없음

homebrew 설치 중에 부 버전 불일치 또는 기타 문제가 있을 수 있습니다. CLI는 Python 가상 환경을 사용하지 않으므로 설치된 Python 버전을 찾는 데 의존합니다. 가능한 해결 방법은 Homebrew에서 종속성을 설치하고 다시 연결하는 python@3.10 것입니다.

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

CLI 버전 1.x가 설치됨

낮은 버전이 설치된 경우 부실한 homebrew 캐시로 인한 것일 수 있습니다. 업데이트 지침을 따르세요.

프록시 연결 차단

프록시를 사용하도록 올바르게 구성하지 않으면 Homebrew에서 리소스를 가져올 수 없습니다. Homebrew 프록시 구성 지침을 따릅니다.

Important

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

Homebrew에서 병 리소스를 얻으려면 프록시가 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.

• https://formulae.brew.sh
• https://homebrew.bintray.com

엽데이트

CLI는 버그 수정, 개선 사항, 새로운 기능 및 미리 보기 기능으로 정기적으로 업데이트됩니다. 약 3주마다 새 릴리스가 제공됩니다.

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

az upgrade

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

또한 로컬 Homebrew 리포지토리 정보를 업데이트한 후 azure-cli 패키지를 업그레이드해야 합니다.

brew update && brew upgrade azure-cli

제거

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

homebrew를 사용하여 패키지를 제거합니다 azure-cli .

brew uninstall azure-cli

데이터 제거

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

rm -rf ~/.azure

다른 설치 방법

homebrew를 사용하여 환경에 Azure CLI를 설치할 수 없는 경우 Linux에 대한 수동 지침을 사용할 수 있습니다. 이 프로세스는 공식적으로 기본 macOS와 호환되지 않습니다. Homebrew와 같은 패키지 관리자를 사용하는 것이 좋습니다. 다른 옵션을 사용할 수 없는 경우에만 수동 설치 방법을 사용합니다.

수동 설치 지침은 Linux에 Azure CLI 수동 설치를 참조하세요.

다음 단계

이제 macOS에 Azure CLI를 설치했으므로 해당 기능 및 일반적인 명령을 간단히 살펴보세요.

Azure CLI 시작