Menyebarkan Azure Container Apps dengan perintah az containerapp up
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-server
opsi , , --registry-username
dan --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.