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 2.70.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:
Importálja a Microsoft-adattár kulcsát.
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
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 .
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ő parancs használatával letöltheti és telepítheti az Azure CLI telepítési szkriptet a forráskódból készült 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-hez szükség van SSL 1.1+
, és a openssl 1.1
-et a forrásból kell felépíteni mielőtt a python3
-et felépítené.
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.
Jegyzet / 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 found
jelenik meg. Győződjön meg róla, hogy az bekerült az elérési útba.
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
Proxy mögötti használat esetén ezeket a rendszerhéjváltozókat be kell állítani, hogy a CLI segítségével csatlakozhasson 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.conf
alatt:
[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 CLI nem telepíthető vagy futtatható a Linux számára készült Windows-alrendszeren.
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 nem található meglévő probléma a kérdésével kapcsolatban, jelentsen be egy új problémát a WSL-hez, és győződjön meg arról, hogy a lehető legtöbb információt megad.
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:
Használja a SUSE által a SUSE /OpenSUSE-adattárakban biztosított Vállalati csomagot.
Használja a "Szkript telepítése (bármely)" lapon leírt telepítési módszert.
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)
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 telepítés folytatásához írja be a 2-est, figyelmen kívül hagyva 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 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 a /usr/local/azcli
alá, és az PATH=/usr/local/azcli/bin:$PATH az
alias az
beállításával az Azure CLI ezt fogja használni. 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 egy proxy mögött tartózkodik, ezeket a rendszerhéjváltozókat kell beállítani, hogy a parancssori felületen keresztül csatlakozhasson 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 a zypper
(a yast2
segítségével), hogy 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 Network Services > Proxy
panelt is használhatja a YaST Control Center
-ben.
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 CLI nem telepíthető vagy nem futtatható a Windows alatti Linux alrendszeren.
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 nincs meglévő probléma, adjon hozzá egy új bejelentést 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ó Debian 11 (Bullseye), 12 (Bookworm) Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Medúza), 24.04 (Noble Numbat) Az Ubuntu 20.04 (Focal Fossa) és 20.10 (Groovy Gorilla) egy
azure-cli
csomagot tartalmaz a2.0.81
verzióval, amelyet auniverse
adattár biztosít. 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ávalsudo apt remove azure-cli -y && sudo apt autoremove -y
. További információkért lásd azapt remove
vagy az Ubuntu csomagkezelési dokumentációját, vagy az ask ubuntu oldalt.
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 curl
-on keresztül töltődik le, és közvetlenül átirányítva a bash
-hoz telepíti a parancssori felületet.
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 | gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null 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 a Nem található az azure-cli csomag hibaüzenetet kapja, akkor 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 a Version x.xx.x-1~distributionName for azure-cli hibaüzenetet kapja, használja lsb_release -cs
a használt 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, amelyeknek a függőségei nem változtak.
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
apt-get remove
segítségével: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 a Focal
-ra a azure-cli
szoftvert anélkül telepítetted, hogy hozzáadtad volna az Azure CLI szoftvertárat, vagy a mi szkriptünkkel dolgoztál volna, akkor olyan problémákkal találkozhatsz, mint például a 'decorator' vagy 'antlr4' nevű modul hiánya, mivel az általad telepített csomag a focal/universe
tárolóból származó elavult azure-cli 2.0.81
. 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_release
adjá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óval kapcsolatos információkat arra vonatkozóan, hogyan állapítható meg az alap disztribúció kódneve, és állítsa be AZ_REPO
-t a helyes értékre.
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, a AZ_REPO
értékét manuálisan állítsa be az adattár hozzá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 az HERA
EOS-kiadás nevét. A megoldás a /etc/apt/sources.list.d/azure-cli.sources
fájl javítása és a Suites: hera
módosítása Suites: bionic
-re.
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 megtudja, milyen gazdagép(ek) és port(ok) használhatók ezekhez a proxyszerverekhez.
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 egy proxy mögött van, ezeket a shell változókat be kell állítani ahhoz, hogy a parancssori felület segítségével csatlakozzon 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 /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 40proxies
99local
, 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ó a Windows rendszer Linux-alrendszerén
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.
Az Azure CLI telepítési szkriptjének használatához a következő szoftver szükséges:
- Python 3.8.x, 3.9.x, 3.10.x – További információ: Támogatási életciklus – Python-függőség.
- libffi
- OpenSSL 1.0.2
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ó. Elképzelhető, hogy újra kell indítania a parancssori környezetet 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
vagyzsh
használatakor töltse be újra a shell 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 után nem tudja futtatni a parancsot bash
vagy zsh
használatával, 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 parancsértelmezőt. 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 proxyt használ, a shell változókat úgy kell beállítani, hogy a CLI-val csatlakozhasson 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 CLI nem telepíthető vagy futtatható a Windows alrendszer a Linuxhoz rendszerben.
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 nem léteznek meglévő ügyek az Ön problémájára, nyisson egy új ügyet a WSL-re, és győződjön meg arról, hogy a lehető legtöbb információt adjon 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.