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 mulai cepat ini, Anda membuat layanan API web backend yang mengembalikan koleksi statis album musik.
Cuplikan layar berikut menunjukkan output dari layanan API album yang Anda sebarkan.
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. |
Siapkan
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 Microsoft.App namespace layanan 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"
Mendapatkan 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 buat dalam mulai 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.
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 Sebarkan frontend , Anda dapat menghapus sumber daya Azure yang dibuat selama mulai cepat 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 mulai cepat ini, grup juga akan dihapus.
az group delete --name $RESOURCE_GROUP
Tip
Mengalami masalah? Beri tahu kami di GitHub dengan membuka masalah di repositori Azure Container Apps.
Langkah berikutnya
Setelah menyelesaikan mulai 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.