Mengonfigurasi kontainer Docker Pemahaman Bahasa
Penting
LUIS akan dihentikan pada 1 Oktober 2025 dan mulai 1 April 2023 Anda tidak akan dapat membuat sumber daya LUIS baru. Sebaiknya migrasikan aplikasi LUIS Anda ke pemahaman bahasa percakapan untuk mendapatkan manfaat dari dukungan produk berkelanjutan dan kemampuan multibahasa.
Lingkungan runtime kontainer Pemahaman Bahasa (LUIS) dikonfigurasi menggunakan argumen perintah docker run
. LUIS memiliki beberapa pengaturan wajib, beserta beberapa pengaturan opsional. Beberapa contoh perintah tersedia. Pengaturan khusus kontainer adalah pengaturan pemasangan dan pengaturan tagihan.
Pengaturan konfigurasi
Kontainer ini memiliki pengaturan konfigurasi berikut:
Wajib | Pengaturan | Tujuan |
---|---|---|
Ya | ApiKey | Digunakan untuk melacak informasi tagihan. |
No | ApplicationInsights | Memungkinkan Anda menambahkan dukungan telemetri Azure Application Insights ke kontainer Anda. |
Ya | Billing | Menentukan URI titik akhir sumber daya layanan di Azure. |
Ya | Eula | Menunjukkan bahwa Anda telah menerima lisensi untuk kontainer. |
No | Fluentd | Menulis log dan, secara opsional, data metrik ke server Fluentd. |
No | Proksi Http | Mengonfigurasi proksi HTTP untuk membuat permintaan keluar. |
No | Pembuatan Log | Memberikan dukungan pengelogan ASP.NET Core untuk kontainer Anda. |
Ya | Pemasangan | Membaca dan menulis data dari komputer host ke kontainer dan dari kontainer kembali ke komputer host. |
Penting
Pengaturan ApiKey
, Billing
, dan Eula
digunakan bersama-sama, dan Anda harus menyediakan nilai yang valid untuk ketiganya; jika tidak, kontainer Anda tidak akan dimulai. Untuk informasi selengkapnya tentang menggunakan pengaturan konfigurasi ini untuk membuat instans kontainer, lihat Tagihan.
Pengaturan ApiKey
Pengaturan ApiKey
menentukan kunci sumber daya Azure yang digunakan untuk melacak informasi penagihan untuk kontainer. Anda harus menentukan nilai untuk ApiKey dan nilainya harus merupakan kunci yang valid untuk sumber daya layanan Azure AI yang ditentukan untuk Billing
pengaturan konfigurasi.
Pengaturan ini dapat ditemukan di tempat berikut:
- portal Azure: Manajemen Sumber Daya layanan Azure AI, di bawah Kunci
- Portal LUIS: Halaman Pengaturan Kunci dan Titik Akhir.
Jangan gunakan kunci starter atau kunci penulisan.
Pengaturan ApplicationInsights
Pengaturan ApplicationInsights
memungkinkan Anda menambahkan dukungan telemetri Azure Application Insights ke kontainer Anda. Application Insights menyediakan pemantauan mendalam kontainer Anda. Anda dapat dengan mudah memantau kontainer Anda untuk mengetahui ketersediaan, performa, dan penggunaan. Anda juga dapat dengan cepat mengidentifikasi dan mendiagnosis kesalahan dalam kontainer Anda.
Tabel berikut menjelaskan pengaturan konfigurasi yang didukung di bawah bagian ApplicationInsights
.
Wajib | Nama | Jenis data | Deskripsi |
---|---|---|---|
No | InstrumentationKey |
String | Kunci instrumentasi instans Application Insights tempat data telemetri untuk kontainer dikirim. Untuk mengetahui informasi selengkapnya, lihat Application Insights untuk ASP.NET Core. Contoh: InstrumentationKey=123456789 |
Pengaturan tagihan
Billing
Pengaturan menentukan URI titik akhir sumber daya layanan Azure AI di Azure yang digunakan untuk mengukur informasi penagihan untuk kontainer. Anda harus menentukan nilai untuk pengaturan konfigurasi ini, dan nilainya harus merupakan URI titik akhir yang valid untuk sumber daya layanan Azure AI di Azure. Kontainer melaporkan penggunaan sekitar setiap 10 hingga 15 menit.
Pengaturan ini dapat ditemukan di tempat berikut:
- portal Azure: Gambaran Umum layanan Azure AI, berlabel
Endpoint
- Portal LUIS: Halaman Pengaturan Kunci dan Titik Akhir, sebagai bagian dari URI titik akhir.
Wajib | Nama | Jenis data | Deskripsi |
---|---|---|---|
Ya | Billing |
string | URI titik akhir penagihan. Untuk informasi selengkapnya tentang mendapatkan URI penagihan, lihat mengumpulkan parameter yang diperlukan. Untuk informasi selengkapnya dan daftar lengkap titik akhir regional, lihat Nama subdomain kustom untuk layanan Azure AI. |
Pengaturan Eula
Pengaturan Eula
menunjukkan bahwa Anda telah menerima lisensi untuk kontainer. Anda harus menentukan nilai untuk pengaturan konfigurasi ini, dan nilainya harus diatur ke accept
.
Wajib | Nama | Jenis data | Deskripsi |
---|---|---|---|
Ya | Eula |
String | Penerimaan lisensi Contoh: Eula=accept |
Kontainer layanan Azure AI dilisensikan berdasarkan perjanjian Anda yang mengatur penggunaan Azure. Jika Anda tidak memiliki perjanjian yang sudah ada yang mengatur penggunaan Azure oleh Anda, Anda setuju bahwa perjanjian yang mengatur penggunaan Azure adalah Perjanjian Langganan Microsoft Online, yang menggabungkan Ketentuan Layanan Online. Untuk pratinjau, Anda juga menyetujui Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure. Dengan menggunakan kontainer, Anda menyetujui persyaratan ini.
Pengaturan Fluentd
Fluentd adalah kolektor data sumber terbuka untuk pengelogan terpadu. Pengaturan Fluentd
mengelola koneksi kontainer ke server Fluentd. Kontainer ini mencakup penyedia pembuatan log Fluentd, yang memungkinkan kontainer Anda menulis log dan, secara opsional, data metrik ke server Fluentd.
Tabel berikut menjelaskan pengaturan konfigurasi yang didukung di bawah bagian Fluentd
.
Nama | Jenis data | Deskripsi |
---|---|---|
Host |
String | Alamat IP atau nama host DNS server Fluentd. |
Port |
Bilangan bulat | Port server Fluentd. Nilai defaultnya adalah 24224. |
HeartbeatMs |
Bilangan bulat | Interval heartbeat, dalam milidetik. Jika tidak ada lalu lintas peristiwa yang dikirim sebelum interval ini berakhir, heartbeat dikirim ke server Fluentd. Nilai defaultnya adalah 60000 milidetik (1 menit). |
SendBufferSize |
Bilangan bulat | Ruang buffer jaringan, dalam byte, dialokasikan untuk operasi pengiriman. Nilai default adalah 32768 byte (32 kilobyte). |
TlsConnectionEstablishmentTimeoutMs |
Bilangan bulat | Waktu habis, dalam hitungan milidetik, untuk membangun sambungan SSL/TLS dengan server Fluentd. Nilai defaultnya adalah 10000 milidetik (10 detik). Jika UseTLS diatur ke false, nilai ini diabaikan. |
UseTLS |
Boolean | Menunjukkan apakah kontainer harus menggunakan SSL/TLS untuk berkomunikasi dengan server Fluentd. Nilai defaultnya adalah false. |
Pengaturan info masuk proksi HTTP
Jika Anda perlu mengonfigurasi proxy HTTP untuk membuat permintaan keluar, gunakan dua argumen berikut:
Nama | Jenis data | Deskripsi |
---|---|---|
HTTP_PROXY | string | Proksi yang akan digunakan, misalnya, http://proxy:8888 <proxy-url> |
HTTP_PROXY_CREDS | string | Kredensial apa pun yang diperlukan untuk mengautentikasi terhadap proxy, misalnya, username:password . Nilai ini harus dalam huruf kecil. |
<proxy-user> |
string | Pengguna untuk proksi. |
<proxy-password> |
string | Kata sandi yang terkait dengan <proxy-user> untuk proksi. |
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \
Pengaturan pengelogan
Pengaturan Logging
mengelola ASP.NET Core log support untuk kontainer Anda. Anda dapat menggunakan pengaturan konfigurasi dan nilai yang sama untuk kontainer yang Anda gunakan untuk ASP.NET Core.
Penyedia pembuatan log berikut didukung oleh kontainer:
Penyedia | Tujuan |
---|---|
Konsol | Penyedia log ASP.NET Console Core. Semua pengaturan konfigurasi ASP.NET dan nilai default untuk penyedia pembuatan log ini didukung. |
Debug | Penyedia log ASP.NET Debug Core. Semua pengaturan konfigurasi ASP.NET dan nilai default untuk penyedia pembuatan log ini didukung. |
Hard | Penyedia pencatatan log JSON. Penyedia pencatatan log ini menulis data log ke tempat output. |
Perintah kontainer ini menyimpan informasi pencatatan dalam format JSON ke tempat output:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
Perintah kontainer ini menunjukkan informasi debugging, dia awali dengan dbug
, saat kontainer sedang berjalan:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug
Pencatatan log disk
Penyedia pencatatan log Disk
mendukung setelan konfigurasi berikut ini:
Nama | Jenis data | Deskripsi |
---|---|---|
Format |
String | Format output untuk file log. Catatan: Nilai ini harus disetel json untuk mengaktifkan penyedia pembuatan log. Jika nilai ini ditentukan tanpa juga menentukan dudukan output saat instantiating kontainer, kesalahan terjadi. |
MaxFileSize |
Bilangan bulat | Ukuran maksimum, dalam megabyte (MB), dari file log. Ketika ukuran file log saat ini memenuhi atau melebihi nilai ini, file log baru dimulai oleh penyedia pembuatan log. Jika -1 dispesifikasikan, ukuran berkas log hanya dibatasi oleh ukuran berkas maksimum, jika ada, untuk keluaran mount. Nilai default adalah 1. |
Untuk informasi selengkapnya tentang mengonfigurasi ASP.NET log Core, lihat Pengaturan konfigurasi file.
Pengaturan Pemasangan
Gunakan pemasangan ikat untuk membaca dan menulis data ke dan dari kontainer. Anda dapat menentukan pemasangan input atau pemasangan output dengan menentukan opsi --mount
di perintah eksekusi docker.
Kontainer LUIS tidak menggunakan pemasangan input atau output untuk menyimpan data pelatihan atau layanan.
Sintaks yang tepat untuk lokasi pemasangan host bervariasi tergantung sistem operasi host. Selain itu, lokasi pemasangan komputer host mungkin tidak dapat diakses karena konflik antara izin yang digunakan oleh akun layanan docker dan izin lokasi pemasangan host.
Tabel berikut ini menjelaskan pengaturan yang didukung.
Wajib | Nama | Jenis data | Deskripsi |
---|---|---|---|
Ya | Input |
String | Target pemasangan input. Nilai defaultnya adalah /input . Ini adalah lokasi file paket LUIS. Contoh: --mount type=bind,src=c:\input,target=/input |
No | Output |
String | Target dari pemasangan output. Nilai defaultnya adalah /output . Ini adalah lokasi log. Ini berisi log kueri LUIS dan log kontainer. Contoh: --mount type=bind,src=c:\output,target=/output |
Contoh perintah eksekusi docker
Contoh berikut menggunakan pengaturan konfigurasi untuk mengilustrasikan cara menulis dan menggunakan perintah docker run
. Begitu dijalankan, kontainer akan terus berjalan sampai Anda menghentikan kontainer tersebut.
- Contoh ini menggunakan direktori dari drive
C:
untuk menghindari konflik izin di Windows. Jika perlu menggunakan direktori tertentu sebagai direktori input, Anda mungkin perlu memberikan izin layanan docker. - Jangan mengubah urutan argumen kecuali Anda memahami kontainer docker.
- Jika Anda menggunakan sistem operasi yang berbeda, gunakan konsol/terminal yang benar, sintaksis folder untuk pemasangan, dan karakter kelanjutan baris untuk sistem Anda. Contoh berikut mengasumsikan konsol Windows dengan karakter kelanjutan baris
^
. Karena kontainer adalah sistem operasi Linux, dudukan target menggunakan sintaksis folder gaya Linux.
Ganti {argument_name} dengan nilai Anda sendiri:
Placeholder | Nilai | Format atau contoh |
---|---|---|
{API_KEY} | Kunci titik akhir sumber daya LUIS di halaman Kunci LUIS Azure. |
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
{ENDPOINT_URI} | Nilai titik akhir tagihan tersedia di halaman Gambaran Umum LUIS Azure. |
Lihat mengumpulkan parameter yang diperlukan untuk contoh eksplisit. |
Catatan
Sumber daya baru yang dibuat setelah 1 Juli 2019, akan menggunakan nama subdomain kustom. Untuk informasi selengkapnya dan daftar lengkap titik akhir regional, lihat Nama subdomain kustom untuk layanan Azure AI.
Penting
Opsi Eula
, Billing
, dan ApiKey
harus ditentukan untuk menjalankan kontainer; jika tidak, kontainer tidak akan dimulai. Untuk mengetahui informasi lebih lanjut, lihat Penagihan.
Nilai ApiKey adalah Kunci dari halaman Kunci dan Titik Akhir di portal LUIS dan juga tersedia di halaman kunci sumber daya Azure AI services
Azure.
Contoh dasar
Contoh berikut ini memiliki argumen sesingkat mungkin untuk menjalankan kontainer:
docker run --rm -it -p 5000:5000 --memory 4g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY}
Contoh ApplicationInsights
Contoh berikut menetapkan argumen ApplicationInsights untuk mengirim telemetri ke Application Insights saat kontainer sedang berjalan:
docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
InstrumentationKey={INSTRUMENTATION_KEY}
Contoh pembuatan log
Perintah berikut mengatur tingkat pembuatan log, Logging:Console:LogLevel
, untuk mengonfigurasi tingkat pembuatan log menjadi Information
.
docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
Logging:Console:LogLevel:Default=Information
Langkah berikutnya
- Baca Cara menginstal dan menjalankan kontainer
- Lihat Pemecahan Masalah untuk mengatasi masalah yang terkait dengan fungsi LUIS.
- Gunakan lebih banyak kontainer Azure AI