Bagikan melalui

Mulai cepat: Menyebarkan file artefak ke Azure Container Apps (pratinjau)

  • Artikel

Dalam mulai cepat ini, Anda belajar menyebarkan aplikasi kontainer dari file artefak bawaan. Contoh dalam artikel ini menyebarkan aplikasi Java menggunakan file JAR, yang menyertakan file manifes khusus Java. Tugas Anda adalah membuat layanan API web backend yang mengembalikan koleksi statis album musik. Setelah menyelesaikan mulai cepat ini, Anda dapat melanjutkan Komunikasi antara layanan mikro untuk mempelajari cara menyebarkan aplikasi ujung depan yang memanggil API.

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

Cuplikan layar respons dari titik akhir API album.

Prasyarat

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.
Akun GitHub Dapatkan satu secara gratis.
git Instal git
Azure CLI Instal Azure CLI.
Java Instal JDK, rekomendasikan 17, atau yang lebih baru
Maven Pasang Maven.

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.

Jika Anda menerima kesalahan tentang parameter yang hilang saat menjalankan az containerapp perintah di Azure CLI atau cmdlet dari Az.App modul di Azure PowerShell, pastikan Anda memiliki versi terbaru ekstensi Azure Container Apps yang terinstal.

az extension add --name containerapp --upgrade

Catatan

Mulai Mei 2024, ekstensi Azure CLI tidak lagi mengaktifkan fitur pratinjau secara default. Untuk mengakses fitur pratinjau Container Apps, instal ekstensi Container Apps dengan --allow-preview true.

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

Sekarang setelah ekstensi atau modul 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 Azure CLI selesai, Anda dapat menentukan variabel lingkungan yang digunakan di seluruh artikel ini.

Tentukan variabel berikut dalam shell bash Anda.

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>

Jika perlu, Anda bisa mengkueri ID langganan Anda.

az account list --output table

Menyiapkan repositori GitHub

Mulailah dengan mengkloning repositori sampel.

Gunakan perintah git berikut untuk mengkloning aplikasi sampel ke folder code-to-cloud :

git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud

cd code-to-cloud

Membuat file JAR

Catatan

Sampel Java hanya mendukung build Maven, yang menghasilkan file JAR yang dapat dieksekusi. Build menggunakan pengaturan default karena meneruskan variabel lingkungan tidak didukung.

Bangun proyek dengan Maven.

mvn clean package -DskipTests

Jalankan proyek secara lokal

java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar

Untuk memverifikasi aplikasi berjalan, buka browser dan buka http://localhost:8080/albums. Halaman mengembalikan daftar objek JSON.

Menyebarkan artefak

Buat dan sebarkan aplikasi kontainer pertama Anda dari file JAR lokal Anda dengan containerapp up perintah .

Perintah ini:

  • Membuat grup sumber daya
  • Membuat Azure Container Registry
  • Membangun gambar kontainer dan mendorongnya ke registri
  • Membuat lingkungan Aplikasi Kontainer dengan ruang kerja Analitik Log
  • Membuat dan menyebarkan aplikasi kontainer menggunakan gambar kontainer publik

Perintah up menggunakan file Docker di akar repositori untuk membangun gambar kontainer. EXPOSE Instruksi dalam file Docker menentukan port target. Namun, file Docker tidak diperlukan untuk membuat aplikasi kontainer.

Catatan

Catatan: Saat menggunakan containerapp up dalam kombinasi dengan basis kode docker-less, gunakan --location parameter sehingga aplikasi berjalan di lokasi selain AS Timur.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
  --ingress external \
  --target-port 8080 \
  --subscription $SUBSCRIPTION

Verifikasi penyebaran

Salin FQDN ke browser web. Dari browser web Anda, buka /albums titik akhir FQDN.

Cuplikan layar respons dari titik akhir API album.

Menyebarkan file WAR

Anda juga dapat menyebarkan aplikasi kontainer dari file WAR.

Membersihkan sumber daya

Jika Anda tidak akan terus menggunakan aplikasi ini, Anda dapat menghapus instans Aplikasi Kontainer Azure dan semua layanan terkait dengan menghapus grup sumber daya.

Ikuti langkah-langkah ini untuk menghapus sumber daya yang Anda buat:

az group delete \
  --resource-group $RESOURCE_GROUP

Tip

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

Langkah berikutnya

Pelajari selengkapnya tentang mengembangkan di Java di Container Apps