Menginstal atau memperbarui CLI Pengembang Azure

Selamat datang di Azure Developer CLI (azd)! Mari kita mulai menginstal dan mempelajari cara menjalankan azd.

Mulailah dengan memilih lingkungan pengembangan Anda. Untuk informasi selengkapnya tentang pro dan kontra dari berbagai pilihan lingkungan pengembangan, lihat lingkungan yang didukung Azure Developer CLI (azd).

Untuk skenario dan instruksi penginstalan yang lebih canggih, lihat Skrip Penginstal Azure Developer CLI.

Catatan: Saat Anda menginstal azd, alat berikut diinstal dalam ruang lingkup azd (artinya alat tersebut tidak diinstal secara global) dan dihapus jika azd di-uninstall.

Menginstal azd

winget install microsoft.azd

Pembaruan azd

winget upgrade microsoft.azd

Copot pemasangan azd

winget uninstall microsoft.azd

Nota

Pada Apple Silicon Macs (M1 dan M2) azd memerlukan Rosetta 2. Jika Rosetta 2 belum diinstal, jalankan softwareupdate --install-rosetta dari terminal.

Proses azd penginstalan akan secara otomatis memilih biner yang benar untuk arsitektur komputer Anda.

Menginstal azd

brew install azure/azd/azd

Jika Anda menggunakan brew untuk memutakhirkan azd dari versi yang tidak diinstal menggunakan brew, hapus versi yang ada menggunakan skrip penghapusan instalasi azd (jika diinstal ke lokasi default) atau dengan menghapus biner azd secara manual. Ini akan secara otomatis menginstal versi yang benar.

Pembaruan azd

brew upgrade --cask azure/azd/azd

Copot pemasangan azd

brew uninstall azd

Menginstal azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Pembaruan azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Saat Anda menginstal azd, alat berikut diinstal dalam cakupan azd (artinya alat tersebut tidak diinstal secara global) dan akan dihapus jika azd diuninstall.

Copot pemasangan azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

Prasyarat

Sebelum Anda mulai menggunakan azd, pastikan Anda memiliki:

Menginstal azd dalam kontainer dev

Kontainer pengembangan adalah gambar Docker yang mencakup semua prasyarat yang Anda butuhkan untuk menjalankan aplikasi di komputer lokal Anda. Instal azd sebagai fitur di kontainer dev Anda melalui langkah-langkah berikut:

  1. Tambahkan fitur azd ke dalam file devcontainer.json pada folder .devcontainer di root templat Anda.

    {
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        // See https://containers.dev/features for list of features
        "ghcr.io/devcontainers/features/docker-in-docker:2": {
        },
        "ghcr.io/azure/azure-dev/azd:latest": {}
    }
    // Rest of file omitted...
}

  2. Membangun ulang dan menjalankan kontainer pengembangan Anda. Di Visual Studio Code, gunakan palet komand untuk menjalankan perintah Rebuild dan Buka kembali di Kontainer Dev.

Menginstal ekstensi azd secara otomatis

azd Fitur Kontainer Dev mendukung extensions opsi untuk secara otomatis menginstal daftar ekstensi azd yang dipisahkan dengan koma selama proses build kontainer. Ekstensi yang diinstal dengan cara ini tersedia segera setelah kontainer dimulai, mengurangi penyiapan manual dan memungkinkan azd perintah untuk berjalan dengan ekstensi yang diperlukan yang sudah diinstal.

Untuk menginstal ekstensi secara otomatis, tambahkan extensions opsi ke azd entri fitur di file Anda devcontainer.json :

{
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        "ghcr.io/azure/azure-dev/azd:latest": {
            "extensions": "my-ext-1,my-ext-2"
        }
    }
}

Nilainya extensions adalah daftar nama ekstensi yang azd dipisahkan koma. Penginstalan terjadi selama build kontainer, sehingga ekstensi siap digunakan segera setelah kontainer dimulai. Setelah mengubah daftar ekstensi, gunakan perintah Rebuild dan Buka kembali di Kontainer Dev di Visual Studio Code untuk membangun kembali kontainer dengan ekstensi yang diperbarui.

Pelajari selengkapnya tentang fitur azd Dev Container.

Memverifikasi penginstalan Anda

Verifikasi bahwa penginstalan Anda azd berhasil diselesaikan dengan menjalankan azd version perintah di terminal:

azd version

azd mencetak versi saat ini:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Memperbarui CLI Pengembang Azure

Anda dapat memperbarui azd menggunakan perintah bawaan azd update (Beta) atau secara manual menggunakan metode yang sama dengan yang Anda gunakan untuk menginstalnya.

Gunakan azd update (Beta)

azd update Perintah mendeteksi bagaimana azd awalnya diinstal dan mendelegasikan ke metode pembaruan yang sesuai secara otomatis:

Metode penginstalan Apa yang azd update dilakukan
winget Menjalankan winget upgrade Microsoft.Azd
choco Menjalankan choco upgrade azd
Menginstal skrip atau MSI (Windows) install-azd.ps1 Berjalan dengan pencadangan dan pemulihan otomatis
Menginstal skrip (Linux/macOS) Menjalankan install-azd.sh
Homebrew Menjalankan brew upgrade --cask azure/azd/azd
.deb / .rpm Paket Langsung mengunduh dan mengganti biner

Jalankan perintah berikut untuk memperbarui ke versi stabil terbaru:

azd update

Nota

Perintah azd update saat ini berada di Beta. Baca selengkapnya tentang dukungan fitur alfa dan beta pada halaman penerapan versi fitur dan strategi rilis .

Beralih ke saluran pembaruan

azd mendukung dua saluran pembaruan: stable (default) dan daily. Pengalihan saluran didukung untuk penginstalan berbasis skrip dan Homebrew. Jika Anda menginstal azd melalui winget atau choco, build harian tidak tersedia melalui manajer paket tersebut - azd update akan menampilkan panduan untuk menginstal ulang melalui skrip terlebih dahulu.

Untuk beralih ke daily saluran dan memperbarui:

azd update --channel daily

Untuk beralih kembali ke stable saluran:

azd update --channel stable

Saat beralih saluran, azd meminta konfirmasi sebelum melanjutkan.

Menggunakan manajer paket Anda atau menginstal skrip

Anda juga dapat memperbarui secara manual kapan saja menggunakan manajer paket yang sama atau menginstal perintah skrip yang ditunjukkan di bagian penginstalan di atas. Ketika azd sudah kedaluarsa, ini menampilkan pesan peringatan dengan perintah pembaruan yang berlaku untuk metode penginstalan Anda.

Minta bantuan

Untuk informasi tentang cara mengajukan bug, meminta bantuan, atau mengusulkan fitur baru untuk Azure Developer CLI, silakan kunjungi halaman troubleshooting dan dukungan.

Langkah selanjutnya

Panduan Cepat - Pemilihan dan penerapan templat azd

Apa saja templat CLI Pengembang Azure?

FAQ CLI Pengembang Azure

  • Last updated on