apt를 사용하여 Azure CLI 설치Install Azure CLI with apt

Ubuntu 또는 Debian과 같이 apt와 함께 제공되는 배포판을 실행하는 경우, Azure CLI에 x86_64 패키지를 사용할 수 있습니다.If you are running a distribution that comes with apt, such as Ubuntu or Debian, there's an x86_64 package available for the Azure CLI. 이 패키지는 다음에 대해서 테스트되었으며 지원됩니다.This package has been tested with and is supported for:

  • Ubuntu trusty, xenial, artful, bionic, discoUbuntu trusty, xenial, artful, bionic, and disco
  • Debian wheezy, jessie, stretch 및 busterDebian wheezy, jessie, stretch, and buster

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.

참고

Azure CLI용 패키지는 자체 Python 인터프리터를 설치하고 시스템 Python을 사용하지 않습니다.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

설치Install

apt를 지원하는 배포판을 사용하여 Azure CLI를 설치하는 두 가지 방법을 제공합니다. 설치 명령을 실행하는 올인원 스크립트 및 단계별 절차로 직접 실행할 수 있는 지침.We offer two ways to install the Azure CLI with distributions that support apt: As an all-in-one script that runs the install commands for you, and instructions that you can run as a step-by-step process on your own.

하나의 명령을 사용하여 설치Install with one command

한 번에 모든 설치 명령을 실행하는 스크립트를 제공하고 유지 관리합니다.We offer and maintain a script which runs all of the installation commands in one step. curl을 사용하고 bash로 직접 파이프하여 실행하거나 스크립트를 파일로 다운로드하여 실행 전에 검사합니다.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

중요

이 스크립트는 Ubuntu 16.04+ 및 Debian 8+에서만 검증되었습니다.This script is only verified for Ubuntu 16.04+ and Debian 8+. 다른 배포에는 작동하지 않을 수 있습니다.It may not work on other distributions. Linux Mint와 같은 파생된 배포판을 사용하는 경우 수동 설치 지침에 따라 필요한 문제 해결을 수행하세요.If you're using a derived distribution such as Linux Mint, follow the manual install instructions and perform any necessary troubleshooting.

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

수동 설치 지침Manual install instructions

슈퍼 사용자로 스크립트를 실행하지 않으려는 경우 또는 범용 스크립트가 실패할 경우 다음 단계에 따라 Azure CLI를 설치하세요.If you don't want to run a script as superuser or the all-in-one script fails, follow these steps to install the Azure CLI.

  1. 설치 프로세스에 필요한 패키지를 가져옵니다.Get packages needed for the install process:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Microsoft 서명 키를 다운로드하고 설치합니다.Download and install the Microsoft signing key:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc | 
        gpg --dearmor | 
        sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
    
  3. Azure CLI 소프트웨어 리포지토리를 추가합니다.Add the Azure CLI software repository:
    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
    
  4. 리포지토리 정보를 업데이트하고 azure-cli 패키지를 설치합니다.Update repository information and install the azure-cli package:

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

az 명령을 사용하여 Azure CLI를 실행합니다.Run the Azure CLI with the az command. 로그인하려면, az login 명령을 사용합니다.To sign in, use the 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

apt을 사용해 설치할 때 몇 가지 일반적인 문제가 여기에 표시됩니다.Here are some common problems seen when installing with apt. 여기에서 다루지 않는 문제가 발생하는 경우, github에 문제를 제출합니다.If you experience a problem not covered here, file an issue on github.

lsb_release가 올바른 기본 배포 버전을 반환하지 않습니다.lsb_release does not return the correct base distribution version

Linux Mint 같은 일부 Ubuntu 또는 Debian 파생 배포판은 lsb_release로부터 올바른 버전 이름을 반환하지 않을 수 있습니다.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. 이 값은 설치 과정에서 패키지 설치를 확인하는 데 사용됩니다.This value is used in the install process to determine the package to install. 배포본이 파생된 Ubuntu 또는 Debian 버전의 코드 이름을 알고 있다면 리포지토리를 추가할 때 수동으로 AZ_REPO 값을 설정할 수 있습니다.If you know the code name of the Ubuntu or Debian version your distribution is derived from, you can set the AZ_REPO value manually when adding the repository. 그렇지 않은 경우 귀하의 배포에 대해 기본 배포 코드 이름을 확인하고 AZ_REPO를 올바른 값으로 설정 하는 방법에 대해 알아봅니다.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

배포에 필요한 패키지가 없음No package for your distribution

배포본이 릴리스된 후에 Azure CLI 패키지가 제공되기까지는 어느 정도 시간이 걸릴 수 있습니다.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. Azure CLI는 향후 버전의 종속성에 대해 탄력성을 갖도록 설계되었으며 가능한 한 적게 의존합니다.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. 기본 배포에 사용할 수 있는 패키지가 없는 경우 이전 배포 패키지를 시도합니다.If there's no package available for your base distribution, try a package for an earlier distribution.

이를 위해, 리포지토리를 추가할 때 수동으로 AZ_REPO 값을 설정합니다.To do this, set the value of AZ_REPO manually when adding the repository. Ubuntu 배포의 경우 bionic 리포지토리를 사용하고 Debian 배포판의 경우 stretch를 사용합니다.For Ubuntu distributions use the bionic repository, and for Debian distributions use stretch. Ubuntu Trusty 및 Debian Wheezy 이전에 릴리스된 배포는 지원되지 않습니다.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

프록시 연결 차단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.

이 프록시를 항상 사용하도록 명시적으로 apt를 구성할 수도 있습니다.You may also want to explicitly configure apt to use this proxy at all times. /etc/apt/apt.conf.d/apt 구성 파일에 다음 줄이 표시되는지 확인합니다Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/. 기존 글로벌 구성 파일, 기존 프록시 구성 파일, 40proxies 또는 99local을 사용하는 것이 좋지만, 시스템 관리 요구 사항을 따릅니다.We recommend using either your existing global configuration file, an existing proxy configuration file, 40proxies, or 99local, but follow your system administration requirements.

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

프록시에서 기본 인증을 사용하지 않는 경우 프록시 URI의 [username]:[password]@ 부분을 __제거__합니다.If your proxy does not use basic auth, remove the [username]:[password]@ portion of the proxy URI. 프록시 구성에 대한 자세한 내용은 다음과 같은 공식 Ubuntu 문서를 참조하세요.If you require more information for proxy configuration, see the official Ubuntu documentation:

Microsoft 서명 키를 가져오고 리포지토리에서 패키지를 가져오려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.In order to get the Microsoft signing key and get the package from our repository, your proxy needs to allow HTTPS connections to the following address:

  • https://packages.microsoft.com

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.

업데이트Update

apt-get upgrade를 사용하여 CLI 패키지를 업데이트합니다.Use apt-get upgrade to update the CLI package.

sudo apt-get update && sudo apt-get upgrade

참고

이 명령은 시스템에 설치되었지만 종속성이 변경되지 않은 모든 패키지를 업그레이드합니다.This command upgrades all of the installed packages on your system that have not had a dependency change. CLI만 업그레이드하려면 apt-get install을 사용하세요.To upgrade the CLI only, use apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y 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.

  1. apt-get remove를 사용하여 제거합니다.Uninstall with apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. CLI를 다시 설치할 계획이 없으면 Azure CLI 리포지토리 정보를 제거합니다.If you don't plan to reinstall the CLI, remove the Azure CLI repository information:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Microsoft의 다른 패키지를 사용하지 않는 경우 다음과 같이 서명 키를 제거합니다.If you use no other packages from Microsoft, remove the signing key:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.asc.gpg
    
  4. 불필요한 패키지를 제거합니다.Remove any unneeded packages:

    sudo apt autoremove
    

다음 단계Next Steps

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