Menyebarkan Azure Container Apps dengan perintah az containerapp up

Artikel
07/24/2024

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

Perintah az containerapp up ini adalah cara yang disederhanakan untuk membuat dan menyebarkan aplikasi kontainer yang terutama menggunakan pengaturan default. Namun, Anda perlu menjalankan perintah CLI lainnya untuk mengonfigurasi pengaturan yang lebih canggih:

Dapr: az containerapp dapr enable
Rahasia: az containerapp secret set
Protokol transportasi: az containerapp ingress update

Untuk menyesuaikan sumber daya atau pengaturan penskalakan aplikasi kontainer, Anda dapat menggunakan up perintah lalu az containerapp update perintah untuk mengubah pengaturan ini. Perintah az containerapp up ini bukan singkatan dari az containerapp update perintah.

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

Grup sumber daya
Azure Container Registry
Lingkungan Aplikasi Kontainer dan ruang kerja Analitik Log
Aplikasi kontainer Anda

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

Jika Anda perlu menyesuaikan lingkungan Container Apps, pertama-tama buat lingkungan menggunakan az containerapp env create perintah . Jika Anda tidak menyediakan lingkungan yang ada, perintah mencarinya di grup sumber daya Anda dan, jika ditemukan, menggunakan lingkungan tersebut up . Jika tidak ditemukan, itu membuat lingkungan dengan ruang kerja Analitik Log.

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

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	Jika Anda menggunakan repositori GitHub, daftar secara gratis.
Azure CLI	Instal Azure CLI.
Kode sumber lokal	Anda harus memiliki direktori kode sumber lokal jika Anda menggunakan kode sumber lokal.
Gambar yang Ada	Jika Anda menggunakan gambar yang ada, Anda memerlukan server registri, nama gambar, dan tag Anda. Jika Anda menggunakan registri privat, Anda memerlukan kredensial Anda.

Penyiapan

Masuk ke Azure dengan Azure CLI.
```
az login
```
Selanjutnya, instal ekstensi Azure Container Apps ke CLI.
```
az extension add --name containerapp --upgrade
```
Sekarang setelah ekstensi atau modul saat ini diinstal, daftarkan Microsoft.App namespace.
```
az provider register --namespace Microsoft.App
```
Daftarkan Microsoft.OperationalInsights penyedia untuk ruang kerja Analitik Log Azure Monitor.
```
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 menggunakan --registry-serveropsi , , --registry-usernamedan --registry-password .

Dalam contoh ini, az containerapp up perintah melakukan tindakan berikut:

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

Jalankan perintah berikut untuk menyebarkan aplikasi kontainer dari gambar yang ada. <Ganti PLACEHOLDERS> dengan nilai Anda.

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

Anda 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 yang sama dengan 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. Ini membuat registri di Azure Container Registry jika Anda tidak menyediakannya.

Perintah dapat membangun gambar dengan atau tanpa Dockerfile. Jika membangun tanpa Dockerfile, bahasa berikut didukung:

.NET
Node.js
PHP
Python

Contoh berikut menunjukkan cara menyebarkan aplikasi kontainer dari kode sumber lokal.

Dalam contoh, az containerapp up perintah melakukan tindakan berikut:

Membuat grup sumber daya.
Membuat lingkungan dan ruang kerja Analitik Log.
Membuat registri di Azure Container Registry.
Membangun gambar kontainer (menggunakan Dockerfile jika ada).
Mendorong gambar ke registri.
Membuat dan menyebarkan aplikasi kontainer.

Jalankan perintah berikut untuk menyebarkan aplikasi kontainer dari kode sumber lokal:

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

Saat Dockerfile menyertakan instruksi EXPOSE, up perintah mengonfigurasi ingress dan port target aplikasi kontainer menggunakan informasi di 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 ada kegagalan, Anda dapat menjalankan perintah lagi dengan --debug opsi untuk mendapatkan informasi selengkapnya tentang kegagalan tersebut. Jika build gagal tanpa Dockerfile, Anda dapat mencoba menambahkan Dockerfile dan menjalankan perintah lagi.

Untuk menggunakan az containerapp up perintah untuk menyebarkan ulang aplikasi kontainer Anda dengan gambar yang diperbarui, sertakan --resource-group argumen dan --environment . Contoh berikut menunjukkan cara menyebarkan ulang aplikasi kontainer dari kode sumber lokal.

Buat perubahan pada kode sumber.

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. Perintah membuat registri di Azure Container Registry jika Anda tidak menyediakannya.

Dockerfile diperlukan untuk membangun gambar. Saat Dockerfile menyertakan instruksi EXPOSE, perintah mengonfigurasi ingress dan port target aplikasi kontainer menggunakan informasi di Dockerfile.

Contoh berikut menunjukkan cara menyebarkan aplikasi kontainer dari repositori GitHub.

Dalam contoh, az containerapp up perintah melakukan tindakan berikut:

Membuat grup sumber daya.
Membuat lingkungan dan ruang kerja Analitik Log.
Membuat registri di Azure Container Registry.
Membangun gambar kontainer menggunakan Dockerfile.
Mendorong gambar ke registri.
Membuat dan menyebarkan aplikasi kontainer.
Membuat alur kerja GitHub Actions untuk membangun gambar kontainer dan menyebarkan aplikasi kontainer saat perubahan di masa mendatang didorong ke repositori GitHub.

Untuk menyebarkan aplikasi dari repositori GitHub, jalankan perintah berikut:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --repo <GitHub repository URL> \
  --ingress external

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

up Karena perintah membuat alur kerja GitHub Actions, menjalankannya kembali untuk menyebarkan perubahan pada gambar aplikasi Anda memiliki efek yang tidak diinginkan untuk membuat beberapa alur kerja. Sebagai gantinya, dorong perubahan ke repositori GitHub Anda, dan alur kerja GitHub secara otomatis membangun dan menyebarkan aplikasi Anda. Untuk mengubah alur kerja, edit file alur kerja di GitHub.

Langkah berikutnya

Mulai cepat: Menyebarkan kode Anda ke Azure Container Apps

Bagikan melalui