Mulai cepat: Menggunakan Azure App Configuration di Azure Container Apps

Artikel
03/16/2023

Dalam mulai cepat ini, Anda akan menggunakan Azure App Configuration dalam aplikasi yang berjalan di Azure Container Apps. Dengan cara ini, Anda dapat mempusatkan penyimpanan dan manajemen konfigurasi aplikasi Anda di Container Apps. Mulai cepat ini memanfaatkan aplikasi ASP.NET Core yang dibuat di Mulai Cepat: Membuat aplikasi ASP.NET Core dengan App Configuration. Anda akan melakukan kontainerisasi aplikasi dan menyebarkannya ke Azure Container Apps. Selesaikan mulai cepat sebelum Melanjutkan.

Tip

Saat mengikuti mulai cepat ini, sebaiknya daftarkan semua sumber daya baru dalam satu grup sumber daya, sehingga Anda dapat mengelompokkan ulang semuanya di satu tempat dan menghapusnya lebih cepat nanti jika Anda tidak membutuhkannya lagi.

Prasyarat

Aplikasi yang menggunakan penyimpanan App Configuration. Jika Anda tidak memilikinya, buat instans menggunakan Mulai Cepat: Membuat aplikasi ASP.NET Core dengan App Configuration.
Instans Azure Container Apps. Jika Anda tidak memilikinya, buat instans menggunakan portal Azure atau CLI.
Desktop Docker
Azure CLI

Menyambungkan Azure App Configuration ke aplikasi kontainer

Di portal Azure, navigasikan ke instans Aplikasi Kontainer Anda. Ikuti mulai cepat Konektor Layanan untuk Azure Container Apps untuk membuat koneksi layanan dengan penyimpanan App Configuration Anda menggunakan pengaturan di bawah ini.

Di tab Dasar:
- pilih App Configuration untuk Jenis layanan
- pilih toko App Configuration Anda untuk "App Configuration"
Di tab Autentikasi :
- pilih Jenis autentikasi string koneksi dan Baca-Saja untuk "Izin untuk string koneksi
- perluas menu Tingkat Lanjut . Dalam informasi Konfigurasi, harus ada variabel lingkungan yang sudah dibuat yang disebut "AZURE_APPCONFIGURATION_CONNECTIONSTRING". Edit variabel lingkungan dengan memilih ikon di sebelah kanan dan ubah nama menjadi ConnectionStrings__AppConfig. Kita perlu membuat perubahan ini karena ConnectionStrings__AppConfig adalah nama variabel lingkungan yang akan dicari oleh aplikasi yang dibangun di mulai cepat ASP.NET Core . Ini adalah variabel lingkungan yang berisi string koneksi untuk App Configuration. Jika Anda telah menggunakan aplikasi lain untuk mengikuti mulai cepat ini, silakan gunakan nama variabel lingkungan yang sesuai. Kemudian pilih Selesai.
Gunakan nilai default untuk yang lainnya.

Setelah selesai, variabel lingkungan bernama ConnectionStrings__AppConfig akan ditambahkan ke kontainer Aplikasi Kontainer Anda. Nilainya adalah referensi dari rahasia Aplikasi Kontainer, string koneksi penyimpanan App Configuration Anda.

Membangun kontainer

Jalankan perintah terbitkan dotnet untuk membuat aplikasi dalam mode rilis dan membuat aset di folder yang diterbitkan .
```
dotnet publish -c Release -o published
```
Buat file bernama Dockerfile di direktori yang berisi file .csproj Anda, buka di editor teks, dan masukkan konten berikut. Dockerfile adalah file teks yang tidak memiliki ekstensi dan yang digunakan untuk membuat gambar kontainer.
```
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
WORKDIR /app
COPY published/ ./
ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
```
Bangun kontainer dengan menjalankan perintah berikut.
```
docker build --tag aspnetapp .
```

Buat instans Azure Container Registry

Membuat Azure Container Registry (ACR). ACR memungkinkan Anda membangun, menyimpan, dan mengelola gambar kontainer.

Portal
Azure CLI

Untuk membuat registri kontainer, ikuti mulai cepat Azure Container Registry.
Setelah penyebaran selesai, buka instans ACR Anda dan dari menu sebelah kiri, pilih Pengaturan > Kunci akses.
Catat nilai Server masuk yang tercantum di halaman ini. Anda akan menggunakan informasi ini di langkah selanjutnya.
Alihkan pengguna Admin ke Diaktifkan. Opsi ini memungkinkan Anda menyambungkan ACR ke Azure Container Apps menggunakan kredensial pengguna admin. Atau, Anda dapat membiarkannya dinonaktifkan dan mengonfigurasi aplikasi kontainer untuk menarik gambar dari registri dengan identitas terkelola.

Buat instans ACR menggunakan perintah berikut. Ini membuat registri tingkat dasar bernama myregistry dengan pengguna admin diaktifkan yang memungkinkan aplikasi kontainer terhubung ke registri menggunakan kredensial pengguna admin. Untuk informasi selengkapnya, lihat mulai cepat Azure Container Registry.
```
az acr create 
--resource-group AppConfigTestResources \
--name myregistry \
--admin-enabled true \
--sku Basic
```
Dalam output perintah, perhatikan nilai server login ACR yang tercantum setelah loginServer.
Ambil nama pengguna dan kata sandi ACR dengan menjalankan az acr credential show --name myregistry. Anda akan membutuhkan nilai-nilai ini nanti.

Mendorong gambar ke Azure Container Registry

Dorong gambar Docker ke ACR yang dibuat sebelumnya.

Jalankan perintah az acr login untuk masuk ke registri.
```
az acr login --name myregistry
```
Perintah kembali Login Succeeded setelah masuk berhasil.
Gunakan tag docker untuk menandai detail gambar yang sesuai.
```
docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
```
Tip

Untuk meninjau daftar gambar dan tag docker yang ada, jalankan docker image ls. Dalam skenario ini, Anda akan melihat setidaknya dua gambar: aspnetapp dan myregistry.azurecr.io/aspnetapp.
Gunakan docker push untuk mendorong gambar ke registri kontainer. Contoh ini membuat repositori aspnetapp di ACR yang berisi aspnetapp gambar. Dalam contoh di bawah ini, ganti tempat penampung <login-server, <image-name> dan <tag> dengan nilai server masuk ACR, nama gambar dan tag gambar.

Metode:
```
docker push <login-server>/<image-name>:<tag>
```
Contoh:
```
docker push myregistry.azurecr.io/aspnetapp:v1
```
Buka Azure Container Registry Anda di portal Azure dan konfirmasikan bahwa di bawah Repositori, Anda dapat melihat repositori baru Anda.

Menambahkan gambar kontainer Anda ke Azure Container Apps

Perbarui Aplikasi Kontainer Anda untuk memuat gambar kontainer dari ACR Anda.

Di portal Azure, buka instans Azure Container Apps Anda.
Di menu sebelah kiri, di bawah Aplikasi, pilih Kontainer.
Pilih Edit dan sebarkan.
Di bawah Gambar kontainer, klik nama gambar kontainer yang ada.

Perbarui pengaturan berikut:

Pengaturan	Nilai yang disarankan	Deskripsi
Sumber gambar	Azure Container Registry	Pilih Azure Container Registry sebagai sumber gambar Anda.
Autentikasi	Info masuk Admin	Gunakan opsi kredensial pengguna admin yang diaktifkan sebelumnya di registri kontainer. Jika Anda tidak mengaktifkan pengguna admin tetapi dikonfigurasi untuk menggunakan identitas terkelola, Anda harus memasukkan gambar dan tag secara manual dalam formulir.
Registri	myregistry.azurecr.io	Pilih Azure Container Registry yang Anda buat sebelumnya.
Gambar	aspnetapp	Pilih gambar docker yang Anda buat dan dorong ke ACR sebelumnya.
Tag gambar	v1	Pilih tag gambar Anda dari daftar.

Pilih Simpan lalu Buat untuk menyebarkan pembaruan ke Aplikasi Kontainer Azure.

Telusuri ke URL Aplikasi Kontainer Azure

Di portal Azure, di instans Azure Container Apps, buka tab Gambaran Umum dan buka Url Aplikasi.

Halaman web terlihat seperti ini:

Cuplikan layar browser internet yang menampilkan aplikasi yang berjalan.

Membersihkan sumber daya

Jika Anda tidak ingin terus menggunakan sumber daya yang dibuat dalam artikel ini, hapus grup sumber daya yang Anda buat di sini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak dapat dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat sumber daya untuk artikel ini dalam grup sumber daya yang ada yang berisi sumber daya lain yang ingin disimpan, hapus setiap sumber daya satu per satu dari panelnya masing-masing, bukan menghapus grup sumber daya.

Masuk ke portal Azure, lalu pilih Grup sumber daya.
Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
Pilih Hapus grup sumber daya.
Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Masukkan nama grup sumber daya Anda untuk mengonfirmasi, dan pilih Hapus.

Setelah beberapa saat, grup sumber daya dan semua sumber dayanya akan dihapus.

Langkah berikutnya

Dalam mulai cepat ini, Anda:

Tersambung Azure App Configuration ke Azure Container Apps
Docker yang digunakan untuk membuat gambar kontainer dari aplikasi ASP.NET Core dengan pengaturan App Configuration
Membuat instans Azure Container Registry
Mendorong gambar ke instans Azure Container Registry
Menambahkan gambar kontainer ke Azure Container Apps
Ditelusuri ke URL instans Azure Container Apps yang diperbarui dengan pengaturan yang Anda konfigurasi di penyimpanan App Configuration Anda.

Identitas terkelola memungkinkan satu sumber daya Azure untuk mengakses sumber daya lain tanpa Anda mempertahankan rahasia. Anda dapat menyederhanakan akses dari Container Apps ke sumber daya Azure lainnya. Untuk informasi selengkapnya, lihat cara mengakses App Configuration menggunakan identitas terkelola dan cara [mengakses Container Registry menggunakan identitas terkelola].

Untuk mempelajari cara mengonfigurasi aplikasi web ASP.NET Core Anda untuk menyegarkan pengaturan konfigurasi secara dinamis, lanjutkan ke tutorial berikutnya.

Mengaktifkan konfigurasi dinamis