Aracılığıyla paylaş

Azure Geliştirici CLI başlatma iş akışlarını keşfetme

Azure Geliştirici CLI'sı (azd), Azure'da uygulama geliştirmeyi, sağlamayı ve dağıtmayı kolaylaştırmak için bir dizi komut sağlar. azd init komutu, ile azdçalışmak için gereken dosyaları ve yapılandırmaları oluşturarak yeni veya mevcut projeleri ayarlamanıza yardımcı olur. Bu makalede, kullanılabilir farklı başlatma iş akışları ve geliştirme senaryonuz için en iyi seçeneğin nasıl seçilebilir olduğu açıklanır.

Başlatma iş akışları

komutu, azd init uygulamanızı ile azdçalışmaya hazırlamak için çeşitli iş akışlarını destekler:

  • Geçerli dizini tara: Uygun azd yapılandırma dosyalarını ve kaynaklarını oluşturmak için mevcut bir uygulama kod tabanını analiz eder.
  • Bir şablon seçin: azd bir şablonu kopyalar ve başlatır.
  • En az proje oluşturma: Sıfırdan kendi azure.yaml şablonunuzu oluşturmak için başlangıç noktası olarak temel azd bir dosya başlatır.

Projenize en uygun yaklaşımı seçin. Bu akışların tümü Şablon oluşturma genel bakış ve ilgili makalelerde daha ayrıntılı olarak özetlenmiştir. Aşağıdaki bölümlerde her akışa kavramsal bir genel bakış sağlanır.

Geçerli dizini tara

Mevcut bir uygulama kod tabanınız varsa ve bunu azd kullanarak Azure'a dağıtım için hazırlamak istiyorsanız, bu iş akışını kullanın.

  1. Projenizin kök dizinine gidin.

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

    azd init

  3. Geçerli dizini tara'ya tıklayın. azd vasiyet:

    • Uygulamanızın kullandığı dili veya çerçeveyi belirlemek için dizininizi tarayın.
    • Azure Container Apps gibi uygun bir barındırma platformu seçin.
    • Gerekirse bulunan hizmetleri eklemenizi veya kaldırmanızı ister.
    ? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

  4. Onayla'yı seçin ve iş akışını tamamlamak için uygulamamı başlatmaya devam edin. azd uygulama dizininizde aşağıdakileri oluşturur:

    • azure.yaml Uygulama hizmetlerinizi tanımlayan ve bunları barındırma kaynaklarıyla eşleyen bir dosya.
    • .azure Ortam adınız gibi yapılandırma ayarlarının barındırılması için bir klasör.
    • .gitignore Uygulama diliniz ve barındırma platformunuz için yapılandırılmış bir dosya.

  5. İsteğe bağlı olarak komutunu çalıştırarak azd up Azure Container Apps kaynaklarını oluşturun ve uygulamanızı dağıtın.

Uygulamanız artık şablon azd olarak yapılandırılmıştır. Daha fazla Azure kaynağı ve hizmetiyle geliştirmeye ve genişletmeye devam edebilirsiniz.

Şablon seçme

Bu iş akışı, genellikle hem uygulama kodunu hem de gerekli Azure altyapı tanımlarını içeren önceden oluşturulmuş azd bir şablonla başlamanızı sağlar.

  1. azd init Komutunu çalıştırın:

    azd init

    Uyarı

    Ayrıca, bir şablonu ada göre doğrudan başlatması için azd init komutunu --template parametresiyle çalıştırabilir ve iş akışı seçimini atlayabilirsiniz.

  2. Şablon seçin'i seçin. azd , yapılandırılan şablon kaynaklarınızdaki kullanılabilir şablonların listesini görüntüler.

    ? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

  3. Sonuçları filtrelemek ve şablonu aramak için Hello AZD yazın. Şablonu kopyalamak ve başlatmak için Enter tuşuna basın.

  4. İsteğe bağlı olarak, şablon kaynaklarını sağlamak ve Azure'a dağıtmak için komutunu çalıştırın azd up .

Ayrıca, başlatılan şablonu daha fazla geliştirme için başlangıç noktası olarak da kullanabilirsiniz.

En düşük proje oluşturma

En az kurulumla başlamak ve her şeyi el ile özelleştirmek isteyen ileri düzey kullanıcılar için bu seçenek yalnızca temel yapılandırmayı sağlar.

  1. azd init komutunu şu bayrakla --minimal çalıştırın:

    azd init --minimal

  2. İstendiğinde, şablonunuz azd için bir ad girin ve Enter tuşuna basın.

    ? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.
Run azd add to add new Azure components to your project.

    --minimal bayrağı yalnızca aşağıdakileri oluşturur:

    • Yalnızca proje adı ve schemaVersion içeren temel azure.yaml bir dosya
    • .azure Ortam yapılandırması için bir dizin
    • .gitignore Azure Geliştirici CLI'sı için uygun girişlere sahip bir dosya

    Bu kolaylaştırılmış başlatma aşağıdaki durumlarda idealdir:

    • Altyapınızı sıfırdan oluşturmak istiyorsunuz
    • Mevcut bir karmaşık projeyle tümleştirme azd gerekiyor
    • Mimarinizi artımlı olarak oluşturmak için komutunu kullanmayı azd add planlayın
    • Proje yapınız üzerinde tam denetimi tercih etme

  3. Başlatma işleminden sonra şunları yapabilirsiniz:

    • Altyapı dosyalarınızı bir infra klasörde el ile oluşturma
    • azd add Uygulamanıza Azure kaynakları eklemeye başlamak için oluşturma özelliğini kullanın
    • Hizmetlerinizi ve kaynaklarınızı tanımlamak için dosyanızı azure.yaml özelleştirme

Proje ve Azure kaynak adlandırma

Yeni veya var olan bir projeyi başlatırken, proje adı içinde azure.yamlayarlanır. Proje adı, sağlama işlemi sırasında oluşturulan Azure kaynak adları için bir ön ek işlevi görür. Doğrulama kurallarına uyarak, oluşturulan Azure kaynak adlarının da geçerli olmasını sağlarsınız.

Bicep veya Terraform şablonlarında, proje adı genellikle ortam adı ve diğer öğelerle birlikte kaynak adları oluşturmak için temel olarak kullanılır. Örneğin:

var resourceToken = '${name}-${environmentName}'

Burada name proje adına başvurur ve environmentName ortamınızın azd adıdır.

Proje adı doğrulama kuralları

Bir projeyi başlatmak için kullanırken azd init veya dosyada azure.yaml yeni bir proje adı oluştururken aşağıdaki doğrulama kuralları uygulanır:

Kural Description
İzin verilen karakterler Proje adları yalnızca küçük harf, sayı ve kısa çizgi içerebilir.
Başlangıç karakteri Proje adları bir harfle başlamalıdır.
Bitiş karakteri Proje adları kısa çizgiyle bitmemelidir.
Uzunluk Proje adları 2 ila 63 karakter uzunluğunda olmalıdır.
Ardışık kısa çizgi yok Proje adları ardışık kısa çizgi içeremez.

Bu doğrulama kuralları, proje adınızın Azure kaynaklarının adlandırma gereksinimleriyle uyumlu olmasını sağlar ve dağıtım sırasında hizmet paketleme hatalarını önler.

Sonraki Adımlar

projenizi ile azd initbaşlatdıktan sonra şunları yapabilirsiniz:

  • Azure kaynaklarınızı özelleştirmek için oluşturulan altyapı dosyalarını değiştirin.
  • Azure'da gerekli kaynakları oluşturmak için kullanın azd provision .
  • Uygulama kodunuzu sağlanan kaynaklara dağıtmak için kullanın azd deploy .
  • Sağlama ve dağıtımı tek bir komutta birleştirmek için Azure Geliştirici CLI başlatma iş akışı hakkında bilgi edinin.

İlgili içerik

  • Last updated on