macOS에 Azure CLI 설치Install Azure CLI on macOS

macOS 플랫폼의 경우 homebrew 패키지 관리자를 사용하여 Azure CLI를 설치할 수 있습니다.For the macOS platform, you can install the Azure CLI with homebrew package manager. Homebrew를 사용하면 손쉽게 CLI 업데이트 설치를 최신으로 유지할 수 있습니다.Homebrew makes it easy to keep your installation of the CLI update to date. CLI 패키지는 macOS 버전 10.9 이상에서 테스트 되었습니다.The CLI package has been tested on macOS versions 10.9 and later.

Azure CLI의 현재 버전은 __2.0.81__입니다.The current version of the Azure CLI is 2.0.81. 최신 릴리스에 대한 자세한 내용은 릴리스 정보를 참조하세요.For information about the latest release, see the release notes. 설치된 버전을 찾고 업데이트해야 할지 여부를 확인하려면 az --version을 실행합니다.To find your installed version and see if you need to update, run az --version.

Homebrew로 설치Install with Homebrew

Homebrew는 CLI 설치를 관리하는 가장 쉬운 방법입니다.Homebrew is the easiest way to manage your CLI install. 설치, 업데이트 및 제거 하는 편리한 방법을 제공 합니다.It provides convenient ways to install, update, and uninstall. 시스템에 homebrew가 없는 경우 homebrew를 설치한 후 계속 진행하세요.If you don't have homebrew available on your system, install homebrew before continuing.

brew 리포지토리 정보를 업데이트한 후 install 명령을 실행하여 CLI를 설치할 수 있습니다.You can install the CLI by updating your brew repository information, and then running the install command:

brew update && brew install azure-cli

중요

Azure CLI는 Homebrew python3 패키지에 종속되어 있으므로 이 패키지를 설치합니다.The Azure CLI has a dependency on the Homebrew python3 package, and will install it. Azure CLI는 Homebrew에 게시된 최신 버전의 python3과 호환되도록 보장됩니다.The Azure CLI is guaranteed to be compatible with the latest version of python3 published on Homebrew.

그런 다음 az 명령을 사용하여 Azure CLI를 실행할 수 있습니다.You can then run the Azure CLI with the az command. 로그인하려면, az login 명령을 사용합니다.To sign in, use az login command.

  1. login 명령을 실행합니다.Run the login command.

    az login
    

    CLI는 기본 브라우저를 열 수 있으면 기본 브라우저를 열고 Azure 로그인 페이지를 로드합니다.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    그렇지 않으면 https://aka.ms/devicelogin에서 브라우저 페이지를 열고 터미널에 표시된 권한 부여 코드를 입력합니다.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. 브라우저에서 계정 자격 증명으로 로그인합니다.Sign in with your account credentials in the browser.

다른 인증 방법에 대한 자세한 내용은 Azure CLI로 로그인을 참조하세요.To learn more about different authentication methods, see Sign in with Azure CLI.

문제 해결Troubleshooting

Homebrew 통해 CLI를 설치하는 경우 문제가 발생하는 경우 몇 가지 공용 오류가 있습니다.If you encounter a problem when installing the CLI through Homebrew, here are some common errors. 여기에서 다루지 않는 문제가 발생하는 경우, github에 문제를 제출합니다.If you experience a problem not covered here, file an issue on github.

Python 또는 설치된 패키지를 찾을 수 없음Unable to find Python or installed packages

homebrew 설치 중 사소한 버전 불일치 또는 다른 문제가 있을 수 있습니다.There may be a minor version mismatch or other issue during homebrew installation. CLI는 Python 가상 환경을 사용하지 않으므로, 설치된 Python 버전을 찾는 것에 의존합니다.The CLI doesn't use a Python virtual environment, so it relies on finding the installed Python version. 가능한 수정 방법은 프로그램을 설치하고 Homebrew에서 python3 종속성을 다시 연결하는 것입니다.A possible fix is to install and relink the python3 dependency from Homebrew.

brew update && brew install python3 && brew upgrade python3
brew link --overwrite python3

CLI 버전 1.x가 설치되었습니다CLI version 1.x is installed

낮은 버전이 설치된 경우 부실한 homebrew 캐시로 인한 것일 수 있습니다.If an out-of-date version was installed, it could be because of a stale homebrew cache. 업데이트 지침을 따르세요.Follow the update instructions.

프록시 연결 차단Proxy blocks connection

프록시를 사용하도록 올바르게 구성하지 않으면 Homebrew에서 리소스를 가져올 수 없습니다.You may be unable to get resources from Homebrew unless you have correctly configured it to use your proxy. Homebrew 프록시 구성 지침을 따르세요.Follow the Homebrew proxy configuration instructions.

중요

프록시를 지원하는 경우 CLI를 사용하여 HTTP_PROXYHTTPS_PROXY를 Azure 서비스에 연결하도록 설정해야 합니다.If you are behind a proxy, HTTP_PROXY and HTTPS_PROXY must be set to connect to Azure services with the CLI. 기본 인증을 사용하지 않는 경우 .bashrc 파일에서 이러한 변수를 내보내는 것이 좋습니다.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. 항상 회사의 보안 정책과 시스템 관리자의 요구 사항을 따르세요.Always follow your business' security policies and the requirements of your system administrator.

Homebrew에서 bottle 리소스를 가져오려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.In order to get the bottle resources from Homebrew, your proxy needs to allow HTTPS connections to the following addresses:

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

업데이트Update

CLI는 버그 픽스, 향상된 기능, 새로운 기능 및 미리 보기 기능이 정기적으로 업데이트됩니다.The CLI is regularly updated with bug fixes, improvements, new features, and preview functionality. 약 2주마다 새 릴리스가 제공됩니다.A new release is available roughly every two weeks. 로컬 리포지토리 정보를 업데이트한 후 azure-cli 패키지를 업그레이드해야 합니다.Update your local repository information and then upgrade the azure-cli package.

brew update && brew upgrade azure-cli

제거Uninstall

Azure CLI를 제거하려는 경우 유감스럽게 생각합니다.If you decide to uninstall the Azure CLI, we're sorry to see you go. 제거하기 전에 az feedback 명령을 사용하여 향상 또는 수정할 사항을 알려주세요.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. 우리 목표는 Azure CLI를 버그가 없고 사용자에게 친숙하게 만드는 것입니다.Our goal is to make the Azure CLI bug-free and user-friendly. 버그가 발생한 경우 GitHub 문제를 제출해주시면 감사하겠습니다.If you found a bug, we'd appreciate it if you file a GitHub issue.

Homebrew를 사용하여 azure-cli 패키지를 제거합니다.Use homebrew to uninstall the azure-cli package.

brew uninstall azure-cli

다른 설치 방법Other installation methods

Homebrew를 사용하여 사용자 환경에 Azure CLI를 설치할 수 없는 경우 Linux용 설명서 지침을 사용할 수 있습니다.If you can't use homebrew to install the Azure CLI in your environment, it's possible to use the manual instructions for Linux. 이 프로세스는 공식적으로 macOS와 호환되도록 유지되지 않습니다.Note that this process is not officially maintained to be compatible with macOS. Homebrew와 같은 패키지 관리자를 사용하는 것이 항상 권장됩니다.Using a package manager such as Homebrew is always recommended. 사용할 수 있는 다른 옵션이 없는 경우에만 수동 설치 방법을 사용합니다.Only use the manual installation method if you have no other option available.

수동 설치 지침은 Linux에 Azure CLI 수동 설치를 참조하세요.For the manual installation instructions, see Install Azure CLI on Linux manually.

다음 단계Next Steps

Azure CLI를 설치한 후 해당 기능 및 일반 명령을 잠시 둘러보세요.Now that you've installed the Azure CLI, take a short tour of its features and common commands.