Az Azure CLI telepítése Linuxon

Mielőtt elkezdené

Az Azure CLI 2.38.1 (2023. szeptember 01-én jelent meg) az RHEL 7 és a Centos 7 utolsó támogatott verziója, és az operációs rendszerek élettartamának végéig továbbra is megkapja a biztonsági javításokat. A Microsoft nem biztosít más 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:

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

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

RHEL 9 vagy CentOS Stream 9 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 vagy CentOS Stream 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 vagy CentOS 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

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.

Az elérhető verziók megtekintése a paranccsal:
```
dnf list --showduplicates azure-cli
```

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.

Távolítsa el a csomagot a rendszerről.
```
sudo dnf remove azure-cli
```
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
```

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.1 (2023. szeptember 01-én jelent meg) az SU Standard kiadás Linux Enterprise Server (SLES) és az OpenSU Standard kiadás (Ugrás) legújabb verziója, és 2024 június végéig továbbra is megkapja a biztonsági javításokat. A Microsoft nem biztosít más 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 SU Standard kiadás fenntartja és támogatja az SU Standard kiadás/OpenSU Standard kiadás adattárak által biztosított csomagokat.
Az Azure-ban a SU Standard kiadás és az OpenSU Standard kiadás Azure Marketplace-rendszerképeken alapuló virtuális gépeken már telepítve van az Azure CLI.

Telepítse az Azure CLI-t

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

Használja az SU Standard kiadás által biztosított Vállalati csomagot az SU Standard kiadás/OpenSU Standard kiadás adattárakban.
Használja a "Szkript telepítése (bármely)" lapon leírt telepítési módszert.
Telepítés a Microsoft-adattárakból

Telepítés SU Standard kiadás vagy OpenSU Standard kiadás 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 OpenSU Standard kiadás Ugrás 15.1)

curl telepítése:
```
sudo zypper install -y curl
```

Importálja a Microsoft tárházbeli kulcsát:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

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

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.

Tekintse meg az elérhető verziókat a következő paranccsal:
```
zypper search --details --match-exact azure-cli
```

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.

Távolítsa el a csomagot a rendszerről.
```
sudo zypper remove -y azure-cli
```
Ha nem tervezi a CLI újratelepítését, távolítsa el az adattár információit.
```
sudo zypper removerepo azure-cli
```

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 OpenSU-n Standard kiadás 15 virtuális gép

Az OpenSU Standard kiadás 15 virtuális gép előre telepített Azure CLI-vel rendelkezik a 2.0.45-ös verzióval, amely elavult, és problémákat tapasztalaz 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 azPATH=/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 > ProxyYaST Control Center.

Speciális konfigurációs vagy további információkért tekintse meg az OpenSU Standard kiadás 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)

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

Disztribúció	Verzió
Ubuntu	20.04 LTS (Focal Fossa), 22.04 (Jammy Medúza)
Debian	10 (Buster), 11 (Bullseye), 12 (Bookworm)

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.

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

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 |
  sudo gpg --dearmor -o /etc/apt/keyrings/microsoft.gpg
sudo chmod go+r /etc/apt/keyrings/microsoft.gpg

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

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.

Az Azure CLI elérhető verzióinak megtekintése.
```
apt-cache policy azure-cli
```

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.

Eltávolítás a következővel apt-get remove:
```
sudo apt-get remove -y azure-cli
```
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
```
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
```
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-cliFocal, 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: heraSuites: 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:

Telepítse a Microsoft által kiadott megbízható főtanúsítványok hivatalos készletét:
```
sudo tdnf install ca-certificates
```
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.

A CLI-hez az alábbi szoftverek szükségesek:

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

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).

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

rm -r <install location>/lib/azure-cli
rm <install location>/bin/az

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
```
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 bashzshutá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. Az az parancs helye:

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

Az Azure CLI telepítése Linuxon

Mielőtt elkezdené

Telepítse az Azure CLI-t

Adott verzió telepítése

Az Azure CLI frissítése

Az Azure CLI eltávolítása

Adatok eltávolítása

Hibaelhárítás

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

Egy proxy blokkolja a kapcsolatot

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

Mielőtt elkezdené

Telepítse az Azure CLI-t

Telepítés SU Standard kiadás vagy OpenSU Standard kiadás adattárakból

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

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

Adott verzió telepítése

Az Azure CLI frissítése

Az Azure CLI eltávolítása

Adatok eltávolítása

Hibaelhárítás

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

NotImplementedError az OpenSU-n Standard kiadás 15 virtuális gép

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

Egy proxy blokkolja a kapcsolatot

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

SSL-tanúsítványhiba

Mielőtt elkezdené

Telepítse az Azure CLI-t

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

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

Adott verzió telepítése

Az Azure CLI frissítése

Az Azure CLI eltávolítása

Adatok eltávolítása

Hibaelhárítás

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

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

Nincs csomag a disztribúcióhoz

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

Egy proxy blokkolja a kapcsolatot

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

Telepítse az Azure CLI-t

Adott verzió telepítése

Az Azure CLI frissítése

Az Azure CLI eltávolítása

Adatok eltávolítása

Mielőtt elkezdené

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

Az Azure CLI eltávolítása

Adatok eltávolítása

Hibaelhárítás

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

curl „Objektum áthelyezve” hiba

Az az parancs nem található

Egy proxy blokkolja a kapcsolatot

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

Következő lépések

További források

Az `az` parancs nem található