Menjelajahi alur kerja inisialisasi Azure Developer CLI

Azure Developer CLI (azd) menyediakan serangkaian perintah untuk menyederhanakan pengembangan, provisi, dan penyebaran aplikasi di Azure. Perintah ini azd init membantu Anda menyiapkan proyek baru atau yang sudah ada dengan menghasilkan file dan konfigurasi yang diperlukan untuk bekerja dengan azd. Artikel ini menjelaskan berbagai alur kerja inisialisasi yang tersedia dan cara memilih opsi terbaik untuk skenario pengembangan Anda.

Alur kerja inisialisasi

Perintah ini azd init mendukung beberapa alur kerja untuk menyiapkan aplikasi Anda untuk bekerja dengan azd:

  • Pindai direktori saat ini: Menganalisis basis kode aplikasi yang ada untuk menghasilkan file konfigurasi dan sumber daya yang sesuai azd .
  • Pilih templat: Mengkloning dan menginisialisasi templat dari azdgaleri templat.
  • Membuat proyek minimal: Menginisialisasi file dasar azure.yaml sebagai titik awal untuk membangun templat Anda sendiri azd dari awal.

Pilih pendekatan yang paling sesuai dengan proyek Anda. Semua alur ini diuraikan secara lebih rinci dalam Gambaran Umum Membuat Templat dan artikel terkait. Bagian berikut memberikan gambaran umum konseptual dari setiap alur.

Memindai direktori yang sedang aktif

Gunakan alur kerja ini saat Anda memiliki basis kode aplikasi yang sudah ada dan ingin menyiapkannya untuk penyebaran ke Azure menggunakan azd.

  1. Navigasikan ke direktori akar proyek Anda.

  2. Jalankan azd init perintah:

    azd init

  3. Pilih Pindai direktori saat ini. azd akan:

    • Pindai direktori Anda untuk menentukan bahasa atau kerangka kerja yang digunakan aplikasi Anda.
    • Pilih platform hosting yang sesuai, seperti Azure Container Apps.
    • Minta Anda untuk menambahkan atau menghapus layanan yang ditemukan jika diperlukan.
    ? 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. Pilih Konfirmasi dan lanjutkan menginisialisasi aplikasi saya untuk menyelesaikan alur kerja. azd membuat hal berikut di direktori aplikasi Anda:

    • File azure.yaml yang menentukan layanan aplikasi Anda dan memetakannya ke sumber daya hosting.
    • Folder .azure untuk menyimpan pengaturan konfigurasi seperti nama lingkungan Anda.
    • File yang telah dikonfigurasi untuk bahasa aplikasi dan platform penghosting Anda.

  5. Secara opsional, jalankan azd up untuk membuat sumber daya Azure Container Apps dan menyebarkan aplikasi Anda.

Aplikasi Anda sekarang disusun sebagai templat, azd Anda dapat terus mengembangkan dan memperluas dengan lebih banyak sumber daya dan layanan Azure.

Pilih templat

Alur kerja ini memungkinkan Anda memulai dengan azd templat bawaan yang biasanya menyertakan kode aplikasi dan definisi infrastruktur Azure yang diperlukan.

  1. Jalankan azd init perintah:

    azd init

    Nota

    Anda juga dapat menjalankan azd init dengan --template parameter untuk langsung menginisialisasi templat berdasarkan nama dan melewati pilihan alur kerja.

  2. Pilih Pilih templat. azd menampilkan daftar templat yang tersedia dari sumber templat yang dikonfigurasi.

    ? 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. Ketik untuk memfilter hasilnya dan cari templat Hello AZD. Tekan Enter untuk mengkloning dan menginisialisasi templat.

  4. Secara opsional, jalankan azd up untuk menyediakan dan menyebarkan sumber daya templat ke Azure.

Anda juga dapat menggunakan templat yang diinisialisasi sebagai titik awal untuk pengembangan lebih lanjut.

Membuat proyek minimal

Untuk pengguna tingkat lanjut yang ingin memulai dengan penyiapan minimal dan menyesuaikan semuanya secara manual, opsi ini hanya menyediakan konfigurasi penting.

  1. Jalankan perintah azd init dengan flag --minimal

    azd init --minimal

  2. Saat diminta, masukkan nama untuk templat Anda azd dan tekan Enter.

    ? 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.

    Bendera --minimal hanya membuat yang berikut ini:

    • File dasar azure.yaml dengan hanya nama proyek dan versi skema
    • .azure Direktori untuk konfigurasi lingkungan
    • File .gitignore dengan entri yang sesuai untuk Azure Developer CLI

    Inisialisasi yang disederhanakan ini sangat ideal ketika Anda:

    • Ingin membangun infrastruktur Anda dari awal
    • Perlu diintegrasikan azd dengan proyek kompleks yang ada
    • Rencanakan untuk menggunakan perintah azd add guna membangun arsitektur Anda secara bertahap
    • Lebih memilih kontrol penuh atas struktur proyek Anda

  3. Setelah inisialisasi, Anda dapat:

    • Membuat file infrastruktur Anda secara manual di infra folder
    • azd add Gunakan fitur buat untuk mulai menambahkan sumber daya Azure ke aplikasi Anda
    • Sesuaikan azure.yaml file Anda untuk menentukan layanan dan sumber daya Anda

Penamaan sumber daya Project dan Azure

Saat Anda menginisialisasi proyek baru atau yang sudah ada, nama proyek diatur dalam azure.yaml. Nama proyek bertindak sebagai awalan untuk nama sumber daya Azure yang dibuat selama proses provisi. Dengan mematuhi aturan validasi, Anda memastikan bahwa nama sumber daya Azure yang dihasilkan juga akan valid.

Dalam templat Bicep atau Terraform, nama proyek sering digunakan sebagai basis untuk membuat nama sumber daya, dikombinasikan dengan nama lingkungan dan elemen lainnya. Contohnya:

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

Jika name mengacu pada nama proyek dan environmentName merupakan nama lingkungan Anda azd .

Aturan validasi nama proyek

Saat menggunakan azd init untuk menginisialisasi proyek atau saat membuat nama proyek baru dalam azure.yaml file, aturan validasi berikut diterapkan:

Peraturan Description
Karakter yang diizinkan Nama proyek hanya dapat menyertakan huruf kecil, angka, dan tanda hubung.
Karakter awal Nama proyek harus dimulai dengan huruf.
Karakter akhir Nama proyek tidak boleh diakhir dengan tanda hubung.
Panjang Panjang nama proyek harus antara 2 dan 63 karakter.
Tidak ada tanda hubung berturut-turut Nama proyek tidak boleh berisi tanda hubung berturut-turut.

Aturan validasi ini memastikan bahwa nama proyek Anda akan kompatibel dengan persyaratan penamaan sumber daya Azure dan mencegah kegagalan pengemasan layanan selama penyebaran.

Langkah selanjutnya

Setelah menginisialisasi proyek Anda dengan azd init, Anda dapat:

  • Ubah file infrastruktur yang dihasilkan untuk menyesuaikan sumber daya Azure Anda.
  • Gunakan azd provision untuk membuat sumber daya yang diperlukan di Azure.
  • Gunakan azd deploy untuk menyebarkan kode aplikasi Anda ke sumber daya yang disediakan.
  • Pelajari tentang Azure Developer CLI 'up' workflow untuk menggabungkan penyediaan dan penyebaran dalam satu perintah.

Konten terkait

  • Last updated on