Azure Geliştirici CLI oluşturma özelliğini kullanarak minimum şablon oluşturma

Azure Geliştirici CLI'sı (azdoluşturma) özelliği, Bicep kodunu el ile yazmadan uygulamanız için gereken Azure kaynaklarını aşamalı olarak oluşturmanıza olanak tanır. Bu makalede, basit bir şablon oluşturmak için kompozisyon özelliğiyle nasıl çalışacağınızı öğreneceksiniz. Bu özellik hakkında daha fazla kavramsal bilgi için oluşturma genel bakış makalesini ziyaret edin.azd

Uyarı

Oluşturma azd özelliği şu anda alfa aşamasındadır ve üretim uygulamalarında kullanılmamalıdır. Sonraki sürümlerde alfa özelliklerinde yapılan değişiklikler yıkıcı değişikliklere neden olabilir. Daha fazla bilgi için azd özellik sürüm oluşturma ve sürüm stratejisi ile özellik aşamaları sayfalarını ziyaret edin. Özellik ve bu makale hakkında geri bildirim paylaşmak için sağ üst taraftaki compose düğmesini kullanın.

Oluşturma özelliğiyle çalışma

azd komutu aracılığıyla azd add oluşturma özelliklerine erişin. komutu aşağıdaki azd addazd init iş akışları kullanılarak oluşturulan şablonlarla çalışır:

  • Geçerli dizindeki kodu kullanın (barındırma için Azure Container Apps'i hedefleyen uygulamalar için)
  • En düşük proje oluşturma

Şablon seçin akışı aracılığıyla başlatılan şablonlar şu anda desteklenmiyor. Oluşturma azd özelliği altyapıyı sizin için yönetir ve mevcut infra klasör varlıklarına sahip şablonlarla uyumlu değildir. Daha fazla bilgi için Bicep kodu oluşturma makalesi ve şablon oluşturma iş akışları sayfasını ziyaret edin.

Hiçbir kod yazmadan şablonunuza yeni kaynaklar eklemek için aşağıdaki adımları tamamlayın:

  1. Terminal penceresinde şablonunuzun azd köküne gidin.

  2. azd add Komutunu çalıştırarak yeni bir kaynak ekleyin ve oluşturma iş akışını başlatın:

    azd add

  3. Uygulamanıza eklemek için desteklenen kaynaklardan birini seçin. Bu örnek için Database öğesini seçin.

    ? What would you like to add? [Use arrows to move, type to filter]
> AI
  Database
  Host service
  Key Vault
  Messaging
  Storage account
  ~Existing resource

  4. Veritabanı türünü seçmek için PostgreSQL.

    ? Which type of database?  [Use arrows to move, type to filter]
  MongoDB
> PostgreSQL
  Redis

  5. Yeni kaynak için gibi azddbbir ad girin.

    ? Input the name of the app database (PostgreSQL)

  6. Uygulamanız hizmetler içeriyorsa, azd sizden bu kaynağı kullanan hizmeti seçmenizi ister.

    ? Select the service(s) that uses this resource
> [✓]  webfrontend

  7. azd dosyada gerekli değişikliklerin önizlemesini azure.yaml oluşturur. Değişiklikleri kabul etmek ve uygulamak için Enter tuşuna basın.

    Previewing changes to azure.yaml:

+  azddata:
+      type: db.postgres

   webfrontend:
       type: host.containerapp
       uses:
           - azddb
+          - azddata
       port: 80

  8. Yapılan değişiklikleri gerçekleştirmek için azd up komutunu çalıştırın ve bu değişiklikler azd add komutuyla yapılmıştır. Bu örnekte, azd Azure'da bir PostgreSQL veritabanı sağlar.

  9. azd add OpenAI hizmeti gibi diğer kaynakları eklemek için komutunu yeniden çalıştırın.

azure.yaml dosyasını keşfetme

azure.yaml , uygulamanızı yönetmek için kullanılan yapılandırma dosyasıdır azd . azd, azd add komutu kullanılarak oluşturulan hizmetleri ve kaynakları, karşılık gelen services ve resources düğümlerini kullanarak yönetir. Tamamen azure.yaml aracılığıyla güncellenen bir azd add dosyanın aşağıdaki örneğini göz önünde bulundurun.

name: azdcomposesample
metadata:
  template: azd-init@1.11.0
services:
  webfrontend:
    project: src
    host: containerapp
    language: dotnet
resources:
  webfrontend:
    type: host.containerapp
    port: 80
    uses:
      - azdsql
      - azdchat
  azdsql:
    type: db.postgres
  azdchat:
    type: ai.openai.model
    model:
      name: gpt-4o
      version: "2024-08-06"
  • Düğüm services aşağıdakileri bildirir:
    • webfrontend dizininde bir .NET web uygulaması ile Azure Container Apps arasında src adlı bir dağıtım eşlemesi.
  • Düğüm resources aşağıdakileri bildirir:
    • Bir Azure kapsayıcı uygulaması ve barındırılan .NET kapsayıcı uygulaması ile bağlı olduğu veritabanı ve yapay zeka hizmeti arasında adlı webfrontend eşleşen bağımlılık eşlemesi. Düğüm, uses uygulamayı bağımlı olduğu diğer kaynaklarla eşleştirir.
    • Adlı azdsqlPostgreSQL için Azure Veritabanı kaynağı.
    • adlı azdchatbir Azure OpenAI kaynağı.

Sonraki Adımlar

Derleme özelliğini kullanarak Bicep kodu oluştur

  • Last updated on