Azure CLI telepítése macOS rendszeren – előzetes verzió

Azure CLI egy platformfüggetlen parancssori eszköz, a Azure erőforrások interaktív vagy szkripteken keresztüli kezelésére.

MacOS rendszeren Azure CLI a Homebrew Core-képletről egy karbantarthatóbb és rugalmasabb telepítési modellre vált. Az új modell a következőket tartalmazza:

  • Homebrew Cask (a legtöbb felhasználó számára ajánlott)
  • Tarball (offline vagy elszigetelt környezetekhez ajánlott)

Ez a felület jelenleg előzetes verzióban érhető el, és egy későbbi kiadásban a szokásos telepítési megközelítés lesz.

Miért érdemes a Homebrew Caskot használni?

  • A legegyszerűbb telepítési és frissítési felület
  • Függőségek automatikus kezelése
  • Igazodik a jövőbeli támogatott telepítési modellhez

Mi változik?

Azure CLI fejlődik a biztonságosabb hitelesítés támogatása érdekében, beleértve a közvetítőalapú hitelesítést is. Ezekhez a képességekhez cask-alapú telepítési modell szükséges. Ennek eredményeként a Homebrew Core-ról a Homebrew Caskra váltunk. Ez a módosítás nem távolítja el vagy korlátozza a meglévő Azure CLI funkciókat. A Homebrew Cask teljes mértékben kompatibilis az összes jelenlegi Azure CLI funkcióval és verzióval.

Ez a módosítás javítja a környezetek konzisztenciáját, és jobb támogatást nyújt az olyan forgatókönyvekhez, mint az offline telepítés és a szabályozott üzembe helyezési környezetek.

Important

Azure CLI jelenleg a Homebrew Cask telepítési modell előzetes fázisában van. Ebben a fázisban a telepítés csak egyéni Homebrew koppintással érhető el.

  • Jelenlegi módszer: brew install azure-cli
  • Új módszerek (előzetes verzió):
    • Homebrew Cask egyéni koppintással
      1. brew tap azure/azure-cli
      2. brew install --cask azure-cli-preview
    • Tarball-alapú telepítés

Telepítési módszer kiválasztása

Az alábbi útmutató segítségével válassza ki a forgatókönyvnek leginkább megfelelő telepítési módszert:

Scenario Ajánlott módszer
A felhasználók többsége Homebrew Cask
Offline vagy légmentesen elzárt rendszerek Tarball
Egyéni telepítési hely szükséges Tarball

Azure CLI telepítése a Homebrew Cask használatával

A Homebrew a legegyszerűbb és leginkább karbantartható telepítési élményt nyújt a macOS Azure CLI számára. Szabványos csomagkezelési munkafolyamatokkal kezeli a telepítést, a frissítéseket és az eltávolítást.

Prerequisites

  • macOS (Apple Silicon vagy Intel)
  • Homebrew telepítve

Ha Azure CLI már telepítve van a Homebrew képlet használatával, távolítsa el az ütközések elkerülése érdekében:

brew uninstall azure-cli

Az Azure CLI telepítése

Ez telepíti az Azure CLI-t a Homebrew Cask használatával az Azure CLI egyéni tárolójából. Ez az egyetlen támogatott Homebrew telepítési módszer az előzetes fázisban.

brew tap azure/azure-cli
brew install --cask azure-cli-preview

Telepítés ellenőrzése

A telepítés után ellenőrizze, hogy elérhető-e Azure CLI:

az --version

Azure CLI frissítése

Frissítés a legújabb verzióra:

brew update && brew upgrade --cask azure-cli-preview

Az Azure CLI eltávolítása

A Azure CLI eltávolítása:

brew uninstall --cask azure-cli-preview
brew untap azure/azure-cli

Az előzetes verzió fázisa után

Amikor a Homebrew Cask telepítése általánosan elérhetővé válik:

  • Az előzetes telepítési módszer (azure-cli-preview egyéni koppintással) megszűnik.
  • Azure CLI elérhető lesz a hivatalos Homebrew Cask-adattárból.

Telepítse a Azure CLI a következő használatával:

brew install --cask azure-cli
# Or
brew install azure-cli

A Homebrew Core képletet használó meglévő telepítéseket át kell telepíteni a Cask-alapú telepítésre. Az átmenet után a Homebrew Core csomag már nem lesz támogatott.

Azure CLI telepítése Tarball használatával

Ezt a módszert akkor használja, ha:

  • A Homebrew nem érhető el
  • Az internet-hozzáférés korlátozott
  • Teljes hozzáférésre van szüksége a telepítési hely felett

Ezt a módszert gyakran használják vállalati, szabályozott vagy levegővel elválasztott környezetekben.

Prerequisites

  • macOS (Apple Silicon vagy Intel)
  • Python 3.13 bármilyen módszerrel telepítve (python.org, pyenv stb.)

A tarball letöltése

Az internetkapcsolattal rendelkező gépeken automatikusan letöltheti az architektúra legújabb Azure CLI tarballját:

ARCH=$(uname -m)
VER=$(curl -s https://api.github.com/repos/Azure/azure-cli/releases/latest | grep tag_name | cut -d '"' -f4 | sed 's/azure-cli-//')
curl -L -o az.tar.gz "https://github.com/Azure/azure-cli/releases/download/azure-cli-$VER/azure-cli-$VER-macos-$ARCH.tar.gz"

Ez a szkript észleli az architektúrát, és letölti a legújabb Azure CLI tarballt a Azure CLI kiadások oldaláról.

  • arm64 az Apple Silicon-t jelzi
  • x86_64 Az Intelt jelzi

A megfelelő architektúra kiválasztása biztosítja a kompatibilitást és az optimális teljesítményt.

Tip

Offline környezetek esetén futtassa ezt a parancsot egy internetkapcsolattal rendelkező gépen, majd vigye át a letöltött tarballt a célrendszerbe.

Kinyerés a telepítési könyvtárba

Válasszon egy könyvtárat, amelyben Azure CLI telepíteni kell:

mkdir -p $HOME/lib/azure-cli
tar -xzf az.tar.gz -C $HOME/lib/azure-cli

Környezeti változók konfigurálása

Azure CLI hozzáférést igényel egy Python futtatókörnyezethez. Konfigurálja a környezetet úgy, hogy a Python és a Azure CLI bináris fájlokra mutasson.

Adja hozzá a következőket a rendszerhéjprofilhoz (~/.zshrc vagy ~/.bashrc):

export AZ_PYTHON="/path_to_python"
export PATH="/target_directory_path/bin:$PATH"

Töltse újra a parancssor konfigurációját.

source ~/.zshrc

Telepítés ellenőrzése

az --version

Azure CLI frissítése

Ha offline környezetben szeretné frissíteni Azure CLI, töltsön le egy újabb Tarballt, és bontsa ki a meglévő telepítésen keresztül:

sudo tar -xzf az.tar.gz -C /target_directory_path

Az Azure CLI eltávolítása

Távolítsa el a telepítési könyvtárat:

sudo rm -rf /target_directory_path

Ezután távolítsa el a AZ_PYTHON és PATH bejegyzéseket a rendszerhéjprofilból.

Troubleshooting

Ha problémát tapasztal a Azure CLI Homebrew Cask vagy a Tarball metódussal történő telepítésekor vagy használatakor, íme néhány gyakori hiba (amelyek közül sok a Homebrew-ra jellemző). Ha olyan problémát tapasztal, amelyet itt nem tárgyaltunk, jelentsen egy hibát a GitHubon.

Azure CLI nem található

Győződjön meg arról, hogy a PATH tartalmazza a telepítési könyvtárat:

echo $PATH

A teljesítés nem működik

Az Azure CLI Homebrew telepítése (akár formula, akár cask útján) egy az nevű kiegészítő fájlt biztosít a Homebrew által kezelt automatizált kiegészítések könyvtárában. A befejezés engedélyezéséhez kövesse a Homebrew utasításait.

A Zsh esetében adja hozzá a következő két sort a .zshrc fájl aljára, majd mentse és töltse újra a Zsh-profilt.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Nem található Python vagy telepített csomag

Előfordulhat, hogy egy kis verzió különbség vagy más probléma merül fel a homebrew telepítése során. Azure CLI nem használ Python virtuális környezetet, ezért a telepített Python verzió megkeresésére támaszkodik. A lehetséges javítás a python@3.13 telepítése és ismételt csatolása a Homebrew segítségével.

brew update && brew install python@3.13 && brew upgrade python@3.13
brew link --overwrite python@3.13

Egy proxy blokkolja a kapcsolatot

Előfordulhat, hogy nem tud erőforrásokat lekérni a Homebrew-ból, hacsak nem konfigurálja a proxy használatára. Kövesse a Homebrew proxy konfigurációs utasításait.

Important

Ha egy proxy mögött van, HTTP_PROXY és HTTPS_PROXY úgy kell beállítani, hogy csatlakozhasson az Azure szolgáltatásokhoz az Azure CLI segítségével. Ha nem használ alapszintű hitelesítést, 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 palackerőforrások Homebrew-ból való lekéréséhez a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címekre:

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

Következő lépések

Most, hogy telepítette az Azure CLI-t macOS rendszerre, tekintse meg a funkcióit és a gyakori parancsokat.

Kezdje el használni az Azure CLI-t

  • Last updated on