Megosztás a következőn keresztül:


Az Azure CLI telepítése Linuxon

Ez a cikk bemutatja, hogyan telepítheti az Azure CLI-t Linuxon. Válassza ki a megfelelő csomagkezelőt az oldal tetején található beállítások közül. A Linux-disztribúció csomagkezelőjének használata ajánlott, de a Szkript telepítése lehetőség kiválasztásával manuálisan telepítheti az Azure CLI-t Linuxra.

Az Azure CLI jelenlegi verziója a 2.63.0. A legújabb kiadással kapcsolatos információkért lásd a kibocsátási megjegyzéseket. A telepített verzió megkereséséhez és annak megtekintéséhez, hogy frissítenie kell-e, futtassa az az verziót.

Mielőtt elkezdené

  • Az Azure CLI 2.38.2 (2024. június 21-én jelent meg) az RHEL 7 és a Centos 7 utolsó támogatott verziója. A Microsoft már nem biztosít frissítéseket vagy hibajavításokat ezekhez a disztribúciókhoz.

  • A Microsoft továbbra is fejleszti és támogatja az Azure CLI-t és a Linux telepítési szkriptet.

  • yum A csomagkezelőt akkor használja, ha olyan Linux rendszert használ, amely nem támogatja a csomagkezelőtdnf.

Telepítse az Azure CLI-t

Az Azure CLI telepítéséhez kövesse az alábbi lépéseket:

  1. Importálja a Microsoft-adattár kulcsát.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. RHEL 9 vagy CentOS Stream esetén adja hozzá packages-microsoft-com-prod az adattárat:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
    

    RHEL 8 esetén adja hozzá packages-microsoft-com-prod az adattárat:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
    

    RHEL 7 esetén adja hozzá azure-cli az adattárat:

    echo -e "[azure-cli]
    name=Azure CLI
    baseurl=https://packages.microsoft.com/yumrepos/azure-cli
    enabled=1
    gpgcheck=1
    gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo
    

    Figyelemfelhívás

    CentOS 7 End Of Life (EOL) volt június 30, 2024. Az Azure CLI által támogatott környezetekről további információt az Azure CLI támogatási életciklusában talál .

  3. Indítsa el a telepítést a dnf install paranccsal.

    sudo dnf install azure-cli
    

Adott verzió telepítése

Először konfigurálnia azure-cli kell az adattár adatait a korábban bemutatott módon. Az elérhető verziók az Azure CLI kibocsátási megjegyzéseiben találhatók.

  1. Az elérhető verziók megtekintése a paranccsal:

    dnf list --showduplicates azure-cli
    
  2. Egy adott verzió telepítése:

    sudo dnf install azure-cli-<version>-1.el7
    

Az Azure CLI frissítése

A 2.11.0-s verziótól kezdve az Azure CLI egy eszközön belüli parancsot biztosít a legújabb verzióra való frissítéshez.

az upgrade

Ez a parancs alapértelmezés szerint az összes telepített bővítményt is frissíti. További az upgrade lehetőségekért tekintse meg a parancs referenciaoldalát. A 2.11.0-s verzió előtti Azure CLI-verziók esetében frissítsen újra az Azure CLI telepítésében leírtak szerint.

Az Azure CLI-t a paranccsal dnf update is frissítheti.

sudo dnf update azure-cli

Az Azure CLI eltávolítása

Ha az Azure CLI eltávolítását választotta, sajnáljuk, hogy felhagy a használatával. Az eltávolítás előtt az az feedback paranccsal ossza meg velünk, hogy mit tehetnénk jobbá, és mit kell kijavítanunk. Az a célunk, hogy az Azure CLI hibamentes és felhasználóbarát legyen. Ha hibát tapasztal, kérjük, jelentse be a GitHubon.

  1. Távolítsa el a csomagot a rendszerről.

    sudo dnf remove azure-cli
    
  2. Ha nem tervezi a CLI újratelepítését, távolítsa el az adattár információit.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Ha nem használ más Microsoft-csomagokat, távolítsa el az aláíró kulcsot.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Adatok eltávolítása

Ha nem tervezi újratelepíteni az Azure CLI-t, távolítsa el az adatokat.

rm -rf ~/.azure

Hibaelhárítás

Az alábbiakban néhány, az dnf telepítése során gyakran jelentkező problémáról olvashat. Ha itt nem tárgyalt problémát tapasztal, küldjön egy problémát a GitHubon.

Telepítés RHEL 7.6-os vagy más, Python 3 nélküli rendszerekre

Ha tudja, frissítse a rendszert a csomag hivatalos támogatásával rendelkező verzióra python 3.6+ . Ellenkező esetben először telepítenie kell egy python3 csomagot, majd függőség nélkül kell telepítenie az Azure CLI-t.

A következő paranccsal töltheti le és telepítheti az Azure CLI telepítési szkriptet a forrásból készült beépített paranccsal python 3.6 :

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

Ezt lépésről lépésre is elvégezheti:

Először is az Azure CLI-nek szüksége van SSL 1.1+ a forrásból való buildelésre openssl 1.1 a létrehozás python3előtt:

sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v

Ezután hozza létre a Python 3-at a forrásból:

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

Végül kövesse a telepítési utasítás 1. és 2. lépését az Azure CLI-adattár hozzáadásához. Most már letöltheti a csomagot, és függőség nélkül telepítheti.

Feljegyzés

Ha a dnf letöltési beépülő modul még nincs telepítve, hibaüzenet jelenik meg command not found a következő kód végrehajtásakor. A dnf letöltési beépülő modul telepítéséhez használható dnf install 'dnf-command(download)' .

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

Másik lehetőségként a Python 3-at egy másik adattár használatával is telepítheti. Ezt a módszert akkor használja, ha beállította python3 , de továbbra is a hibaüzenet python3: command not foundjelenik meg. Győződjön meg arról, hogy szerepel az elérési úton.

scl enable rh-python36 bash

Egy proxy blokkolja a kapcsolatot

Ha proxy miatt nem tud külső erőforráshoz csatlakozni, győződjön meg arról, hogy helyesen állította be a rendszerhéjban lévő HTTP_PROXY változókat és HTTPS_PROXY változókat. Forduljon a rendszergazdához, hogy tudja, milyen gazdagép(ek) és port(ok) használhatók ezekhez a proxykhoz.

Az ezekben a változókban szereplő értékeket számos Linux-program használja, és a telepítési folyamat során. Az értékek beállítása:

# 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]

Fontos

Ha proxy mögött áll, ezeket a rendszerhéjváltozókat úgy kell beállítani, hogy a parancssori felülettel csatlakozzanak az Azure-szolgáltatásokhoz. Ha nem alapszintű hitelesítést használ, javasoljuk, hogy exportálja ezeket a változókat a .bashrc fájlba. Mindig kövesse az üzleti biztonsági szabályzatokat és a rendszergazda követelményeit.

Azt is érdemes lehet explicit módon konfigurálni dnf , hogy mindig ezt a proxyt használja. Győződjön meg arról, hogy a következő sorok jelennek meg a [main] következő szakasz /etc/dnf/dnf.confalatt:

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

Ahhoz, hogy lekérhesse a Microsoft aláírókulcsát és a csomagot az adattárból, a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címre:

  • https://packages.microsoft.com

A parancssori felület nem telepíthető vagy futtatható Linuxos Windows-alrendszer

Mivel a Linuxos Windows-alrendszer (WSL) egy rendszerhívás fordítási rétege a Windows platform tetején, hibaüzenetet tapasztalhat az Azure CLI telepítésekor vagy futtatásakor. A parancssori felület olyan funkciókra támaszkodik, amelyek a WSL-ben hibát okozhatnak. Ha a parancssori felület telepítésétől függetlenül hibát tapasztal, akkor jó eséllyel ez a WSL-vel kapcsolatos probléma, és nem a parancssori felület telepítési folyamatával kapcsolatos.

A WSL-telepítés hibaelhárításához és a problémák megoldásához:

  • Ha lehetséges, futtasson egy azonos telepítési folyamatot linuxos gépen vagy virtuális gépen, hogy kiderüljön, sikeres-e. Ha igen, a probléma valószínűleg a WSL-hez kapcsolódik. Linux rendszerű virtuális gép Azure-beli elindításához tekintse meg a Linux rendszerű virtuális gép létrehozását az Azure Portal dokumentációjában.
  • Győződjön meg arról, hogy a WSL legújabb verzióját futtatja. A legújabb verzió beszerzéséhez frissítse a Windows 10 telepítését.
  • Ellenőrizze, hogy vannak-e nyitott problémák a WSL-vel kapcsolatban, amelyek megoldhatják a problémát. Gyakran vannak javaslatok a probléma megkerülésére, vagy olyan kiadásra vonatkozó információk, amelyekben a probléma ki lett javítva.
  • Ha a probléma nem áll fenn, küldjön egy új problémát a WSL-hez, és győződjön meg arról, hogy a lehető legtöbb információt adja meg.

Ha továbbra is problémákat tapasztal a WSL telepítésével vagy futtatásával kapcsolatban, fontolja meg a Windows parancssori felületének telepítését.

Mielőtt elkezdené

  • Az Azure CLI 2.38.2 (2024. június 21-én jelent meg) a SUSE Linux Enterprise Server (SLES) és az OpenSUSE (Ugrás) legújabb verziója. A Microsoft már nem biztosít frissítéseket vagy hibajavításokat ezekhez a disztribúciókhoz.

  • A Microsoft továbbra is fejleszti és támogatja az Azure CLI-t és a Linux telepítési szkriptet. A SUSE fenntartja és támogatja a SUSE/OpenSUSE-adattárak által biztosított csomagokat.

  • Az Azure-ban az Azure Marketplace-rendszerképeken alapuló SUSE és OpenSUSE virtuális gépeken már telepítve van az Azure CLI.

Telepítse az Azure CLI-t

Az Azure CLI SUSE/OpenSUSE rendszeren való telepítéséhez válasszon az alábbi módszerek közül:

  1. Használja a SUSE által a SUSE /OpenSUSE-adattárakban biztosított Vállalati csomagot.

  2. Használja a "Szkript telepítése (bármely)" lapon leírt telepítési módszert.

  3. Telepítés a Microsoft-adattárakból

Telepítés SUSE- vagy OpenSUSE-adattárakból

Az Azure CLI RPM-csomagja a python3 csomagtól függ.

sudo zypper install -y azure-cli

Telepítés a telepítési szkripttel

Az Azure CLI-t manuálisan is telepítheti a Linux bármely verziójára a Szkript telepítése lehetőséggel.

Ha ezzel a módszerrel frissít a legújabb verzióra, először távolítsa el az előző verziót, és minden olyan adattárat, amelyet az adott verzióhoz adott hozzá.

Telepítés a Microsoft-adattárakból

Az Azure CLI legújabb korábbi verziójának Microsoft-adattárak használatával történő telepítéséhez kövesse az alábbi lépéseket.

(Ezt a csomagot teszteltük a SLES 15 és OpenSUSE Leap 15.1)

  1. curl telepítése:

    sudo zypper install -y curl
    
  2. Importálja a Microsoft tárházbeli kulcsát:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Hozza létre a helyi azure-cli tárház információit:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Frissítse a zypper-csomagindexet, majd telepítse:

    sudo zypper install --from azure-cli azure-cli
    

    A 2. bemenet a telepítés folytatásához figyelmen kívül hagy néhány függőséget.

Adott verzió telepítése

Először konfigurálnia azure-cli kell az adattár adatait a korábban bemutatott módon. Az elérhető verziók az Azure CLI kibocsátási megjegyzéseiben találhatók.

  1. Tekintse meg az elérhető verziókat a következő paranccsal:

    zypper search --details --match-exact azure-cli
    
  2. Egy adott verzió telepítése:

    sudo zypper install --from azure-cli azure-cli=<version>-1.el7
    

Az Azure CLI frissítése

A 2.11.0-s verziótól kezdve az Azure CLI egy eszközön belüli parancsot biztosít a legújabb verzióra való frissítéshez.

az upgrade

Ez a parancs alapértelmezés szerint az összes telepített bővítményt is frissíti. További az upgrade lehetőségekért tekintse meg a parancs referenciaoldalát. A 2.11.0-s verzió előtti Azure CLI-verziók esetében frissítsen újra az Azure CLI telepítésében leírtak szerint.

A csomagot a paranccsal zypper update is frissítheti.

sudo zypper refresh
sudo zypper update azure-cli

Az Azure CLI eltávolítása

Ha az Azure CLI eltávolítását választotta, sajnáljuk, hogy felhagy a használatával. Az eltávolítás előtt az az feedback paranccsal ossza meg velünk, hogy mit tehetnénk jobbá, és mit kell kijavítanunk. Az a célunk, hogy az Azure CLI hibamentes és felhasználóbarát legyen. Ha hibát tapasztal, kérjük, jelentse be a GitHubon.

  1. Távolítsa el a csomagot a rendszerről.

    sudo zypper remove -y azure-cli
    
  2. Ha nem tervezi a CLI újratelepítését, távolítsa el az adattár információit.

    sudo zypper removerepo azure-cli
    
  3. Ha nem használ más Microsoft-csomagokat, távolítsa el a Microsoft aláírókulcsát.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Adatok eltávolítása

Ha nem tervezi újratelepíteni az Azure CLI-t, távolítsa el az adatokat.

rm -rf ~/.azure

Hibaelhárítás

Az alábbiakban néhány, az zypper telepítése során gyakran jelentkező problémáról olvashat. Ha itt nem tárgyalt problémát tapasztal, küldjön egy problémát a GitHubon.

Telepítés Python 3 nélkül

Fontos

Az Azure CLI RPM-csomagja a python3 csomagtól függ. A rendszeren ez lehet egy Python-verzió, amely megelőzi a Python 3.6.x követelményét. Ha ez hatással van Önre, keressen egy cserecsomagot python3 .

Vegye figyelembe, hogy a Python 2 2 2020. január 1-jén elérte az élettartamát (EOL), és a továbbiakban nem kap frissítéseket. Az Azure CLI a 2.1.0-s verzió óta nem támogatja a Python 2.7-et. Előfordulhat, hogy a parancssori felület újabb verziói nem futnak megfelelően a Python 2.7 használatával.

NotImplementedError az OpenSUSE 15 virtuális gépen

Az OpenSUSE 15 virtuális gép egy előre telepített Azure CLI-vel rendelkezik a 2.0.45-ös verzióval, amely elavult, és problémákat tapasztal az login. Távolítsa el ezt a verziót a függőségeivel együtt, mielőtt a telepítési utasítást követve hozzáadja a legújabb Azure CLI-t:

sudo zypper rm -y --clean-deps azure-cli

Ha az Azure CLI-t a 2.0.45-ös verzió függőségeinek eltávolítása nélkül frissítette, a régi függőségek hatással lehetnek az Azure CLI legújabb verziójára. A régi verziót vissza kell adnia a függőségeihez való csatoláshoz, majd el kell távolítania azure-cli a függőségekkel együtt:

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

Telepítés SLES 12 vagy más rendszereken Python 3.6 nélkül

Az SLES 12-ben az alapértelmezett python3 csomag a 3.4, és az Azure CLI nem támogatja. Az adattár hozzáadásához először kövesse a telepítési utasítás 1–3. lépését azure-cli . Ezután hozzon létre egy magasabb verziót python3 a forrásból. Végül letöltheti az Azure CLI-csomagot, és függőség nélkül telepítheti.

A következő egy paranccsal telepítheti vagy frissítheti az Azure CLI-t a fenti lépések alapján. A szkript telepíti a Python 3.8-at, /usr/local/azcli és egy alias az PATH=/usr/local/azcli/bin:$PATH azbeállításával az Azure CLI-t használja. A szkriptet az igényeinek megfelelően is letöltheti és módosíthatja. Módosíthatja például a Python-verziót vagy a telepítési helyet.

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

Az első telepítéshez ne felejtse el futtatni a következő parancsot az alias aktiválásához:

source ~/.bashrc

Egy proxy blokkolja a kapcsolatot

Ha proxy miatt nem tud külső erőforráshoz csatlakozni, győződjön meg arról, hogy helyesen állította be a rendszerhéjban lévő HTTP_PROXY változókat és HTTPS_PROXY változókat. Forduljon a rendszergazdához, hogy tudja, milyen gazdagép(ek) és port(ok) használhatók ezekhez a proxykhoz.

Az ezekben a változókban szereplő értékeket számos Linux-program használja, és a telepítési folyamat során. Az értékek beállítása:

# 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]

Fontos

Ha proxy mögött áll, ezeket a rendszerhéjváltozókat úgy kell beállítani, hogy a parancssori felülettel csatlakozzanak az Azure-szolgáltatásokhoz. Ha nem alapszintű hitelesítést használ, javasoljuk, hogy exportálja ezeket a változókat a .bashrc fájlba. Mindig kövesse az üzleti biztonsági szabályzatokat és a rendszergazda követelményeit.

Azt is érdemes lehet explicit módon konfigurálni zypper (keresztül), yast2hogy mindig ezt a proxyt használja. Ehhez futtassa a yast2 proxy parancsot felügyelőként, és töltse ki az űrlapon megjelenő információkat. Ha a rendszeren elérhető egy ablakkezelő, akkor a panelt is használhatja a Network Services > Proxy YaST Control Center.

A speciális konfigurációval vagy további információval kapcsolatban tekintse meg az OpenSUSE proxykonfiguráció dokumentációját

A Microsoft aláírókulcsának lekéréséhez és a csomag adattárból való lekéréséhez a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címekre:

  • https://packages.microsoft.com
  • https://download.opensuse.org

A parancssori felület nem telepíthető vagy futtatható Linuxos Windows-alrendszer

Mivel a Linuxos Windows-alrendszer (WSL) egy rendszerhívás fordítási rétege a Windows platform tetején, hibaüzenetet tapasztalhat az Azure CLI telepítésekor vagy futtatásakor. A parancssori felület olyan funkciókra támaszkodik, amelyek a WSL-ben hibát okozhatnak. Ha a parancssori felület telepítésétől függetlenül hibát tapasztal, akkor jó eséllyel ez a WSL-vel kapcsolatos probléma, és nem a parancssori felület telepítési folyamatával kapcsolatos.

A WSL-telepítés hibaelhárításához és a problémák megoldásához:

  • Ha lehetséges, futtasson egy azonos telepítési folyamatot linuxos gépen vagy virtuális gépen, hogy kiderüljön, sikeres-e. Ha igen, a probléma valószínűleg a WSL-hez kapcsolódik. Linux rendszerű virtuális gép Azure-beli elindításához tekintse meg a Linux rendszerű virtuális gép létrehozását az Azure Portal dokumentációjában.
  • Győződjön meg arról, hogy a WSL legújabb verzióját futtatja. A legújabb verzió beszerzéséhez frissítse a Windows 10 telepítését.
  • Ellenőrizze, hogy vannak-e nyitott problémák a WSL-vel kapcsolatban, amelyek megoldhatják a problémát. Gyakran vannak javaslatok a probléma megkerülésére, vagy olyan kiadásra vonatkozó információk, amelyekben a probléma ki lett javítva.
  • Ha a probléma nem áll fenn, küldjön egy új problémát a WSL-hez, és győződjön meg arról, hogy a lehető legtöbb információt adja meg.

Ha továbbra is problémákat tapasztal a WSL telepítésével vagy futtatásával kapcsolatban, fontolja meg a Windows parancssori felületének telepítését.

SSL-tanúsítványhiba

Ha egy tanúsítvány meghibásodik vagy elavult egy gépen, hibaüzenet jelenhet meg, amely azt jelzi, hogy a curl nem tudta ellenőrizni a kiszolgáló legitimitását, ezért nem tudott biztonságos kapcsolatot létesíteni. Frissítse a tanúsítványt a probléma megoldásához.

sudo zypper update-ca-certificates

Mielőtt elkezdené

  • A apt csomagkezelő x86_64 és ARM64-csomagokat tartalmaz az Azure CLI-hez, amelyeket az alábbi disztribúciókon teszteltek.

    Disztribúció Verzió
    Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Medúza), 24.04 (Noble Numbat)
    Debian 10 (Buster), 11 (Bullseye), 12 (Bookworm)
  • Az Ubuntu 20.04 (Focal Fossa) és a 20.10 (Groovy Gorilla) tartalmazza azure-cli az universe adattár által biztosított verziójú 2.0.81 csomagot. Ez a csomag elavult, és nem ajánlott. Ha a csomag telepítve van, távolítsa el a csomagot, mielőtt folytatná a parancs futtatásával sudo apt remove azure-cli -y && sudo apt autoremove -y. További információkért lásd az Ubuntu csomagkezelést, vagy kérdezze meg az ubuntu-t.apt remove

Telepítse az Azure CLI-t

Az Azure CLI kétféleképpen telepíthető a rendszerre. Letölthet egy telepítési szkriptet, amely futtatja a telepítési parancsokat, vagy saját maga hajthatja végre a telepítési parancsokat lépésről lépésre. Mindkét módszer itt érhető el:

1. lehetőség: Telepítés egy paranccsal

Az Azure CLI telepítésének legegyszerűbb módja az Azure CLI-csapat által karbantartott szkript. Ez a szkript egyetlen lépésben futtatja az összes telepítési parancsot. Ez a szkript a parancssori felület telepítéséhez töltődik le curl , és közvetlenül bash a parancssori felület telepítéséhez lesz futtatva.

Ha a végrehajtás előtt saját maga szeretné megvizsgálni a szkript tartalmát, először töltse le a szkriptet curl , és vizsgálja meg a kedvenc szövegszerkesztőjében.

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

2. lehetőség: Részletes telepítési utasítások

Ha lépésenkénti telepítési folyamatot szeretne, hajtsa végre az alábbi lépéseket az Azure CLI telepítéséhez.

  1. Kérje le a telepítési folyamathoz szükséges csomagokat:

    sudo apt-get update
    sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
    
  2. Töltse le és telepítse a Microsoft aláírókulcsát:

    sudo mkdir -p /etc/apt/keyrings
    curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
      gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
    sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
    
  3. Adja hozzá az Azure CLI szoftveradattárat:
    AZ_DIST=$(lsb_release -cs)
    echo "Types: deb
    URIs: https://packages.microsoft.com/repos/azure-cli/
    Suites: ${AZ_DIST}
    Components: main
    Architectures: $(dpkg --print-architecture)
    Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
    
  4. Frissítse az adattár adatait, és telepítse a azure-cli csomagot:

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

Adott verzió telepítése

Konfigurálja az azure-cli adattár adatait a korábban bemutatott módon. Az elérhető verziók az Azure CLI kibocsátási megjegyzéseiben találhatók.

  1. Az Azure CLI elérhető verzióinak megtekintése.

    apt-cache policy azure-cli
    
  2. Telepítsen egy adott verziót.

    # Obtain the currently installed distribution
    AZ_DIST=$(lsb_release -cs)
    
    # Store an Azure CLI version of choice
    AZ_VER=2.51.0
    
    # Install a specific version
    sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}
    

    Ha egy adott verziót változók nélkül szeretne telepíteni, cserélje le az Azure CLI-verziót és a Linux-disztribúció nevét:

    sudo apt-get install azure-cli=2.51.0-1~bullseye
    

Ha hibaüzenet jelenik meg, amely nem találja a csomag azure-cli-t, az azure-cli adattár adatai nincsenek konfigurálva. Kövesse a 2. lehetőség lépéseit: Részletes telepítési utasítások.

Ha az x.xx.x-1~distributionName for azure-cli hibaüzenetet kapja, használja lsb_release -cs a futtatott disztribúció megkereséséhez.

Az Azure CLI frissítése

A 2.11.0-s verziótól kezdve az Azure CLI egy eszközön belüli parancsot biztosít a legújabb verzióra való frissítéshez.

az upgrade

Ez a parancs alapértelmezés szerint az összes telepített bővítményt is frissíti. További az upgrade lehetőségekért tekintse meg a parancs referenciaoldalát. A 2.11.0-s verzió előtti Azure CLI-verziók esetében frissítsen újra az Azure CLI telepítésében leírtak szerint.

A CLI-csomag frissítésére is használható apt-get upgrade . Ez a parancs frissíti a rendszeren az összes olyan telepített csomagot, amely nem módosította a függőséget.

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

Ha csak a CLI-t szeretné frissíteni, használja az apt-get install parancsot.

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

Az Azure CLI eltávolítása

Ha az Azure CLI eltávolítását választotta, sajnáljuk, hogy felhagy a használatával. Az eltávolítás előtt az az feedback paranccsal ossza meg velünk, hogy mit tehetnénk jobbá, és mit kell kijavítanunk. Az a célunk, hogy az Azure CLI hibamentes és felhasználóbarát legyen. Ha hibát tapasztal, kérjük, jelentse be a GitHubon.

  1. Eltávolítás a következővel apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Ha nem tervezi újratelepíteni a parancssori felületet, távolítsa el az Azure CLI-adattár adatait:

    sudo rm /etc/apt/sources.list.d/azure-cli.sources
    
  3. Ha nem használ más csomagokat a Microsofttól, távolítsa el az aláíró kulcsot:

    sudo rm /etc/apt/keyrings/microsoft.gpg
    
  4. Távolítsa el a szükségtelen csomagokat:

    sudo apt autoremove
    

Adatok eltávolítása

Ha nem tervezi újratelepíteni az Azure CLI-t, távolítsa el az adatokat.

rm -rf ~/.azure

Hibaelhárítás

Az alábbiakban néhány, az apt telepítése során gyakran jelentkező problémáról olvashat. Ha itt nem tárgyalt problémát tapasztal, küldjön egy problémát a GitHubon.

A azure-cli csomag támogatja az ARM64 architektúrát a CLI 2.46.0-s verziójából.

Nincs modullal kapcsolatos probléma az Ubuntu 20.04 (Focal)/WSL rendszeren

Ha a manuális telepítési utasítások 3. lépésében vagy a szkriptünk használatával az Azure CLI szoftvertárház hozzáadása nélkül telepítette azure-cli Focal, problémákat tapasztalhat, például nem merülhet fel "decorator" vagy "antlr4" nevű modul, mivel a telepített csomag elavult azure-cli 2.0.81 az focal/universe adattárból. Távolítsa el először a futtatással sudo apt remove azure-cli -y && sudo apt autoremove -y, majd kövesse a fenti utasításokat a legújabb azure-cli csomag telepítéséhez.

lsb_release nem a megfelelő alapterjesztési verziót adja vissza

Előfordulhat, hogy egyes Ubuntu- vagy más Debian-alapú disztribúciók (például Linux Mint) nem a megfelelő verziónevet lsb_releaseadják vissza. Ez az érték a telepítendő csomagot határozza meg a telepítési folyamat során. Ha ismeri annak az Ubuntu- vagy Debian-verziónak a kódnevét, amelyből a disztribúció származik, manuálisan is beállíthatja az AZ_REPO értéket az adattár hozzáadásakor. Ellenkező esetben keresse meg a disztribúcióra vonatkozó információkat az alap terjesztési kód nevének meghatározásához és a megfelelő értékhez való beállításához AZ_REPO .

Nincs csomag a disztribúcióhoz

Előfordulhat, hogy egy frissített Azure CLI-csomag nem érhető el azonnal a terjesztési verzió kiadását követően. Az Azure CLI úgy lett kialakítva, hogy rugalmas legyen a függőségek jövőbeli verzióival szemben, és a lehető legkevesebbre támaszkodik. Ha az alapterjesztéshez nem érhető el csomag, próbálkozzon egy korábbi disztribúció csomagjával.

Ha egy korábbi disztribúcióhoz szeretne csomagot kipróbálni, állítsa be manuálisan az adattár AZ_REPOhozzáadásakor. Ubuntu-disztribúciók esetén használja a legújabb jammy adattárat:

AZ_REPO="jammy"

Debian-disztribúciók esetén használja a legújabb bookworm adattárat:

AZ_REPO="bookworm"

Fontos

Az Ubuntu Bionic és a Debian Buster előtt kiadott disztribúciók nem támogatottak.

Az általános operációs rendszer (EOS) nem tudja telepíteni az Azure CLI-t

Az EOS nem tudja telepíteni az Azure CLI-t, mert lsb_release visszaadja HERAaz EOS-kiadás nevét. A megoldás a fájl /etc/apt/sources.list.d/azure-cli.sources javítása és a módosítás Suites: hera Suites: bionic.

Eredeti fájl tartalma:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Módosított fájltartalmak

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Egy proxy blokkolja a kapcsolatot

Ha proxy miatt nem tud külső erőforráshoz csatlakozni, győződjön meg arról, hogy helyesen állította be a rendszerhéjban lévő HTTP_PROXY változókat és HTTPS_PROXY változókat. Forduljon a rendszergazdához, hogy tudja, milyen gazdagép(ek) és port(ok) használhatók ezekhez a proxykhoz.

Az ezekben a változókban szereplő értékeket számos Linux-program használja, és a telepítési folyamat során. Az értékek beállítása:

# 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]

Fontos

Ha proxy mögött áll, ezeket a rendszerhéjváltozókat úgy kell beállítani, hogy a parancssori felülettel csatlakozzanak az Azure-szolgáltatásokhoz. Ha nem alapszintű hitelesítést használ, javasoljuk, hogy exportálja ezeket a változókat a .bashrc fájlba. Mindig kövesse az üzleti biztonsági szabályzatokat és a rendszergazda követelményeit.

Azt is érdemes lehet explicit módon konfigurálni apt , hogy mindig ezt a proxyt használja. Győződjön meg arról, hogy a következő sorok megjelennek egy apt konfigurációs fájlban a következő fájlban:/etc/apt/apt.conf.d/ Javasoljuk, hogy használja a meglévő globális konfigurációs fájlt, egy meglévő proxykonfigurációs fájlt vagy 40proxies99local, de kövesse a rendszerfelügyeleti követelményeket.

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

Ha a proxy nem használ egyszerű hitelesítést, távolítsa el a [username]:[password]@ proxy URI részét. Ha további információra van szüksége a proxykonfigurációhoz, tekintse meg az Ubuntu hivatalos dokumentációját:

A Microsoft aláírókulcsának lekéréséhez és a csomag adattárból való lekéréséhez a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címre: 'https://packages.microsoft.com.

A parancssori felület nem telepíthető vagy futtatható Linuxos Windows-alrendszer

Mivel a Linuxos Windows-alrendszer (WSL) egy rendszerhívás fordítási rétege a Windows platform tetején, hibaüzenetet tapasztalhat az Azure CLI telepítésekor vagy futtatásakor. A parancssori felület olyan funkciókra támaszkodik, amelyek a WSL-ben hibát okozhatnak. Ha a parancssori felület telepítésétől függetlenül hibát tapasztal, akkor jó eséllyel ez a WSL-vel kapcsolatos probléma, és nem a parancssori felület telepítési folyamatával kapcsolatos.

A WSL-telepítés hibaelhárításához és a problémák megoldásához:

  • Ha lehetséges, futtasson egy azonos telepítési folyamatot linuxos gépen vagy virtuális gépen, hogy kiderüljön, sikeres-e. Ha igen, a probléma valószínűleg a WSL-hez kapcsolódik. Linux rendszerű virtuális gép Azure-beli elindításához tekintse meg a Linux rendszerű virtuális gép létrehozását az Azure Portal dokumentációjában.
  • Győződjön meg arról, hogy a WSL legújabb verzióját futtatja. A legújabb verzió beszerzéséhez frissítse a Windows 10 telepítését.
  • Ellenőrizze, hogy vannak-e nyitott problémák a WSL-vel kapcsolatban, amelyek megoldhatják a problémát. Gyakran vannak javaslatok a probléma megkerülésére, vagy olyan kiadásra vonatkozó információk, amelyekben a probléma ki lett javítva.
  • Ha a probléma nem áll fenn, küldjön egy új problémát a WSL-hez, és győződjön meg arról, hogy a lehető legtöbb információt adja meg.

Ha továbbra is problémákat tapasztal a WSL telepítésével vagy futtatásával kapcsolatban, fontolja meg a Windows parancssori felületének telepítését.

Telepítse az Azure CLI-t

Az RRPM-ek az Azure Linuxhoz a CBL-Marineren keresztül jelennek meg. A azure-cli csomag támogatja az ARM64 architektúrát a CLI 2.46.0-s verziójából.

Az Azure CLI telepítéséhez kövesse az alábbi lépéseket:

  1. Telepítse a Microsoft által kiadott megbízható főtanúsítványok hivatalos készletét:

    sudo tdnf install ca-certificates
    
  2. Az Azure CLI telepítése:

    sudo tdnf install azure-cli
    

Adott verzió telepítése

Az elérhető verziók az Azure CLI kibocsátási megjegyzéseiben találhatók.

Az elérhető verziók megtekintése a paranccsal:

tdnf list azure-cli

Adott verzió telepítése:

sudo tdnf install azure-cli-<version>-1

Az Azure CLI frissítése

Frissítse az Azure CLI-t a tdnf update következő paranccsal:

sudo tdnf update azure-cli

Az Azure CLI eltávolítása

Ha az Azure CLI eltávolítását választotta, sajnáljuk, hogy felhagy a használatával. Az eltávolítás előtt az az feedback paranccsal ossza meg velünk, hogy mit tehetnénk jobbá, és mit kell kijavítanunk. Az a célunk, hogy az Azure CLI hibamentes és felhasználóbarát legyen. Ha hibát tapasztal, kérjük, jelentse be a GitHubon.

Távolítsa el a csomagot a rendszerből:

sudo tdnf remove azure-cli

Adatok eltávolítása

Ha nem tervezi újratelepíteni az Azure CLI-t, távolítsa el az adatokat.

rm -rf ~/.azure

Mielőtt elkezdené

A CLI telepítéséhez határozottan ajánlott csomagkezelőt használni. A csomagkezelővel mindig beszerezheti a legújabb frissítéseket, és használatával garantálható a parancssori felület összetevőinek stabilitása. A manuális telepítés előtt ellenőrizze, hogy van-e csomag a disztribúcióhoz.

Az Azure CLI telepítési szkriptjének használatához a következő szoftver szükséges:

Az Azure CLI telepítése vagy frissítése

Fontos

A telepítési szkript csak Python 3.8.x, 3.9.x vagy 3.10.x rendszeren működik. Ez a telepítési szkript nem működik a Python 3.11.x vagy újabb verzióiban.

Az Azure CLI telepítéséhez és frissítéséhez újra kell futtatni a telepítési szkriptet:

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

A szkript letölthető, és helyileg is futtatható. Előfordulhat, hogy újra kell indítania a rendszerhéjat a módosítások érvénybe lépéséhez.

Az Azure CLI eltávolítása

Ha az Azure CLI eltávolítását választotta, sajnáljuk, hogy felhagy a használatával. Az eltávolítás előtt az az feedback paranccsal ossza meg velünk, hogy mit tehetnénk jobbá, és mit kell kijavítanunk. Az a célunk, hogy az Azure CLI hibamentes és felhasználóbarát legyen. Ha hibát tapasztal, kérjük, jelentse be a GitHubon.

A CLI-t úgy távolíthatja el, ha közvetlenül a telepítéskor megadott helyükről törli a fájlokat. Az alapértelmezett telepítési hely a felhasználó kezdőkönyvtára ($HOME).

  1. Távolítsa el a telepített CLI-fájlokat.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Módosítsa a $HOME/.bash_profile fájlt a következő sor eltávolításával:

    <install location>/lib/azure-cli/az.completion
    
  3. bash vagy zsh használatakor töltse be újra a felület parancs-gyorsítótárát.

    hash -r
    

Adatok eltávolítása

Ha nem tervezi újratelepíteni az Azure CLI-t, távolítsa el az adatokat.

rm -rf ~/.azure

Hibaelhárítás

Az alábbiakban néhány gyakori, a manuális telepítés során jelentkező problémáról olvashat. Ha itt nem tárgyalt problémát tapasztal, küldjön egy problémát a GitHubon.

Telepítés Python 3 nélkül

Az Azure CLI a 2.1.0-s verzió óta nem támogatja a Python 2.7-et. Előfordulhat, hogy a rendszeren van egy Python-verzió, amely megelőzi a Python 3.6.x követelményét. Keressen egy cserecsomagot python3 .

curl „Objektum áthelyezve” hiba

Ha a curl parancs hibát ad vissza az -L paraméterrel kapcsolatban, vagy ha „Objektum áthelyezve” szövegű hibaüzenetet kap, próbálkozzon az aka.ms átirányítás helyett a teljes URL-cím használatával:

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

Az az parancs nem található

Ha a telepítés bash zshután nem tudja futtatni a parancsot, vagy próbálja meg törölni a rendszerhéj parancskivonat-gyorsítótárát, és ellenőrizze, hogy a probléma megoldódott-e.

hash -r

Ez a probléma akkor is előfordulhat, ha a telepítést követően nem indította újra a felületet. Győződjön meg róla, hogy a(z) az parancs helye a(z) $PATH. A parancs helye az ...

 <install path>/bin

Egy proxy blokkolja a kapcsolatot

Ha proxy miatt nem tud külső erőforráshoz csatlakozni, győződjön meg arról, hogy helyesen állította be a rendszerhéjban lévő HTTP_PROXY változókat és HTTPS_PROXY változókat. Forduljon a rendszergazdához, hogy tudja, milyen gazdagép(ek) és port(ok) használhatók ezekhez a proxykhoz.

Az ezekben a változókban szereplő értékeket számos Linux-program használja, és a telepítési folyamat során. Az értékek beállítása:

# 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]

Fontos

Ha proxy mögött áll, ezeket a rendszerhéjváltozókat úgy kell beállítani, hogy a parancssori felülettel csatlakozzanak az Azure-szolgáltatásokhoz. Ha nem alapszintű hitelesítést használ, javasoljuk, hogy exportálja ezeket a változókat a .bashrc fájlba. Mindig kövesse az üzleti biztonsági szabályzatokat és a rendszergazda követelményeit.

A telepítési szkriptek beszerzéséhez a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címekre:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • A disztribúció csomagkezelője által használt végpontok (ha vannak ilyenek) az alapcsomagokhoz

A parancssori felület nem telepíthető vagy futtatható Linuxos Windows-alrendszer

Mivel a Linuxos Windows-alrendszer (WSL) egy rendszerhívás fordítási rétege a Windows platform tetején, hibaüzenetet tapasztalhat az Azure CLI telepítésekor vagy futtatásakor. A parancssori felület olyan funkciókra támaszkodik, amelyek a WSL-ben hibát okozhatnak. Ha a parancssori felület telepítésétől függetlenül hibát tapasztal, akkor jó eséllyel ez a WSL-vel kapcsolatos probléma, és nem a parancssori felület telepítési folyamatával kapcsolatos.

A WSL-telepítés hibaelhárításához és a problémák megoldásához:

  • Ha lehetséges, futtasson egy azonos telepítési folyamatot linuxos gépen vagy virtuális gépen, hogy kiderüljön, sikeres-e. Ha igen, a probléma valószínűleg a WSL-hez kapcsolódik. Linux rendszerű virtuális gép Azure-beli elindításához tekintse meg a Linux rendszerű virtuális gép létrehozását az Azure Portal dokumentációjában.
  • Győződjön meg arról, hogy a WSL legújabb verzióját futtatja. A legújabb verzió beszerzéséhez frissítse a Windows 10 telepítését.
  • Ellenőrizze, hogy vannak-e nyitott problémák a WSL-vel kapcsolatban, amelyek megoldhatják a problémát. Gyakran vannak javaslatok a probléma megkerülésére, vagy olyan kiadásra vonatkozó információk, amelyekben a probléma ki lett javítva.
  • Ha a probléma nem áll fenn, küldjön egy új problémát a WSL-hez, és győződjön meg arról, hogy a lehető legtöbb információt adja meg.

Ha továbbra is problémákat tapasztal a WSL telepítésével vagy futtatásával kapcsolatban, fontolja meg a Windows parancssori felületének telepítését.

Következő lépések

Most, hogy telepítette az Azure parancssori felületét, tekintsük át röviden a funkcióit és a gyakori parancsait.