Azure Geliştirici CLI'sını yükleme veya güncelleştirme

Azure Geliştirici CLI'sine (azd) hoş geldiniz! Hadi azd uygulamasını yüklemeye ve çalıştırmayı öğrenmeye başlayalım.

Başlangıç olarak geliştirme ortamınızı seçin. Farklı geliştirme ortamı seçimlerinin avantajları ve dezavantajları hakkında daha fazla bilgi için bkz. Azure Developer CLI (azd) tarafından desteklenen ortamlar.

Daha gelişmiş yükleme senaryoları ve yönergeler için bkz. Azure Developer CLI Yükleyici Betikleri.

Not: azd yüklediğinizde, aşağıdaki araçlar azd kapsamında yüklenirler (yani, global olarak yüklenmezler) ve azd kaldırıldığında kaldırılırlar.

azd yükleme

winget install microsoft.azd

Güncelleme azd

winget upgrade microsoft.azd

Kaldır azd

winget uninstall microsoft.azd

Uyarı

Apple Silicon Mac'lerde (M1 ve M2) azd Rosetta 2 gerektirir. Rosetta 2 zaten yüklü değilse terminalden çalıştırın softwareupdate --install-rosetta .

azd Yükleme işlemi, makinenizin mimarisi için doğru ikiliyi otomatik olarak seçer.

azd yükleme

brew install azure/azd/azd

Eğer brew kullanarak azd ile yüklenmemiş bir sürümü brew yükseltiyorsanız, mevcut azd sürümünü kaldırma betiği ile (varsayılan yere yüklendiyse) veya azd çalıştırılabilir dosyasını elle silerek kaldırın. Bu, doğru sürümü otomatik olarak yükler.

Güncelleme azd

brew upgrade --cask azure/azd/azd

Kaldır azd

brew uninstall azd

azd yükleme

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

Güncelleme azd

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

yüklediğinizde azd, aşağıdaki araçlar kapsam içinde azd yüklenir (genel olarak yüklenmedikleri anlamına gelir) ve azd kaldırılırsa kaldırılır:

Kaldır azd

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

Önkoşullar

kullanmaya azdbaşlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

azd geliştirici kapsayıcısına yükle

Geliştirme kapsayıcısı, yerel makinenizde bir uygulama çalıştırmak için ihtiyacınız olan tüm önkoşulları içeren bir Docker görüntüsüdür. Aşağıdaki adımları izleyerek geliştirme kapsayıcınıza özellik olarak yükleyin azd :

  1. azd özelliğini, şablonunuzun kökündeki devcontainer.json klasöründeki .devcontainer dosyasına ekleyin.

    {
    "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. Geliştirme konteynerinizi yeniden derleyin ve çalıştırın. Visual Studio Code'da komut paletini kullanarak Yeniden Derle ve Geliştirici Kapsayıcısında Yeniden Aç komutunu çalıştırın.

Azd uzantılarını otomatik yükleme

Geliştirme Kapsayıcısı azd Özelliği, kapsayıcı derlemesi sırasında uzantıların extensions virgülle ayrılmış listesini otomatik olarak yükleme seçeneğini desteklerazd. Kapsayıcı başlatıldığı anda bu şekilde yüklenen uzantılar kullanılabilir; manuel kurulum ihtiyacı azalır ve komutlar gerekli uzantılar zaten yüklü olarak başlatılabilir azd .

Uzantıları otomatik olarak yüklemek için dosyanızdaki extensions özellik girişine azd seçeneğini ekleyindevcontainer.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"
        }
    }
}

extensions Değer, uzantı adlarının azd virgülle ayrılmış bir listesidir. Yükleme kapsayıcı derlemesi sırasında gerçekleşir, bu nedenle uzantılar kapsayıcı başlar başlamaz hemen kullanıma hazır olur. Uzantı listesini değiştirdikten sonra, kapsayıcıyı güncelleştirilmiş uzantılarla yeniden derlemek için Visual Studio Code içinde Yeniden Derle ve Dev Container'da Yeniden Aç komutunu kullanın.

azd Dev Container Feature hakkında daha fazla bilgi edinin.

Yüklemenizi doğrulama

Terminalde azd komutunu çalıştırarak azd version kurulumun başarıyla tamamlandığını doğrulayın:

azd version

azd geçerli sürümü yazdırır:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Azure Geliştirici CLI'sını güncelleştirme

Yerleşik azd komutu (Beta) kullanarak veya yüklemek için kullandığınız yöntemi kullanarak manuel olarak azd update güncelleştirebilirsiniz.

Kullan azd update (Beta)

Komut, azd update ilk olarak nasıl azd yüklendiğini algılar ve uygun güncelleme yöntemine otomatik olarak devreder.

Install yöntemi azd update ne yapar?
winget winget upgrade Microsoft.Azd çalıştırır
choco choco upgrade azd çalıştırır
Betik veya MSI yüklemesi (Windows) Otomatik yedekleme ve geri yükleme ile çalışır install-azd.ps1
Scripti Kurma (Linux/macOS) install-azd.sh çalıştırır
Homebrew brew upgrade --cask azure/azd/azd çalıştırır
.deb / .rpm Paket İkili dosyayı doğrudan indirir ve yenisiyle değiştirir

En son kararlı sürüme güncelleştirmek için aşağıdaki komutu çalıştırın:

azd update

Uyarı

Komut azd update şu anda Beta sürümündedir. Özellik sürüm oluşturma ve sürüm stratejisi sayfasında alfa ve beta özellik desteği hakkında daha fazla bilgi edinin.

Güncelleştirme kanallarını değiştirme

azd iki güncelleştirme kanalını destekler: stable (varsayılan) ve daily. Kanal değiştirme, betik tabanlı yüklemeler ve Homebrew için desteklenir. azd veya winget veya choco aracılığıyla yüklediyseniz, günlük derlemeler bu paket yöneticileri aracılığıyla kullanılamaz. azd update, ilk olarak betik aracılığıyla yeniden yükleme yapmak için yönergeler gösterecektir.

Kanala geçmek ve güncelleştirmek için daily :

azd update --channel daily

Kanala geri dönmek için stable :

azd update --channel stable

Kanallar arasında geçiş yaparken, azd devam etmeden önce onay ister.

Paket yöneticinizi kullanma veya betiği yükleme

Ayrıca, istediğiniz zaman aynı paket yöneticisini kullanarak el ile güncelleştirebilir veya yukarıdaki yükleme bölümlerinde gösterilen betik komutlarını yükleyebilirsiniz. azd Güncel olmadığında, yükleme yönteminiz için geçerli güncelleştirme komutunu içeren bir uyarı iletisi görüntüler.

Yardım isteme

Azure Geliştirici CLI'si için hata oluşturma, yardım isteme veya yeni bir özellik önerme hakkında bilgi için lütfen troubleshooting and support sayfasını ziyaret edin.

Sonraki Adımlar

Hızlı Başlangıç - Azd şablonu seçme ve dağıtma

Azure Developer CLI şablonları nedir?

Azure Developer CLI Sık Sorulan Sorular

  • Last updated on