Instalowanie interfejsu wiersza polecenia platformy Azure 2.0

Zainstaluj nową wersję interfejsu wiersza polecenia platformy Azure już dzisiaj! Ulepszyliśmy i zaktualizowaliśmy interfejs wiersza polecenia, aby zapewnić doskonałe, natywne środowisko wiersza polecenia do zarządzania zasobami platformy Azure. Można go używać w systemach macOS, Linux i Windows. Aby uzyskać informacje o najnowszej wersji, zobacz informacje o wersji.

Uwaga

Jeśli potrzebujesz poprzedniej wersji interfejsu wiersza polecenia platformy Azure, zobacz, jak zainstalować interfejs wiersza polecenia platformy Azure 1.0.

macOS

  1. Zainstaluj interfejs wiersza polecenia platformy Azure 2.0 przy użyciu jednego polecenia curl.

    curl -L https://aka.ms/InstallAzureCli | bash
    
  2. Może być konieczne ponowne uruchomienie powłoki poleceń, aby niektóre zmiany zostały zastosowane.

    exec -l $SHELL
    
  3. Uruchom interfejs wiersza polecenia platformy Azure 2.0 z okna wiersza polecenia przy użyciu polecenia az.

Uwaga

W przypadku instalacji z wykorzystaniem elementu InstallAzureCli polecenie az component update nie jest obsługiwane. Aby przeprowadzić aktualizację do najnowszej wersji interfejsu wiersza polecenia, uruchom polecenie curl -L https://aka.ms/InstallAzureCli | bash ponownie.

Aby odinstalować, zobacz instrukcje dotyczące ręcznego odinstalowywania.

Windows

Interfejs wiersza polecenia platformy Azure 2.0 obsługuje składnię poleceń powłoki Bash, dzięki czemu użycie języka Bash w systemie Ubuntu w systemie Windows jest doskonałym sposobem na korzystanie z interfejsu wiersza polecenia. Jeśli nie używasz języka Bash, możesz zainstalować interfejs wiersza polecenia i użyć go w wierszu polecenia systemu Windows.

Język Bash w systemie Ubuntu w systemie Windows

  1. Jeśli nie masz powłoki Bash w systemie Windows, zainstaluj ją.

  2. Otwórz powłokę Bash.

  3. Zmodyfikuj listę źródeł.

    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \
         sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Uruchom następujące polecenia programu sudo:

    sudo apt-key adv --keyserver packages.microsoft.com --recv-keys 417A0893
    sudo apt-get install apt-transport-https
    sudo apt-get update && sudo apt-get install azure-cli
    
Uwaga

W przypadku instalacji przy użyciu polecenia apt-get polecenie az component nie jest obsługiwane. Aby zaktualizować interfejs wiersza polecenia, uruchom polecenie sudo apt-get update && sudo apt-get install azure-cli ponownie.

Aby odinstalować, uruchom polecenie sudo apt-get remove azure-cli.

Wiersz polecenia systemu Windows

  1. Odwiedź witrynę języka Python i pobierz język Python dla systemu Windows. Pamiętaj, aby podczas instalacji języka Python zainstalować składnik Pip. Po zakończeniu instalacji dodaj język Python do zmiennej środowiskowej PATH (instalator wyświetli monit).

  2. Sprawdź instalację języka Python z poziomu wiersza polecenia.

    python --version
    
  3. Zainstaluj interfejs wiersza polecenia platformy Azure 2.0 przy użyciu narzędzia pip.

    pip install --user azure-cli
    
  4. Dodaj do ścieżki folder zawierający plik az.bat. Plik az.bat interfejsu wiersza polecenia może być zainstalowany w folderze %USERPROFILE%\AppData\Roaming\Python\Scripts lub %USERPROFILE%\AppData\Roaming\Python\PythonXY\Scripts, gdzie XY jest wersją języka Python (np. %USERPROFILE%\AppData\Roaming\Python\Python27\Scripts). Dodaj do ścieżki folder zawierający plik az.bat.

  5. Uruchom interfejs wiersza polecenia platformy Azure 2.0 z okna wiersza polecenia przy użyciu polecenia az.

Uwaga

Jeśli masz już zainstalowany interfejs wiersza polecenia platformy Azure 2.0 i chcesz zobaczyć, czy masz najnowszą wersję, użyj polecenia az --version, aby zobaczyć bieżącą wersję. Porównaj wynik z najnowszą wersją dostępną na stronie https://pypi.python.org/pypi/azure-cli.

Aby uaktualnić do najnowszej wersji interfejsu wiersza polecenia, uruchom polecenie az component update.

Aby odinstalować interfejs wiersza polecenia, uruchom polecenie pip uninstall azure-cli.

Linux

  1. W systemie Linux może być konieczne zainstalowanie określonych wymagań wstępnych.

  2. Zainstaluj interfejs wiersza polecenia platformy Azure 2.0 przy użyciu jednego polecenia curl.

    curl -L https://aka.ms/InstallAzureCli | bash
    
  3. Może być konieczne ponowne uruchomienie powłoki poleceń, aby niektóre zmiany zostały zastosowane.

    exec -l $SHELL
    
  4. Uruchom interfejs wiersza polecenia platformy Azure 2.0 z okna wiersza polecenia przy użyciu polecenia az.

Uwaga

W przypadku instalacji z wykorzystaniem elementu InstallAzureCli polecenie az component update nie jest obsługiwane. Aby przeprowadzić aktualizację do najnowszej wersji interfejsu wiersza polecenia, uruchom polecenie curl -L https://aka.ms/InstallAzureCli | bash ponownie.

Aby odinstalować, zobacz instrukcje dotyczące ręcznego odinstalowywania.

Docker

Zachowujemy obraz Docker wstępnie skonfigurowany z interfejsem wiersza polecenia platformy Azure.

Zainstaluj interfejs wiersza polecenia platformy Azure 2.0 przy użyciu polecenia docker run.

docker run azuresdk/azure-cli-python:<version>

Zobacz tagi Docker dla dostępnych wersji.

Uwaga

Jeśli chcesz wybrać klucze SSH ze środowiska użytkownika, możesz użyć polecenia -v ${HOME}:/root, aby zamontować lokalizację $HOME jako /root.

docker run -v ${HOME}:/root azuresdk/azure-cli-python:<version>
Uwaga

Obraz Docker nie obsługuje funkcji component. Aby zaktualizować interfejs wiersza polecenia platformy Azure 2.0, użyj polecenia docker run do zainstalowania najnowszego lub określonego obrazu, którego chcesz użyć.

apt-get

W przypadku systemów opartych na systemie Debian/Ubuntu możesz zainstalować interfejs wiersza polecenia platformy Azure 2.0 za pośrednictwem polecenia apt-get.

  1. Zmodyfikuj listę źródeł.

    • System 32-bitowy

      echo "deb https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \
           sudo tee /etc/apt/sources.list.d/azure-cli.list
      
    • System 64-bitowy

      echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \
           sudo tee /etc/apt/sources.list.d/azure-cli.list
      
  2. Uruchom następujące polecenia programu sudo:

    sudo apt-key adv --keyserver packages.microsoft.com --recv-keys 417A0893
    sudo apt-get install apt-transport-https
    sudo apt-get update && sudo apt-get install azure-cli
    
Uwaga

W przypadku instalacji przy użyciu polecenia apt-get polecenie az component nie jest obsługiwane. Aby zaktualizować interfejs wiersza polecenia, uruchom polecenie sudo apt-get update && sudo apt-get install azure-cli ponownie.

Aby odinstalować, uruchom polecenie sudo apt-get remove azure-cli.

Wymagania wstępne dla systemu Linux

  1. Jeśli nie masz języka Python, zainstaluj go.

  2. W zależności od dystrybucji systemu Linux zainstaluj odpowiednie wymagania wstępne.

    Platform              | Prerequisites
    ----------------------|---------------------------------------------
    Ubuntu 15.10 or 16.04 | sudo apt-get update && sudo apt-get install -y libssl-dev libffi-dev python-dev build-essential
    Ubuntu 12.04 or 14.04 | sudo apt-get update && sudo apt-get install -y libssl-dev libffi-dev python-dev
    Debian 8              | sudo apt-get update && sudo apt-get install -y libssl-dev libffi-dev python-dev build-essential
    Debian 7              | sudo apt-get update && sudo apt-get install -y libssl-dev libffi-dev python-dev
    CentOS 7.1 or 7.2     | sudo yum check-update; sudo yum install -y gcc libffi-devel python-devel openssl-devel
    RedHat 7.2            | sudo yum check-update; sudo yum install -y gcc libffi-devel python-devel openssl-devel
    SUSE OpenSUSE 13.2    | sudo zypper refresh && sudo zypper --non-interactive install gcc libffi-devel python-devel openssl-devel
    

Rozwiązywanie problemów


Błędy przekierowywania biblioteki curl

Jeśli wystąpił błąd polecenia curl dotyczący parametru -L lub błąd z komunikatem „Obiekt przeniesiony”, spróbuj użyć pełnego adresu URL zamiast adresu URL aka.ms:

# If you see this:
curl -L https://aka.ms/InstallAzureCli | bash
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   175  100   175    0     0    562      0 --:--:-- --:--:-- --:--:--   560
bash: line 1: syntax error near unexpected token `<'
'ash: line 1: `<html><head><title>Object moved</title></head><body>

#### Try this instead:
curl https://azurecliprod.blob.core.windows.net/install | bash

Błędy związane z instalacją przy użyciu polecenia cffi lub kryptografii

Jeśli występują błędy związane z instalacją w systemie OS X, uaktualnij narzędzie pip.

pip install --upgrade --force-reinstall pip

Jeśli występują błędy związane z instalacją w systemie Debian lub Ubuntu, takie jak w poniższych przykładach, zainstaluj elementy libssl-dev i libffi-dev.

sudo apt-get update
sudo apt-get install -y libssl-dev libffi-dev

Ponadto zainstaluj narzędzie Python Dev dla danej wersji języka Python.

Python 2:

sudo apt-get install -y python-dev

Python 3:

sudo apt-get install -y python3-dev

Ubuntu 15 może też wymagać elementu build-essential:

sudo apt-get install -y build-essential

Przykładowe błędy

Downloading cffi-1.5.2.tar.gz (388kB)
    100% |################################| 389kB 3.9MB/s
    Complete output from command python setup.py egg_info:

        No working compiler found, or bogus compiler options
        passed to the compiler from Python's distutils module.
        See the error messages above.
        (If they are about -mno-fused-madd and you are on OS/X 10.8,
        see http://stackoverflow.com/questions/22313407/ .)

    ----------------------------------------
Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-build-77i2fido/cffi/
#include <openssl/e_os2.h>
                            ^
compilation terminated.
error: command 'x86_64-linux-gnu-gcc' failed with exit status 1

Failed building wheel for cryptography

Zobacz pytanie dotyczące przepełnienia stosu — Nie można zainstalować pakietu kryptograficznego języka Python przy użyciu narzędzia PIP i pliku setup.py

Dezinstalacja

W przypadku użycia skryptu ze strony https://aka.ms/InstallAzureCli do zainstalowania interfejsu wiersza polecenia możesz przeprowadzić dezinstalację przy użyciu poniższych instrukcji.

  1. Usuń zainstalowane pliki.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Usuń wiersz <install location>/lib/azure-cli/az.completion z pliku <install location>/.bash_profile.

Uwaga

Domyślna lokalizacja instalacji to /Users/<username>.

Jeśli użyto narzędzia pip, polecenia apt-get lub platformy Docker do zainstalowania interfejsu wiersza polecenia, użyj tego samego narzędzia do jego odinstalowania.

Zgłaszanie problemów i przesyłanie opinii

Jeśli występują jakiekolwiek problemy związane z narzędziem, prześlij zgłoszenie do sekcji Problemy repozytorium GitHub. Aby przekazać opinię z wiersza polecenia, wypróbuj polecenie az feedback.