Linux에 Azure CLI 수동 설치Install Azure CLI on Linux manually

배포를 위한 Azure CLI용 패키지가 없다면 스크립트를 실행하여 수동으로 CLI를 설치하십시오.If there's no package for the Azure CLI for you your distribution, install the CLI manually by running a script.

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.

참고

패키지 관리자를 사용하여 CLI를 설치하는 것이 좋습니다.It's strongly recommend to install the CLI with a package manager. 패키지 관리자가 항상 최신 업데이트를 갖추도록 확인하고 CLI 구성 요소의 안정성을 보장합니다.A package manager makes sure you always get the latest updates, and guarantees the stability of CLI components. 수동으로 설치하기 전에 배포에 필요한 패키지가 있는지 확인합니다.Check and see if there is a package for your distribution before installing manually.

필수 조건Prerequisites

CLI에는 다음과 같은 소프트웨어가 필요합니다.The CLI requires the following software:

중요

CLI는 2020년 1월 1일에 종료되는 Python 2.7.x와도 호환됩니다.The CLI is also compatible with Python 2.7.x, which is being end-of-lifed on January 1, 2020. 향후 버전의 Azure CLI에서는 Python 2.7에 대한 지원이 중단됩니다.A future version of Azure CLI will drop support for Python 2.7. 이러한 이유로 CLI를 실행하려면 Python 3을 설치하는 것이 좋습니다.For this reason we recommend that you install Python 3 to run the CLI.

설치 또는 업데이트Install or update

CLI 설치 및 업데이트 모두 설치 스크립트를 다시 실행해야 합니다.Both installing and updating the CLI requires re-running the install script. curl을 실행하여 CLI를 설치합니다.Install the CLI by running curl.

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

또한 스크립트를 다운로드하여 로컬로 실행할 수 있습니다.The script can also be downloaded and run locally. 변경 내용을 적용하려면 셸을 다시 시작해야 합니다.You may have to restart your shell in order for changes to take effect.

그런 다음 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

수동 설치 중에 몇 가지 공통 문제가 발견됐습니다.Here are some common problems seen during a manual installation. 여기서 다루지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.If you experience a problem not covered here, file an issue on GitHub.

"개체 이동됨" curl 오류curl "Object Moved" error

-L 매개 변수와 관련된 curl에서 오류가 발생하거나 "개체 이동됨"이라는 텍스트가 포함된 오류 메시지가 표시되면 aka.ms 리디렉션 전체 URL을 사용해 보세요.If you get an error from curl related to the -L parameter, or an error message including the text "Object Moved", try using the full URL instead of the aka.ms redirect:

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

az 명령을 찾을 수 없음az command not found

설치 후 명령을 실행할 수 없는 경우 bash 또는 zsh를 이용해 셸의 명령 해시 캐시를 지웁니다.If you can't run the command after installation and using bash or zsh, clear your shell's command hash cache. 다음을 실행합니다.Run

hash -r

한 다음 문제가 해결되었는지 확인합니다.and check if the problem is resolved.

설치 후 셸을 다시 시작하지 않아도 이 문제가 발생할 수 있습니다.The issue can also occur if you didn't restart your shell after installation. az 명령의 위치가 $PATH여야 합니다.Make sure that the location of the az command is in your $PATH. az 명령의 위치는 다음과 같습니다.The location of the az command is

<install path>/bin

프록시 연결 차단Proxy blocks connection

프록시로 인해 외부 리소스에 연결할 수 없는 경우 셸에서 HTTP_PROXYHTTPS_PROXY 변수를 올바르게 설정했는지 확인합니다.If you're unable to connect to an external resource due to a proxy, make sure that you've correctly set the HTTP_PROXY and HTTPS_PROXY variables in your shell. 이러한 프록시에 사용할 호스트와 포트를 확인하려면 시스템 관리자에게 문의해야 합니다.You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

이러한 값은 설치 프로세스에서 사용되는 값을 포함하여 많은 Linux 프로그램에서 사용합니다.These values are respected by many Linux programs, including those which are used in the install process. 이러한 값을 설정하려면 다음을 수행합니다.To set these values:

# 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 서비스에 연결하도록 설정해야 합니다.If you are behind a proxy, these shell variables 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.

설치 스크립트를 가져오려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.In order to get the installation scripts, your proxy needs to allow HTTPS connections to the following addresses:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • 배포의 패키지 관리자(있는 경우)에서 사용하는 코어 패키지에 대한 엔드포인트Endpoints used by your distribution's package manager (if any) for core packages

CLI가 Linux 용 Windows 하위 시스템에서 설치 또는 실행 실패CLI fails to install or run on Windows Subsystem for Linux

Linux용 Windows 하위 시스템(WSL)이 Windows 플랫폼 상단의 시스템 호출 변환 레이어이기 때문에 Azure CLI를 설치하거나 실행할 때 오류가 발생할 수 있습니다.Since Windows Subsystem for Linux (WSL) is a system call translation layer on top of the Windows platform, you might experience an error when trying to install or run the Azure CLI. CLI는 WSL에서 버그가 있을 수 있는 몇 가지 기능을 사용합니다.The CLI relies on some features that may have a bug in WSL. CLI를 설치 하는 방법에 관계 없이 오류가 발생하는 경우, 이는 CLI 설치 프로세스는 상관 없이 WSL 문제일 가능성이 높습니다.If you experience an error no matter how you install the CLI, there's a good chance it's an issue with WSL and not with the CLI install process.

WSL 설치 문제를 해결하려면 다음을 수행합니다.To troubleshoot your WSL installation and possibly resolve issues:

  • 가능한 경우 Linux 컴퓨터 또는 VM에 동일한 설치 프로세스를 실행하여 성공하는지 알아봅니다.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. 성공하는 경우 문제는 거의 확실히 WSL과 관련이 있습니다.If it does, your issue is almost certainly related to WSL. Azure에서 Linux VM을 시작하려면 Azure Portal에서 Linux VM 만들기 설명서를 참조합니다.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • 최신 버전의 WSL를 실행하고 있는지 확인합니다.Make sure that you're running the latest version of WSL. 최신 버전을 가져오려면 Windows 10 설치를 업데이트합니다.To get the latest version, update your Windows 10 installation.
  • WSL의 미해결 문제가 있는지 확인하여 문제를 해결할 수도 있습니다.Check for any open issues with WSL which might address your problem. 종종 문제를 해결하는 방법에 대한 제안이나 문제가 해결될 릴리스에 대한 정보가 제공됩니다.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • 문제에 대한 기존 문제가 없는 경우 WSL로 새로운 문제를 제기하고 최대한 많은 정보를 포함시켜야 합니다.If there are no existing issues for your problem, file a new issue with WSL and make sure that you include as much information as possible.

WSL에서 설치 또는 실행 문제가 계속되면 Windows용 CLI 설치를 고려해 보세요.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

제거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.

설치 시 선택한 위치에서 파일을 직접 삭제하여 CLI를 제거합니다.Uninstall the CLI by directly deleting the files from the location chosen at the time of installation. 기본 설치 위치는 $HOME입니다.The default install location is $HOME.

  1. 설치된 CLI 파일을 제거합니다.Remove the installed CLI files.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. $HOME/.bash_profile 파일을 수정하여 다음 선을 제거합니다.Modify your $HOME/.bash_profile file to remove the following line:

    <install location>/lib/azure-cli/az.completion
    
  3. bash 또는 zsh를 사용하는 경우 셸의 명령 캐시를 다시 로드합니다.If using bash or zsh, reload your shell's command cache.

    hash -r
    

다음 단계Next Steps

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