Bagikan melalui

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 menggunakan bahasa pemrograman pilihan Anda. Dalam panduan cepat ini, Anda membuat layanan API web backend yang mengembalikan koleksi album musik statis.

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 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 Anda menjalankan CLI versi terbaru, jalankan perintah peningkatan.

az upgrade

Selanjutnya, instal atau perbarui ekstensi Azure 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 dalam 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 ubah 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 containerapp up perintah . Perintah ini akan:

  • Membuat grup sumber daya
  • Membuat Azure Container Registry
  • Buat gambar kontainer dan dorong ke registri
  • Membuat lingkungan Aplikasi Kontainer dengan ruang kerja Analitik Log
  • Membuat dan menyebarkan aplikasi kontainer 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 200MB. Jika unggahan melebihi batas, kesalahan 413 dikembalikan.

Membersihkan sumber daya

Jika Anda tidak akan melanjutkan ke tutorial Menerapkan antarmuka depan, Anda dapat menghapus sumber daya Azure yang dibuat selama panduan kilat ini dengan 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 lingkup panduan memulai 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 berikutnya

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

Tutorial: Komunikasi antara layanan mikro

  • Last updated on