Yeni bir Azure Geliştirici CLI (azd) şablonuyla başlayın

Standart dosyaları yeni bir Azure Geliştirici CLI (azd) şablonunda oluşturmak için farklı yazma yöntemleri kullanabilirsiniz:

  • azd init içinde GitHub Copilot tümleştirmesini kullanın. Yerleşik iş akışı mevcut proje dosyalarını analiz eder veya yeni bir proje planlamanıza, şablon varlıklarını oluşturmanıza ve dağıtım öncesi doğrulamayı çalıştırmanıza yardımcı olur.
  • Başka bir yapay zeka kodlama yardımcısı kullanın. Yardımcıdan, azure.yaml ile doğrudan tümleştirmeden, aynı azd init, altyapı kodunu, uygulamayı ve destekleyici dosyaları oluşturmasını isteyin.
  • Dosyaları doğrudan yazın. Tam denetim istediğinizde veya yapay zeka kodlama yardımcısı kullanmadığınızda şablon varlıklarını kendiniz oluşturun ve düzenleyin.

Bu makale, öncelikle yerleşik GitHub Copilot iş akışına odaklanır çünkü azd ile tümleşik, yönlendirmeli bir deneyim sunar. Yazma yönteminden bağımsız olarak, dağıtımdan önce her dosyayı gözden geçirin ve doğrulayın.

Önemli

azd init içindeki GitHub Copilot tümleştirmesi önizleme sürümündedir. Önizleme özellikleri genel kullanıma sunulmadan önce değişebilir. Daha fazla bilgi için bkz: azdözellik sürümlendirmesi ve sürüm stratejisi.

Oluşturulan varlıklar standart, düzenlenebilir azd şablon dosyalarıdır. Başlatma işleminden sonra bunları doğrudan veya herhangi bir yapay zeka kodlama yardımcısı ile güncelleştirebilirsiniz.

GitHub Copilot önkoşulları

Yerleşik Copilot iş akışını kullanmak için şunları yapmanız gerekir:

  • Azure Geliştirici CLI 1.23.11 veya üzeri.
  • Etkin bir GitHub Copilot aboneliği.
  • Git, azd init dosyaları değiştirmeden önce çalışma ağacını incelemek için kullanır.
  • Etkileşimli terminal oturumu.

GitHub Copilot'ta henüz kimliğiniz doğrulanmadıysa, azd oturum açmanızı ister.

Yüklü Azure Geliştirici CLI sürümünü denetlemek için komutunu çalıştırınazd version.

Note

İş azd init akışı, terminalde ayrılmış bir GitHub Copilot aracısı oturumu başlatır. Visual Studio Code'da etkin bir GitHub Copilot Chat oturumunu kullanmaz veya sürdürmez.

GitHub Copilot ile oluşturun

  1. Şablonu oluşturmak istediğiniz dizinde bir terminal açın.

    Note

    Dizin mevcut bir uygulamayı, altyapı projesini veya yeni bir çözüm için ilk dosyaları içerebilir. Dizinde kaydedilmemiş değişiklikler varsa devam azd etmeden önce onaylamanızı ister. Önce önemli değişiklikleri işleyin veya saklayın.

  2. komutunu çalıştırın azd init:

    azd init
    
  3. GitHub Copilot ile ayarlayın (Önizleme) seçin.

    Başlatma istemi aşağıdaki örneğe benzer:

    ? How do you want to initialize your app?
       Scan current directory
       Select a template
    > Set up with GitHub Copilot (Preview)
    
  4. İstenen araç erişimini gözden geçirin ve iş akışı için gereken araçlara erişim verin. Copilot, projeyi incelemek, dosyalar oluşturmak ve sonucu doğrulamak için azd ve Azure geliştirme özelliklerini kullanır.

  5. azd sizden bunları yapılandırmanızı isterse bir model ve mantık düzeyi seçin.

    İlk çalıştırmada istemler aşağıdaki etiketleri kullanır. Kullanılabilir model ve mantık seçimleri, GitHub Copilot hesabınıza ve seçili modele bağlıdır:

    ? Select AI model
    ? Select reasoning effort level
    
  6. Ne oluşturmak istediğinizi açıklayın. Aşağıdakiler gibi ilgili gereksinimleri ekleyin:

    • Şablonda uygulama kodu, yalnızca altyapı veya her ikisi de bulunup bulunmadığı.
    • Biliniyorsa uygulama dilleri ve çerçeveleri.
    • Kullanılacak Azure hizmetleri ve barındırma platformu.
    • Bicep mi yoksa Terraform mu kullanılmalı.
    • Güvenlik, ağ, ölçeklendirme ve bölge gereksinimleri.

    Örneğin:

    Build an infrastructure-only azd template that provisions an Azure Container Apps
    environment, Azure Container Registry, and Log Analytics workspace with Bicep.
    Use managed identity and least-privilege role assignments. Parameterize the location
    and environment name so the template can be reused.
    
  7. Copilot'tan gelen tüm mimari veya yapılandırma sorularını yanıtlayın. Aracı projeyi Azure için hazırlar, şablon varlıklarını oluşturur ve dağıtım öncesi doğrulamayı çalıştırır.

  8. Copilot oluşturulan veya değiştirilen dosyaların genel yapısını gözden geçirin. Şablonun çözümünüz için beklenen proje yapılandırmasını, altyapı dizinini, uygulama kaynağını ve destekleyici varlıkları içerdiğini onaylayın.

    Örneğin, oluşturulan yalnızca altyapı şablonu aşağıdaki anahtar dosyalarını içerebilir:

    azure.yaml
    infra/
    ├── main.bicep
    ├── main.parameters.json
    └── modules/
       ├── container-apps-environment.bicep
       └── container-registry.bicep
    

    Yapılandırma ve altyapı içeriklerini gözden geçirme hakkında ayrıntılı yönergeler için bkz. Şablon dosyalarını keşfetme ve düzenleme.

Şablonu sağlama ve dağıtma

Oluşturulan dosyaları onayladıktan sonra aşağıdaki komutu çalıştırın:

azd up

Komutu bir azd ortam oluşturur veya seçer, Azure kaynaklarını sağlar, tüm uygulama hizmetlerini paketler ve dağıtır. Ayrıntılı bir komut dökümü için bkz. İş akışını keşfetmeazd up.

Başka bir yazma yöntemi kullanma

Diğer yapay zeka kodlama yardımcıları doğrudan iş akışına azd init bağlı değildir, ancak aynı standart şablon varlıklarını oluşturabilir. Ayrıca her varlığı doğrudan yazabilirsiniz.

Bu varlıkları kendiniz oluşturun veya başka bir kodlama yardımcınızdan gereksinimlerinizi analiz etmesini ve oluşturmasını isteyin:

  • azure.yaml Projeyi ve dağıtılabilir hizmetleri tanımlayan bir dosya.
  • gerekli Azure kaynaklarını sağlayan Bicep veya Terraform dosyaları.
  • Kaynak çıkışları ve uygulama ortamı değişkenleri.
  • Docker dosyaları, dağıtım yapılandırması ve gerektiğinde yardımcı betikler.

Başka bir aracı kullanmadan önce en düşük başlangıç noktasını sağlamak için şunu çalıştırın:

azd init --minimal

Başka bir kodlama yardımcısı kullanıyorsanız şemayı, Azure altyapı güvenlik uygulamalarını ve Azure Geliştirici CLI şablonlarında açıklanan şablon kurallarını izlemesini azure.yamlsağlayın. Dosyaları doğrudan yazarsanız, uygulama kılavuzunuzla aynı başvuruları kullanın. çalıştırmadan azd upönce tüm dosyaları gözden geçirin ve doğrulayın.

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.