Mulai cepat: Membangun dan menyebarkan dari kode sumber lokal ke Azure Container Apps

Artikel ini menunjukkan cara membangun dan menyebarkan layanan mikro ke Azure Container Apps dari kode sumber lokal dalam bahasa pemrograman pilihan Anda. Dalam panduan cepat ini, Anda membuat layanan API web back-end yang mengembalikan koleksi statis album musik.

Cuplikan layar berikut menunjukkan output dari layanan API album yang Anda sebarkan.

Cuplikan layar respons dari titik akhir API album.

Prasyarat

Untuk menyelesaikan proyek ini, Anda memerlukan item berikut:

Persyaratan Petunjuk
Akun Azure Jika Anda tidak memilikinya, buat akun secara gratis. Anda memerlukan izin Kontributor atau Pemilik pada langganan Azure untuk melanjutkan.

Lihat Menetapkan peran Azure menggunakan portal Microsoft Azure untuk detailnya.
Git Pasang Git.
Azure CLI Instal Azure CLI.

Pengaturan

Untuk masuk ke Azure dari CLI, jalankan perintah berikut dan ikuti perintah untuk menyelesaikan proses autentikasi.

az login

Untuk memastikan bahwa Anda menjalankan CLI versi terbaru, jalankan perintah peningkatan:

az upgrade

Selanjutnya, instal atau perbarui ekstensi Container Apps untuk CLI:

az extension add --name containerapp --upgrade --allow-preview true

Sekarang setelah ekstensi saat ini diinstal, daftarkan namespace Microsoft.App dan Microsoft.OperationalInsights:

az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

Membuat variabel lingkungan

Setelah penyiapan CLI selesai, Anda dapat menentukan variabel lingkungan yang digunakan di seluruh artikel ini.

Tentukan variabel berikut di shell Bash Anda:

export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"

Dapatkan kode sampel

Jalankan perintah berikut untuk mengkloning aplikasi sampel dalam bahasa pilihan Anda dan beralih ke folder sumber proyek:

git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src

Membangun dan menyebarkan aplikasi kontainer

Pertama, jalankan perintah berikut untuk membuat grup sumber daya yang akan berisi sumber daya yang Anda ciptakan dalam panduan memulai cepat ini.

az group create --name $RESOURCE_GROUP --location $LOCATION

Buat dan sebarkan aplikasi kontainer pertama Anda dengan menggunakan containerapp up perintah . Perintah ini:

  • Membuat grup sumber daya.
  • Membuat sumber daya registri kontainer.
  • Membangun citra kontainer dan mengunggahnya ke registri.
  • Membuat lingkungan Container Apps dengan ruang kerja Analitik Log.
  • Membuat dan menyebarkan aplikasi kontainer dengan menggunakan gambar kontainer bawaan.

Perintah up menggunakan Dockerfile di folder proyek untuk membangun gambar kontainer. EXPOSE Instruksi dalam Dockerfile mendefinisikan port target, yang merupakan port yang digunakan untuk mengirim lalu lintas masuk ke kontainer.

Dalam contoh kode berikut, . (titik) memberi tahu containerapp up untuk berjalan di direktori proyek saat ini yang juga berisi Dockerfile.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --source .

Catatan

Jika perintah mengembalikan kesalahan dengan pesan "AADSTS50158: Tantangan keamanan eksternal tidak terpenuhi," jalankan az login --scope https://graph.microsoft.com//.default untuk masuk dengan izin yang diperlukan, lalu jalankan az containerapp up perintah lagi.

Verifikasi penyebaran

Temukan URL aplikasi kontainer dalam output az containerapp up perintah. Navigasikan ke URL di browser Anda. Tambahkan /albums ke akhir URL untuk melihat respons dari API.

Cuplikan layar respons dari titik akhir API album.

Batas

Ukuran maksimum untuk mengunggah kode sumber adalah 200 MB. Jika unggahan terlalu besar, kesalahan 413 dikembalikan.

Membersihkan sumber daya

Jika Anda tidak akan melanjutkan ke tutorial Menyebarkan antarmuka depan, Anda dapat menghapus sumber daya Azure yang dibuat selama panduan cepat ini dengan menggunakan perintah berikut.

Perhatian

Perintah berikut menghapus grup sumber daya yang ditentukan dan semua sumber daya yang terkandung di dalamnya. Jika grup berisi sumber daya di luar cakupan mulai cepat ini, sumber daya tersebut juga akan dihapus.

az group delete --name $RESOURCE_GROUP

Kiat

Mengalami masalah? Beri tahu kami di GitHub dengan membuka masalah di repositori Azure Container Apps.

Langkah selanjutnya

Setelah menyelesaikan panduan cepat ini, Anda dapat melanjutkan ke Tutorial: Komunikasi antara mikroservis di Azure Container Apps untuk belajar cara menyebarkan aplikasi front-end yang memanggil API.

Tutorial: Komunikasi antara layanan mikro

  • Last updated on