Cara kerja Azure Developer CLI

Selesai

Azure Developer CLI (azd) dibangun di sekitar perintah ramah pengembang dan templat aplikasi dasar. azd menyediakan sekumpulan perintah yang membantu onboarding dan mengelola aplikasi Anda di Azure menggunakan templat proyek standar. Templat ini mencakup semua kode sumber dan aset konfigurasi yang diperlukan untuk menyediakan dan menyebarkan aplikasi Anda ke Azure. Anda dapat mulai menggunakan azd dengan bekerja dari salah satu templat sampel yang ada dan dapat diperluas atau dengan membangun templat Anda sendiri.

Menjelajahi azd perintah

Azure Developer CLI menyertakan serangkaian perintah yang dapat didekati yang memetakan ke tahap alur kerja pengembangan umum, seperti penyediaan dan penyebaran sumber daya. Beberapa azd perintah seperti azd up juga menangani beberapa tahap sekaligus untuk lebih menyederhanakan tugas-tugas ini.

Misalnya, alur kerja umum azd menggunakan templat yang sudah ada menyertakan langkah-langkah berikut:

  1. Jalankan azd init perintah dengan --template parameter untuk mengkloning templat yang ada dan atur nama lingkungan saat diminta.

    azd init --template todo-nodejs-mongo
    
  2. Jalankan azd auth login perintah untuk masuk ke langganan Azure Anda.

    azd auth login
    
  3. Jalankan azd up perintah untuk menyediakan dan menyebarkan sumber daya templat ke Azure.

    azd up
    
  4. Setelah lingkungan Anda disiapkan di Azure, Anda dapat memodifikasi fitur aplikasi atau templat sumber daya Azure secara lokal lalu menjalankan azd up lagi untuk memprovisikan perubahan Anda.

Perintah lain azd tersedia untuk menyelesaikan tugas lain dan memperluas alur kerja ini. azd dirancang untuk memiliki jumlah perintah minimal dengan beberapa parameter untuk kemudahan penggunaan. Beberapa perintah yang paling umum azd meliputi:

  • azd init - Inisialisasi aplikasi baru.
  • azd up - Provisikan sumber daya Azure dan sebarkan proyek Anda dengan satu perintah.
  • azd provision - Provisikan sumber daya Azure untuk aplikasi.
  • azd deploy - Sebarkan kode aplikasi ke Azure.
  • alur azd - (Beta) Mengelola dan mengonfigurasi alur penyebaran Anda.
  • azd auth - Autentikasi dengan Azure.
  • azd config - Mengelola konfigurasi azd (misalnya, langganan Azure default, lokasi).
  • azd down - Hapus sumber daya Azure untuk aplikasi.

Menjelajahi azd templat

Perintah Azure Developer CLI dirancang untuk bekerja dengan templat proyek standar. Setiap templat adalah repositori kode yang mematuhi konvensi file dan folder tertentu. Templat berisi aset azd perlu menyediakan sumber daya Azure dan secara opsional menyebarkan kode sumber aplikasi. Beberapa templat mungkin tidak menyertakan kode sumber aplikasi dengan asumsi bahwa Anda menambahkan sendiri. Saat Anda menjalankan perintah seperti azd up, alat ini menggunakan aset templat proyek untuk menjalankan berbagai langkah alur kerja, seperti provisi atau penyebaran sumber daya ke Azure.

Ada dua pendekatan utama untuk bekerja dengan azd templat:

  • Perluas templat yang ada azd - Pustaka azd templat besar sudah ada untuk mencakup tumpukan, skenario, dan arsitektur aplikasi lokal umum. Anda dapat menelusuri banyak templat di situs pustaka templat yang mengagumkan. Jika Anda menemukan templat yang memetakan ke tumpukan aplikasi lokal atau arsitektur yang diinginkan, Anda dapat menggunakannya sebagai titik awal. Kemudian, ganti direktori kode sumber dan ubah file konfigurasi atau infrastruktur untuk memenuhi kebutuhan Anda.

  • Konversikan aplikasi Anda sendiri menjadi azd templat - Anda juga dapat mengonversi aplikasi yang azd template ada menjadi dengan mengikuti panduan Buat proyek Anda kompatibel dengan azd . Membuat templat Anda sendiri sering lebih sering berfungsi pada awalnya, tetapi memungkinkan kontrol terbanyak dan menghasilkan solusi yang dapat digunakan kembali untuk pekerjaan pengembangan di masa mendatang pada aplikasi. Langkah-langkah inti untuk membuat templat Anda sendiri adalah sebagai berikut:

    • Inisialisasi templat proyek dengan azd init.

    • Buat infrastruktur sebagai file kode menggunakan Bicep atau Terraform.

    • azure.yaml Perbarui file untuk mengikat layanan aplikasi bersama dengan sumber daya Azure.

    • Provisi & sebarkan dengan azd up.

      A diagram showing the Azure Developer CLI template creation workflow.

Terlepas dari pendekatan mana yang Anda pilih, struktur templat yang dihasilkan sama. Semua azd templat mencakup aset berikut:

  • infra folder - Berisi semua infrastruktur Bicep atau Terraform sebagai file kode untuk azd templat. Infrastruktur sebagai kode memungkinkan Anda menentukan sumber daya dan konfigurasi infrastruktur dalam file definisi deklaratif yang dengan andal menghasilkan lingkungan yang sama setiap kali disebarkan. Terraform berfungsi di beberapa platform cloud, sementara Bicep khusus untuk Azure. azd menjalankan file-file ini untuk membuat sumber daya Azure yang diperlukan untuk menghosting aplikasi Anda. Anda dapat mempelajari selengkapnya tentang infrastruktur sebagai kode dalam modul Pelatihan apa itu infrastruktur sebagai kode? .

  • azure.yaml file - File konfigurasi yang menentukan satu atau beberapa layanan dalam proyek Anda dan memetakannya ke sumber daya Azure untuk penyebaran. Misalnya, Anda dapat menentukan layanan API dan layanan front-end web, masing-masing dengan atribut yang memetakannya ke sumber daya Azure yang berbeda untuk penyebaran.

  • .azure folder - Berisi konfigurasi Azure penting dan variabel lingkungan, seperti lokasi untuk menyebarkan sumber daya atau informasi langganan lainnya.

  • src folder - Berisi semua kode sumber aplikasi yang dapat disebarkan. Beberapa azd templat hanya menyediakan aset infrastruktur dan membiarkan src direktori kosong bagi Anda untuk menambahkan kode aplikasi Anda sendiri.

    A screenshot showing the Azure Developer CLI template structure.

Sebagian besar azd templat juga secara opsional menyertakan satu atau beberapa folder berikut:

  • .devcontainer folder - Memungkinkan Anda menyiapkan lingkungan Dev Container untuk aplikasi Anda. Pendekatan lingkungan pengembangan umum yang tidak spesifik untuk azd.
  • .github folder - Menyimpan file alur kerja CI/CD untuk GitHub Actions, penyedia CI/CD default untuk azd.
  • .azdo folder - Jika Anda memutuskan untuk menggunakan Azure Pipelines untuk CI/CD, tentukan file konfigurasi alur kerja di folder ini.