Bagikan melalui

Referensi: Pengaturan konfigurasi Azure Arc gateway yang dihost sendiri

BERLAKU UNTUK: Pengembang | Premium

Artikel ini menyediakan referensi untuk pengaturan yang diperlukan dan opsional yang digunakan untuk mengonfigurasi ekstensi Azure Arc untuk kontainer gateway yang dihost sendiri API Management.

Penting

Gateway yang dihosting sendiri API Management di Azure Arc saat ini sedang dalam pratinjau. Selama pratinjau, ekstensi gateway API Management tersedia di wilayah berikut:

  • Asia (Timur, Tenggara)
  • Australia (Tengah, Tengah 2, Timur & Tenggara)
  • Brasil (Selatan & Tenggara)
  • Kanada (Tengah, Timur)
  • Eropa (Utara, Barat)
  • Prancis (Tengah & Selatan)
  • Jerman (Utara & Barat Tengah)
  • India (Tengah, Selatan, Barat, Jio tengah & Jio Barat)
  • Jepang (Timur & Barat)
  • Korea (Tengah & Selatan)
  • Norwegia (Timur & Barat)
  • Afrika Selatan (Utara & Barat)
  • Swedia (Tengah)
  • Swiss (Utara & Barat)
  • Uni Emirat Arab (UEA - Tengah & Utara)
  • Inggris Raya (Inggris -Selatan)
  • Amerika Serikat (AS - Tengah, Tengah EUAP, Timur, Timur 2, Timur 2 EUAP, Tengah Utara, Tengah Selatan, Tengah Barat, Barat, Barat 2, Barat 3)

Integrasi API Konfigurasi

API Konfigurasi digunakan oleh gateway yang dihost sendiri untuk terhubung ke Azure API Management untuk mendapatkan konfigurasi terbaru dan mengirim metrik, saat diaktifkan.

Berikut adalah gambaran umum semua opsi konfigurasi:

Nama Deskripsi Wajib diisi Default
gateway.configuration.uri Titik akhir konfigurasi di Azure API Management untuk gateway yang dihosting sendiri. Temukan nilai ini di portal Azure pada Penyebaran>Gateway. Ya T/A
gateway.auth.token Kunci autentikasi untuk mengautentikasi ke layanan Azure API Management. Biasanya dimulai dengan GatewayKey. Ya T/A
gateway.configuration.backup.enabled Jika diaktifkan akan menyimpan salinan cadangan konfigurasi terbaru yang diunduh pada volume penyimpanan false
gateway.configuration.backup.persistentVolumeClaim.accessMode Mode akses untuk pod Klaim Volume Persisten (PVC) ReadWriteMany
gateway.configuration.backup.persistentVolumeClaim.size Ukuran Klaim Volume Persisten (PVC) yang akan dibuat 50Mi
gateway.configuration.backup.persistentVolumeClaim.storageClassName Nama kelas penyimpanan yang akan digunakan untuk Klaim Volume Persisten (PVC). Ketika tidak ada nilai yang ditetapkan (null), default platform akan digunakan. Kelas penyimpanan yang ditentukan harus mendukung ReadWriteMany mode akses, pelajari selengkapnya tentang penyedia volume yang didukung dan mode akses yang didukung. null

Penemuan & sinkronisasi lintas instans

Nama Deskripsi Wajib diisi Default
service.instance.heartbeat.port Port UDP yang digunakan untuk instans penyebaran gateway yang dihost sendiri untuk mengirim heartbeat ke instans lain. No 4291
service.instance.synchronization.port Port UDP yang digunakan untuk instans gateway yang dihost sendiri untuk menyinkronkan pembatasan laju di beberapa instans. No 4290

Metrik

Nama Deskripsi Wajib diisi Default
telemetry.metrics.cloud Indikasi apakah mengaktifkan metrik emisi ke Azure Monitor atau tidak. No true
telemetry.metrics.local Aktifkan pengumpulan metrik lokal melalui StatsD. Nilai adalah salah satu opsi berikut: none, statsd. No T/A
telemetry.metrics.localStatsd.endpoint Titik akhir StatsD. Ya, jika telemetry.metrics.local diatur ke statsd; jika tidak, tidak. T/A
telemetry.metrics.localStatsd.sampling Tingkat pengambilan sampel metrik StatsD. Nilai harus antara 0 dan 1, misalnya, 0,5. No T/A
telemetry.metrics.localStatsd.tagFormat format pemberian tag eksportir StatsD. Nilai adalah salah satu opsi berikut: ibrato, , dogStatsDinfluxDB. No T/A
telemetry.metrics.opentelemetry.enabled Indikasi apakah akan mengaktifkan memancarkan metrik ke kolektor OpenTelemetry atau tidak di Kubernetes. No false
telemetry.metrics.opentelemetry.collector.uri URI pengumpul OpenTelemetry untuk mengirim metrik. Ya, jika observability.opentelemetry.enabled diatur ke true; jika tidak, tidak. T/A

Log

Nama Deskripsi Wajib diisi Default
telemetry.logs.std Aktifkan pengelogan ke aliran standar. Nilai adalah salah satu opsi berikut: none, , textjson. No text
telemetry.logs.local Aktifkan pengelogan lokal. Nilai adalah salah satu opsi berikut: none, , auto, localsyslog, rfc5424, journal, json No auto
telemetry.logs.localConfig.localsyslog.endpoint Titik akhir untuk syslog lokal Ya jika telemetry.logs.local diatur ke localsyslog; jika tidak, tidak. T/A
telemetry.logs.localConfig.localsyslog.facility Menentukan kode fasilitas syslog lokal, misalnya, 7. No T/A
telemetry.logs.localConfig.rfc5424.endpoint titik akhir rfc5424. Ya jika telemetry.logs.local diatur ke rfc5424; jika tidak, tidak. T/A
telemetry.logs.localConfig.rfc5424.facility Kode fasilitas per rfc5424, misalnya, 7 No T/A
telemetry.logs.localConfig.journal.endpoint Titik akhir jurnal. Ya jika telemetry.logs.local diatur ke journal; jika tidak, tidak. T/A

Perutean lalu lintas

Nama Deskripsi Wajib diisi Default
service.type Jenis layanan Kubernetes yang akan digunakan untuk mengekspos gateway. (docs) No ClusterIP
service.http.port Port yang digunakan untuk mengekspos lalu lintas HTTP. No 8080
service.http.nodePort Port pada simpul yang digunakan untuk mengekspos lalu lintas HTTP. Ini memerlukan NodePort sebagai jenis layanan. No T/A
service.https.port Port yang digunakan untuk mengekspos lalu lintas HTTPS. No 8081
service.https.nodePort Port pada simpul yang digunakan untuk mengekspos lalu lintas HTTPS. Ini memerlukan NodePort sebagai jenis layanan. No T/A
service.annotations Anotasi yang akan ditambahkan ke layanan Kubernetes untuk gateway. No T/A
ingress.annotations Anotasi untuk ditambahkan ke Kubernetes Ingress untuk gateway. (Eksperimental) No T/A
ingress.enabled Indikasi apakah Kubernetes Ingress harus digunakan atau tidak. (Eksperimental) No false
ingress.tls Konfigurasi TLS untuk Kubernetes Ingress. (Eksperimental) No T/A
ingress.hosts Konfigurasi host yang akan digunakan untuk Kubernetes Ingress. (Eksperimental) No T/A

Integrasi

Gateway yang dihost sendiri terintegrasi dengan berbagai teknologi lainnya. Bagian ini memberikan gambaran umum tentang opsi konfigurasi yang tersedia yang dapat Anda gunakan.

Dapr

Nama Deskripsi Wajib diisi Default
dapr.enabled Indikasi apakah integrasi Dapr harus digunakan atau tidak. No false
dapr.app.id ID Aplikasi yang akan digunakan untuk integrasi Dapr Tidak
dapr.config Menentukan Dapr CRD Konfigurasi mana yang harus digunakan tracing
dapr.logging.level Tingkat verbositas log sidecar Dapr info
dapr.logging.useJsonOutput Indikasi apakah pengelogan harus dalam format JSON atau tidak true

Azure Monitor

Nama Deskripsi Wajib diisi Default
monitoring.customResourceId ID sumber daya ruang kerja Azure Log Analytics untuk mengirim log. No T/A
monitoring.ingestionKey Kunci penyerapan untuk mengautentikasi dengan ruang kerja Azure Log Analytics untuk mengirim log. No T/A
monitoring.workspaceId ID ruang kerja ruang kerja Azure Log Analytics untuk mengirim log. No T/A

Penjadwalan gambar & beban kerja

Kubernetes adalah platform orkestrasi kuat yang memberikan banyak fleksibilitas dalam apa yang harus disebarkan dan bagaimana seharusnya dijadwalkan.

Bagian ini memberikan gambaran umum tentang opsi konfigurasi yang tersedia yang dapat Anda gunakan untuk memengaruhi gambar yang digunakan, caranya dijadwalkan dan dikonfigurasi untuk menyembuhkan diri sendiri.

Nama Deskripsi Wajib diisi Default
replicaCount Jumlah instans gateway yang dihost sendiri untuk dijalankan. No 3
image.repository Gambar yang akan dijalankan. No mcr.microsoft.com/azure-api-management/gateway
image.pullPolicy Kebijakan yang digunakan untuk menarik gambar kontainer. No IfNotPresent
image.tag Tag gambar kontainer untuk digunakan. No Versi aplikasi ekstensi digunakan
imagePullSecrets Rahasia Kubernetes untuk digunakan untuk mengautentikasi dengan registri kontainer saat menarik gambar kontainer. No T/A
probes.readiness.httpGet.path Jalur URI yang akan digunakan untuk pemeriksaan kesiapan kontainer No /status-0123456789abcdef
probes.readiness.httpGet.port Port yang digunakan untuk pemeriksaan keaktifan kontainer No http
probes.liveness.httpGet.path Jalur URI yang akan digunakan untuk pemeriksaan keaktifan kontainer No /status-0123456789abcdef
probes.liveness.httpGet.port Port yang digunakan untuk pemeriksaan keaktifan kontainer No http
highAvailability.enabled Indikasi apakah gateway harus dijadwalkan dengan ketersediaan tinggi di kluster atau tidak. No false
highAvailability.disruption.maximumUnavailable Jumlah pod yang diizinkan untuk tidak tersedia karena gangguan sukarela. No 25%
highAvailability.podTopologySpread.whenUnsatisfiable Indikasi bagaimana pod harus tersebar di seluruh simpul jika persyaratan tidak dapat dipenuhi. Pelajari lebih lanjut di dokumen Kubernetes No ScheduleAnyway
resources Kemampuan untuk menentukan sumber daya CPU/Memori untuk ditetapkan ke gateway No T/A
nodeSelector Kemampuan untuk menggunakan pemilih untuk mengidentifikasi simpul tempat gateway harus berjalan. No T/A
affinity Afinitas untuk penjadwalan pod (dokumen) No T/A
tolerations Toleransi untuk penjadwalan pod (dokumen) No T/A

Langkah berikutnya

  • Last updated on