Aracılığıyla paylaş


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 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 Dev Container'da Yeniden Oluştur ve 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 Visual Studio Code'da Geliştirme Kapsayıcısında Yeniden Oluştur ve Yeniden Aç komutunu kullanarak kapsayıcıyı güncelleştirilmiş uzantılarla yeniden oluşturun.

azd Dev Container Özelliği 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

eski bir sürümüyle çalışırken, en son sürüme azdyükseltmeye yönelik bir uyarı görürsünüz. En son sürüme güncelleştirmek için uyarıdaki yönergeleri izleyin.

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