Ringkasan
API terlatih adalah kumpulan layanan AI yang mencakup Pengenalan Karakter Optik (OCR), Speech-to-Text, dan Terjemahan. Layanan diaktifkan dan dinonaktifkan menggunakan Kubernetes Resource Model (KRM) API. KRM API adalah API pengelolaan yang secara opsional digunakan oleh Admin AI Platform.
Tujuan halaman ini adalah untuk memberikan informasi saja.
aiplatform.private.gdc.goog/v1
Paket v1 berisi definisi Skema API untuk grup API aiplatform.private.gdc.goog v1
Pemberitahuan
Pemberitahuan berisi nama ConfigMap yang akan diproses dan diubah menjadi CR pemberitahuan Platform Observabilitas: MonitoringRule dan LoggingRule.
Muncul di: - Kemampuan observasi
| Kolom | Deskripsi |
|---|---|
monitoringAlertsConfigMap string |
Configmap dengan CR MonitoringRule tersemat untuk mengambil dari Cluster K8s Jarak Jauh dan diproses dengan mengubahnya menjadi CR MonitoringRule Platform Observabilitas dan di-deploy ke Cluster Admin. |
loggingAlertsConfigMap string |
ConfigMap dengan CR LoggingRule tersemat untuk mengambil dari Cluster K8s Jarak Jauh dan diproses dengan mengubahnya menjadi CR LoggingRule Platform Observabilitas dan di-deploy ke Cluster Admin. |
AppConfig
AppConfig adalah Skema untuk AppConfig API. Harus memiliki satu per namespace
Muncul di: - AppConfigList
| Kolom | Deskripsi |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
AppConfig |
metadata ObjectMeta |
Lihat dokumentasi Kubernetes API untuk mengetahui kolom metadata. |
spec AppConfigSpec |
|
status AppConfigStatus |
AppConfigList
AppConfigList berisi daftar AppConfig
| Kolom | Deskripsi |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
AppConfigList |
metadata ListMeta |
Lihat dokumentasi Kubernetes API untuk mengetahui kolom metadata. |
items AppConfig array |
AppConfigSpec
Muncul di: - AppConfig
| Kolom | Deskripsi |
|---|---|
sql Database |
AppConfigStatus
AppConfigStatus menentukan status AppConfig yang diamati.
Muncul di: - AppConfig
| Kolom | Deskripsi |
|---|---|
ready boolean |
Siap menunjukkan apakah resource dalam status siap. |
primaryCondition ResourceCondition |
PrimaryCondition mewakili kondisi utama resource. Jika resource siap, kondisi akan menunjukkan bahwa resource siap. Jika tidak, kondisi akan menjadi alasan utama mengapa resource belum siap. |
resourceConditions Array ResourceCondition |
ResourceConditions adalah kumpulan kondisi untuk resource dan sub-resource-nya. Health check dapat digunakan untuk menentukan kondisi keseluruhan resource dan sub-resource-nya. |
conditions Array Condition |
Kondisi merepresentasikan kondisi resource mentah yang diisi dari resource Kubernetes untuk tujuan penelusuran kesalahan. |
database DatabaseInfo |
Menampilkan informasi subresource Database. |
Dasbor
Dasbor berisi daftar nama configmap yang kompatibel dengan dasbor Observability Platform yang akan diproses.
Muncul di: - Kemampuan observasi
| Kolom | Deskripsi |
|---|---|
configMaps array string |
ConfigMap (dengan definisi json dasbor Grafana tersemat) yang akan diproses; ConfigMap ini diharapkan ada di cluster dan namespace pengguna tempat beban kerja AI di-deploy. Harus ada pemetaan 1:1 antara jumlah dasbor yang diinginkan dan configmap dasbor. Kita mengasumsikan akan ada satu kunci dalam configmap: 'data', yang akan menyimpan string json definisi dasbor. |
Database
Database mengonfigurasi persyaratan DB relasional untuk Microservice target.
Muncul di: - AppConfigSpec
| Kolom | Deskripsi |
|---|---|
postgres PostgresConfig |
DatabaseInfo
DatabaseInfo menentukan status yang diamati dari Informasi Database.
Muncul di: - AppConfigStatus
| Kolom | Deskripsi |
|---|---|
endpoint string |
|
port string |
HPAStatus
HPAStatus menjelaskan kondisi status HorizontalPodAutoscaler.
Muncul di: - MicroserviceStatus
| Kolom | Deskripsi |
|---|---|
statusConditions Array HorizontalPodAutoscalerCondition |
Kondisi status |
currentReplicas integer |
Jumlah replika saat ini yang dikelola oleh HPA |
desiredReplicas integer |
Jumlah replika yang diinginkan yang dikelola oleh HPA |
Logging
Logging mengonfigurasi fungsi pengumpulan log untuk Platform Observabilitas di GDC yang terisolasi (jangan aktifkan jika menguji di GKE - fungsi ini tidak berlaku di sana).
Muncul di: - Kemampuan observasi
| Kolom | Deskripsi |
|---|---|
enableLogCollection boolean |
EnableLogCollection menunjukkan apakah akan mengaktifkan pengumpulan log melalui Observability Platform atau tidak. |
staticLabels object (keys:string, values:string) |
Dipetakan ke properti 'additionalLabels' OP LoggingTargetCR. Label statis yang akan ditambahkan ke semua entri log yang diambil. Nama label tidak boleh berisi tanda hubung ("-"); nilai label dapat berisi tanda hubung. |
Metrik
Metrics mengonfigurasi cara pengumpulan metrik pod.
Muncul di: - Kemampuan observasi
| Kolom | Deskripsi |
|---|---|
prometheus PrometheusMetrics |
Microservice
Microservice adalah Skema untuk API layanan
Muncul di: - MicroserviceList
| Kolom | Deskripsi |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
Microservice |
metadata ObjectMeta |
Lihat dokumentasi Kubernetes API untuk mengetahui kolom metadata. |
spec MicroserviceSpec |
|
status MicroserviceStatus |
MicroserviceList
MicroserviceList berisi daftar Microservice
| Kolom | Deskripsi |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
MicroserviceList |
metadata ListMeta |
Lihat dokumentasi Kubernetes API untuk mengetahui kolom metadata. |
items Array Microservice |
MicroserviceSpec
MicroserviceSpec menentukan status Microservice yang diinginkan.
Muncul di: - Microservice
| Kolom | Deskripsi |
|---|---|
public boolean |
Apakah Microservice ini bersifat publik. Jika benar, instance akan memiliki data DNS yang diekspos serta endpoint publik. TLS juga akan disiapkan di gateway secara otomatis sesuai dengan nama DNS. Awalan DNS akan menjadi nama Microservice dalam metadata. |
enableBucketAccess boolean |
Apakah akan menyediakan konfigurasi terkait bucket penyimpanan ke penampung |
dnsname string |
Nama host DNS. Nama ini akan digunakan untuk membuat nama host DNS untuk Microservice di lingkungan GDC saat Microservice bersifat publik |
autoscaling |
Konfigurasi penskalaan otomatis. |
observability Kemampuan observasi |
Konfigurasi kemampuan observasi (logging, metrik, pemantauan, dan dasbor) (beberapa di antaranya hanya berlaku untuk konfigurasi air gap GDC). |
prerequisites Prasyarat |
Konfigurasi prasyarat. |
template PodTemplateSpec |
Template untuk membuat pod di Microservice. Microservice akan berisi deployment stateless untuk pod ini. |
PodSpec
PodSpec adalah versi minimalis dari PodSpec inti.
Muncul di: - PodTemplateSpec
| Kolom | Deskripsi |
|---|---|
containers Array Container |
Menentukan container. Tidak semua atribut didukung. Port yang ditentukan dari semua container akan diekspos. Container pertama (containers[0]) dianggap sebagai container utama dan akan diberi tag dengan permintaan resource untuk penyediaan otomatis node. Penampung lainnya dianggap sebagai penampung tambahan (misalnya, sidecar). |
nodeSelector object (keys:string, values:string) |
NodeSelector adalah pemilih yang harus benar agar pod dapat sesuai di node. Pemilih yang harus cocok dengan label node agar pod dijadwalkan di node tersebut. |
volumes Array Volume |
Daftar volume yang akan dipasang ke pod |
initContainers Array Container |
Daftar container inisialisasi milik pod. Container init dieksekusi secara berurutan sebelum container dimulai. Jika ada init container yang gagal, pod dianggap gagal dan ditangani sesuai dengan restartPolicy-nya. Nama untuk init container atau container normal harus unik di antara semua container. Tidak dapat diperbarui. Info selengkapnya: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ |
tolerations Array Toleration |
Jika ditentukan, toleransi pod. |
serviceAccount string |
Akun layanan Kubernetes yang telah dibuat sebelumnya dan akan digunakan oleh pod. |
PodTemplateSpec
PodTemplateSpec adalah objek penampung untuk PodSpec dan berpotensi menjadi spesifikasi metadata.
Muncul di: - Microservice
| Kolom | Deskripsi |
|---|---|
metadata ObjectMeta |
Lihat dokumentasi Kubernetes API untuk mengetahui kolom metadata. |
spec PodSpec |
MicroserviceStatus
MicroserviceStatus menentukan status Microservice yang diamati.
Muncul di: - Microservice
| Kolom | Deskripsi |
|---|---|
observedGeneration integer |
Generasi yang diamati oleh pengontrol deployment. |
endpoint string |
Endpoint tempat Microservice ini dapat diakses. Hanya diisi untuk layanan publik. |
deploymentStatus DeploymentStatus |
Status deployment Microservice ini. |
hpaStatus HPAStatus |
Status HorizontalPodAutoscaler. |
ready boolean |
Status kesiapan Microservice secara keseluruhan |
conditions Array Condition |
Mewakili pengamatan terbaru yang tersedia tentang status Microservice saat ini. |
Kemampuan observasi
Observability mengonfigurasi berbagai komponen dan parameter yang diperlukan oleh Observability Platform (di GDC yang terisolasi dari internet), atau eksposur Metrik (di GKE).
Muncul di: - MicroserviceSpec
| Kolom | Deskripsi |
|---|---|
metrics Metrik |
Konfigurasi metrik. Di GKE, data ini hanya dikumpulkan di container pertama. Di GDC yang terisolasi dari internet, bagian ini digunakan bersama dengan bagian Observability untuk mengonfigurasi perilaku Observability Platform. |
logging Logging |
|
alerting Pemberitahuan |
|
dashboards Dasbor |
PostgresConfig
PostgresConfig menentukan setelan konfigurasi target yang relevan untuk DB Postgres.
Muncul di: - Database
| Kolom | Deskripsi |
|---|---|
version string |
Prasyarat
Prasyarat mengonfigurasi prasyarat apa pun untuk Microservice.
Muncul di: - MicroserviceSpec
| Kolom | Deskripsi |
|---|---|
sql boolean |
Konfigurasi SQL, jika diperlukan oleh workload target |
PrometheusMetrics
PrometheusMetrics mengonfigurasi metrik Prometheus yang diekspos oleh pod.
Muncul di: - Metrik
| Kolom | Deskripsi |
|---|---|
path string |
Jalur URI metrik untuk meng-scrape metrik dari. Defaultnya adalah /metrics. |
port integer |
Port untuk meng-scrape metrik. Setelan defaultnya adalah 80. |