Menyebarkan Azure Container Apps dengan perintah az containerapp up

Perintah az containerapp up (atau up) merupakan cara tercepat untuk menyebarkan aplikasi di Azure Container Apps dari citra yang ada, kode sumber lokal, atau repositori GitHub. Saat menggunakan perintah tunggal ini, Anda dapat mengaktifkan dan menjalankan aplikasi kontainer dalam hitungan menit.

Perintah dapat membangun dan mendorong gambar kontainer ke Azure Container Registry saat Anda menyediakan kode sumber lokal atau repositori GitHub. Saat Anda bekerja dari repositori GitHub, perintah membuat alur kerja GitHub Actions yang secara otomatis membangun dan mendorong gambar kontainer baru saat Anda menerapkan perubahan pada repositori GitHub Anda.

Artikel ini memperlihatkan kepada Anda cara menggunakan perintah untuk menyebarkan aplikasi kontainer dari gambar yang ada, kode sumber lokal, dan repositori GitHub.

Prasyarat

Persyaratan	Petunjuk
Akun Azure	Jika Anda tidak memilikinya, buat akun secara gratis. Langganan Azure Anda harus memiliki peran Kontributor atau Pemilik . Untuk informasi mendetail, lihat Menetapkan peran Azure menggunakan portal Microsoft Azure.
Azure CLI	Instal Azure CLI.
Akun GitHub	Jika Anda ingin menggunakan gambar di repositori GitHub, daftar untuk akun GitHub gratis.
Kode sumber lokal	Jika Anda ingin membuat gambar dari kode sumber lokal, masukkan kode Anda ke direktori lokal.
Gambar yang sudah ada	Jika Anda ingin menggunakan gambar yang sudah ada, perhatikan server registri, nama gambar, dan tag Anda. Jika Anda menggunakan registri privat, perhatikan juga kredensial Anda.

Gunakan sumber daya yang ada

Perintah up dapat membuat sumber daya, atau dapat menggunakan sumber daya yang ada, termasuk:

• Grup sumber daya.
• Registri Kontainer
• Lingkungan Aplikasi Kontainer dan ruang kerja Analitik Log.
• Aplikasi kontainer Anda.

Jika Anda perlu menyesuaikan lingkungan Container Apps, pertama gunakan perintah az containerapp env create untuk membuat dan menyesuaikan lingkungan Anda. Saat Anda kemudian menjalankan up perintah, gunakan --environment opsi untuk menentukan lingkungan yang dikustomisasi.

Jika Anda tidak menentukan lingkungan yang ada, perintah up akan mencarinya di dalam grup sumber daya milik Anda. Jika perintah menemukan lingkungan, perintah akan menggunakan lingkungan tersebut. Jika perintah tidak menemukan lingkungan, perintah akan membuat lingkungan yang menyertakan ruang kerja Analitik Log.

Untuk informasi selengkapnya tentang az containerapp up perintah dan opsinya, lihat az containerapp up.

Menyiapkan lingkungan Azure CLI Anda

1. Gunakan Azure CLI untuk masuk ke Azure.

   az login
   

2. Instal ekstensi Container Apps untuk Azure CLI.

   az extension add --name containerapp --upgrade
   

3. Daftarkan Microsoft.App namespace layanan.

   az provider register --namespace Microsoft.App
   

4. Daftarkan penyedia Microsoft.OperationalInsights untuk ruang kerja Log Analytics.

   az provider register --namespace Microsoft.OperationalInsights
   

Menyebarkan dari gambar yang sudah ada

Anda dapat menyebarkan aplikasi kontainer yang menggunakan gambar yang ada di registri kontainer publik atau privat. Jika Anda menyebarkan dari registri privat, Anda perlu memberikan kredensial Anda dengan menggunakan --registry-serveropsi , --registry-username, dan --registry-password .

Anda dapat menggunakan contoh kode berikut untuk menyebarkan aplikasi kontainer dari gambar yang ada. Sebelum Anda menjalankan perintah, ganti placeholder, yang berada dalam tanda kurung sudut, dengan nilai Anda.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
  --ingress external \
  --target-port <PORT_NUMBER> 

Perintah ini melakukan tindakan berikut:

1. Membuat grup sumber daya.
2. Membuat lingkungan dan ruang kerja Analitik Log.
3. Membuat dan menyebarkan aplikasi kontainer yang menarik gambar dari registri publik.
4. Mengatur nilai aplikasi ingress kontainer ke external dengan port target yang diatur ke nilai yang ditentukan.

Anda juga dapat menggunakan up perintah untuk menyebarkan ulang aplikasi kontainer. Jika Anda ingin menyebarkan ulang dengan gambar baru, gunakan --image opsi untuk menentukan gambar baru. Pastikan bahwa --resource-group opsi dan --environment diatur ke nilai dari penyebaran asli.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --environment <ENVIRONMENT_NAME> \
  --ingress external \
  --target-port <PORT_NUMBER> 

Menyebarkan dari kode sumber lokal

Saat Anda menggunakan up perintah untuk menyebarkan dari sumber lokal, perintah tersebut membangun gambar kontainer, mendorongnya ke registri, dan menyebarkan aplikasi kontainer. Jika Anda tidak menentukan registri, perintah akan membuatnya di Container Registry.

Perintah dapat membangun gambar dengan atau tanpa Dockerfile. Dalam build yang tidak menggunakan Dockerfile, bahasa berikut didukung:

• .NET
• Node.js
• PHP
• Python

Anda dapat menggunakan contoh kode berikut untuk menyebarkan aplikasi kontainer dari kode sumber lokal:

    az containerapp up \
      --name <CONTAINER_APP_NAME> \
      --source <SOURCE_DIRECTORY>\
      --ingress external 

Perintah ini melakukan tindakan berikut:

1. Membuat grup sumber daya.
2. Membuat lingkungan dan ruang kerja Analitik Log.
3. Membuat registri di Container Registry.
4. Membangun gambar kontainer (dengan menggunakan Dockerfile jika ada).
5. Mendorong gambar ke registri.
6. Membuat dan menyebarkan aplikasi kontainer.

Saat Dockerfile menyertakan instruksi EXPOSE, perintah up mengonfigurasi ingress dan port tujuan aplikasi kontainer menggunakan informasi dalam Dockerfile. Jika Mengonfigurasi ingress melalui Dockerfile atau aplikasi tidak memerlukan ingress, Anda dapat menghilangkan opsi tersebut --ingress .

Output perintah mencakup URL untuk aplikasi kontainer.

Jika perintah melaporkan bahwa ia menunggu agen Cloud Build tetapi kemudian berhenti merespons, kesalahan sementara GitHub mungkin menjadi sumber masalah. Untuk mengatasi situasi, jalankan perintah lagi.

Jika ada kegagalan, Anda dapat menjalankan perintah lagi dengan --debug opsi untuk mendapatkan informasi selengkapnya. Jika build gagal tanpa Dockerfile, Anda dapat mencoba menambahkan Dockerfile dan menjalankan perintah lagi.

Untuk menggunakan perintah az containerapp up untuk menyebarkan ulang aplikasi kontainer Anda dengan gambar yang diperbarui, sertakan --resource-group dan --environment opsi. Untuk menyebarkan ulang aplikasi kontainer dari kode sumber lokal, lakukan langkah-langkah berikut:

1. Buat perubahan pada kode sumber.

2. Jalankan perintah berikut:

   az containerapp up \
     --name <CONTAINER_APP_NAME> \
     --source <SOURCE_DIRECTORY> \
     --resource-group <RESOURCE_GROUP_NAME> \
     --environment <ENVIRONMENT_NAME>
   

Menyebarkan dari repositori GitHub

Saat Anda menggunakan az containerapp up perintah untuk menyebarkan dari repositori GitHub, perintah tersebut menghasilkan alur kerja GitHub Actions yang membangun gambar kontainer, mendorongnya ke registri, dan menyebarkan aplikasi kontainer. Jika Anda tidak menentukan registri, perintah akan membuatnya di Container Registry.

Dockerfile diperlukan untuk membangun gambar. Saat Dockerfile menyertakan EXPOSE instruksi, perintah ini mengonfigurasi ingress dan port tujuan aplikasi container dengan menggunakan informasi di Dockerfile.

Anda dapat menggunakan contoh kode berikut untuk menyebarkan aplikasi kontainer dari repositori GitHub:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --repo <GITHUB_REPOSITORY_URL> \
  --ingress external 

Perintah ini melakukan tindakan berikut:

1. Membuat grup sumber daya.
2. Membuat lingkungan dan ruang kerja Analitik Log.
3. Membuat registri di Container Registry.
4. Membangun gambar kontainer dengan menggunakan Dockerfile.
5. Mendorong gambar ke registri.
6. Membuat dan menyebarkan aplikasi kontainer.
7. Membuat alur kerja GitHub Actions untuk membangun gambar kontainer dan menyebarkan aplikasi kontainer saat perubahan di masa mendatang didorong ke repositori GitHub.

Jika perintah gagal karena perwakilan layanan tidak dapat dibuat, Anda dapat membuat perwakilan layanan secara manual di Azure. Kemudian Anda dapat meneruskan informasi tentang hal itu ke perintah:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --repo <GITHUB_REPOSITORY_URL> \
  --service-principal-client-id "$SERVICE_PRINCIPAL_CLIENT_ID" \
  --service-principal-client-secret "$SERVICE_PRINCIPAL_CLIENT_SECRET" \
  --service-principal-tenant-id "$AZURE_TENANT_ID"
  --ingress external 

Jika Mengonfigurasi ingress melalui Dockerfile atau aplikasi tidak memerlukan ingress, Anda dapat menghilangkan opsi tersebut --ingress .

Perintah up membuat alur kerja GitHub Actions. Akibatnya, menjalankan ulang perintah memiliki efek yang tidak diinginkan untuk membuat beberapa alur kerja. Jika Anda ingin menyebarkan perubahan pada gambar aplikasi, dorong perubahan ke repositori GitHub Anda alih-alih menjalankan ulang perintah. Alur kerja GitHub secara otomatis mendeteksi perubahan di repositori Anda lalu membangun dan menyebarkan aplikasi Anda. Untuk mengubah alur kerja, edit file alur kerja di GitHub.

Mengonfigurasi pengaturan aplikasi kontainer

Perintah ini az containerapp up menyediakan cara yang disederhanakan untuk membuat dan menyebarkan aplikasi kontainer yang terutama menggunakan pengaturan default. Namun, setelah menggunakan up perintah, Anda perlu menjalankan perintah Azure CLI lainnya seperti yang berikut ini jika Anda ingin mengonfigurasi pengaturan tingkat lanjut lainnya:

• Runtime Aplikasi Terdistribusi (Dapr): az containerapp dapr enable
• Rahasia: az containerapp secret set
• Protokol transportasi: az containerapp ingress update

Jika Anda ingin menyesuaikan pengaturan lain untuk aplikasi kontainer Anda, seperti pengaturan sumber daya atau penskalaan, pertama-tama up gunakan perintah untuk menyebarkan aplikasi kontainer Anda. Kemudian gunakan az containerapp update perintah untuk mengubah pengaturan ini. Perintah az containerapp up bukan singkatan untuk az containerapp update perintah .

Langkah selanjutnya

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