Información general
Las APIs preentrenadas son un conjunto de servicios de IA que incluyen el reconocimiento óptico de caracteres (OCR), Speech-to-Text y Translation. Los servicios se habilitan e inhabilitan mediante la API Kubernetes Resource Model (KRM). La API KRM es una API de gestión que usa de forma opcional el administrador de AI Platform.
El objetivo de esta página es proporcionar información.
aiplatform.private.gdc.goog/v1
El paquete v1 contiene definiciones de esquemas de API para el grupo de APIs v1 de aiplatform.private.gdc.goog.
Alertas
Alerting contiene los nombres de los ConfigMaps que se van a procesar y transformar en CRs de alertas de Observability Platform: MonitoringRule y LoggingRule.
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
monitoringAlertsConfigMap cadena |
ConfigMap con CR MonitoringRule insertado para obtener datos de un clúster de Kubernetes remoto y procesarlos transformándolos en un CR MonitoringRule de la plataforma de observabilidad e implementándolos en el clúster de administrador. |
loggingAlertsConfigMap cadena |
ConfigMap con CR LoggingRule insertado para obtener datos de un clúster de K8s remoto y procesarlos transformándolos en un CR LoggingRule de la plataforma de observabilidad e implementándolos en el clúster de administrador. |
AppConfig
AppConfig es el esquema de la API AppConfig. Debe haber uno por espacio de nombres
Aparece en: - AppConfigList
| Campo | Descripción |
|---|---|
apiVersion cadena |
aiplatform.private.gdc.goog/v1 |
kind cadena |
AppConfig |
metadata ObjectMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
spec AppConfigSpec |
|
status AppConfigStatus |
AppConfigList
AppConfigList contiene una lista de AppConfig
| Campo | Descripción |
|---|---|
apiVersion cadena |
aiplatform.private.gdc.goog/v1 |
kind cadena |
AppConfigList |
metadata ListMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
items AppConfig |
AppConfigSpec
Aparece en: - AppConfig
| Campo | Descripción |
|---|---|
sql Base de datos |
AppConfigStatus
AppConfigStatus define el estado observado de AppConfig.
Aparece en: - AppConfig
| Campo | Descripción |
|---|---|
ready booleano |
Ready indica si el recurso está en un estado listo. |
primaryCondition ResourceCondition |
PrimaryCondition representa la condición principal de un recurso. Si el recurso está listo, la condición indicará que lo está. De lo contrario, la condición será el motivo principal por el que el recurso no esté listo. |
resourceConditions Matriz ResourceCondition |
ResourceConditions es una colección de condiciones de un recurso y sus subrecursos. Se puede usar para determinar el estado general de un recurso y sus subrecursos. |
conditions Matriz Condition |
Conditions representa las condiciones de recursos sin procesar rellenadas a partir de recursos de Kubernetes con fines de depuración. |
database DatabaseInfo |
Presenta la información del subrecurso Database. |
Paneles de control
Dashboards contiene una lista de los nombres de los configmaps compatibles con los paneles de control de la plataforma Observability que se van a procesar.
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
configMaps matriz de cadenas |
ConfigMaps (con la definición JSON del panel de control de Grafana insertada) que se van a procesar. Se espera que estos elementos se encuentren en el clúster de usuario y en el espacio de nombres en los que se implementan las cargas de trabajo de IA. Debe haber una asignación de uno a uno entre el número de paneles de control deseados y los configmaps de los paneles de control. Suponemos que habrá una sola clave en el mapa de configuración: "data", que contendrá la cadena JSON de la definición del panel de control. |
Base de datos
La base de datos configura los requisitos de la base de datos relacional del microservicio de destino.
Aparece en: - AppConfigSpec
| Campo | Descripción |
|---|---|
postgres PostgresConfig |
DatabaseInfo
DatabaseInfo define el estado observado de la información de la base de datos.
Aparece en: - AppConfigStatus
| Campo | Descripción |
|---|---|
endpoint cadena |
|
port cadena |
HPAStatus
HPAStatus describe las condiciones de estado de HorizontalPodAutoscaler.
Aparece en: - MicroserviceStatus
| Campo | Descripción |
|---|---|
statusConditions Matriz HorizontalPodAutoscalerCondition |
Condiciones de estado |
currentReplicas entero |
Número de réplicas actuales gestionadas por el HPA. |
desiredReplicas entero |
Número de réplicas deseadas gestionadas por el HPA. |
Almacenamiento de registros
El registro configura la función de recogida de registros de la plataforma de observabilidad en GDC air-gapped (no lo habilites si estás haciendo pruebas en GKE, ya que esta función no se aplica en ese entorno).
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
enableLogCollection booleano |
EnableLogCollection indica si se debe habilitar la recogida de registros a través de la plataforma Observability. |
staticLabels objeto (claves:cadena, valores:cadena) |
Se asigna a la propiedad "additionalLabels" de OP LoggingTargetCR. Etiquetas estáticas que se añadirán a todas las entradas de registro capturadas. Los nombres de las etiquetas no deben contener guiones ("-"), pero los valores de las etiquetas sí pueden contenerlos. |
Métricas
Metrics configura cómo se recogerán las métricas de un pod.
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
prometheus PrometheusMetrics |
Microservicio
Microservice es el esquema de la API de servicios.
Aparece en: - MicroserviceList
| Campo | Descripción |
|---|---|
apiVersion cadena |
aiplatform.private.gdc.goog/v1 |
kind cadena |
Microservice |
metadata ObjectMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
spec MicroserviceSpec |
|
status MicroserviceStatus |
MicroserviceList
MicroserviceList contiene una lista de Microservice.
| Campo | Descripción |
|---|---|
apiVersion cadena |
aiplatform.private.gdc.goog/v1 |
kind cadena |
MicroserviceList |
metadata ListMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
items Matriz de microservicios |
MicroserviceSpec
MicroserviceSpec define el estado deseado de Microservice.
Aparece en: - Microservicio
| Campo | Descripción |
|---|---|
public booleano |
Indica si este microservicio es público. Si es true, tendrá un registro DNS expuesto y un endpoint público. TLS también se configurará automáticamente en la pasarela según el nombre DNS. El prefijo DNS será el nombre del microservicio en los metadatos. |
enableBucketAccess booleano |
Si se deben aprovisionar las configuraciones relacionadas con el contenedor en el bucket de almacenamiento |
dnsname cadena |
Nombre de host de DNS. Se usará para crear el nombre de host DNS del microservicio en el entorno de GDC cuando el microservicio sea público. |
autoscaling |
Configuraciones de autoescalado. |
observability Observabilidad |
Configuración de la observabilidad (registros, métricas, monitorización y paneles de control). Algunas de estas opciones solo se aplican a las configuraciones aisladas de GDC. |
prerequisites Requisitos |
Configuración de los requisitos previos. |
template PodTemplateSpec |
Plantilla para crear pods en el microservicio. El microservicio contendrá implementaciones sin estado para estos pods. |
PodSpec
PodSpec es una versión minimalista del PodSpec principal.
Aparece en: - PodTemplateSpec
| Campo | Descripción |
|---|---|
containers Contenedor array |
Especifica contenedores. No se admiten todos los atributos. Se expondrán los puertos especificados de todos los contenedores. El primer contenedor (containers[0]) se considera el contenedor principal y será el que se etiquete con solicitudes de recursos para el aprovisionamiento automático de nodos. El resto de los contenedores se consideran auxiliares (por ejemplo, sidecars). |
nodeSelector objeto (claves:cadena, valores:cadena) |
NodeSelector es un selector que debe ser true para que el pod se ajuste a un nodo. Selector que debe coincidir con las etiquetas de un nodo para que el pod se programe en ese nodo. |
volumes Matriz de volumen |
Lista de volúmenes que se montarán en los pods |
initContainers Contenedor array |
Lista de contenedores de inicialización que pertenecen al pod. Los contenedores init se ejecutan en orden antes de que se inicien los contenedores. Si falla algún contenedor init, se considera que el pod ha fallado y se gestiona según su restartPolicy. El nombre de un contenedor init o de un contenedor normal debe ser único entre todos los contenedores. No se puede actualizar. Más información: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ |
tolerations Matriz Toleration |
Si se especifica, las tolerancias del pod. |
serviceAccount cadena |
La cuenta de servicio de Kubernetes creada previamente que usará el pod. |
PodTemplateSpec
PodTemplateSpec es un objeto contenedor de PodSpec y, posiblemente, de especificaciones de metadatos.
Aparece en: - Microservicio
| Campo | Descripción |
|---|---|
metadata ObjectMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
spec PodSpec |
MicroserviceStatus
MicroserviceStatus define el estado observado de Microservice.
Aparece en: - Microservicio
| Campo | Descripción |
|---|---|
observedGeneration entero |
Generación observada por el controlador de despliegue. |
endpoint cadena |
El endpoint desde el que se puede acceder a este microservicio. Solo se rellena en el caso de los servicios públicos. |
deploymentStatus DeploymentStatus |
El estado del despliegue de este microservicio. |
hpaStatus HPAStatus |
Estado de HorizontalPodAutoscaler. |
ready booleano |
Estado general de preparación del microservicio |
conditions Matriz Condition |
Representa las últimas observaciones disponibles del estado actual de un microservicio. |
Observabilidad
Observabilidad configura los distintos componentes y parámetros que requiere la plataforma Observabilidad (en GDC air-gapped) o la exposición de métricas (en GKE).
Aparece en: - MicroserviceSpec
| Campo | Descripción |
|---|---|
metrics Métricas |
Configuración de métricas. En GKE, solo se recogen en el primer contenedor. En GDC air-gapped, se usa junto con la sección Observabilidad para configurar el comportamiento de la plataforma Observabilidad. |
logging Registro |
|
alerting Alertas |
|
dashboards Paneles de control |
PostgresConfig
PostgresConfig define los ajustes de configuración de destino pertinentes para una base de datos de PostgreSQL.
Aparece en: - Base de datos
| Campo | Descripción |
|---|---|
version cadena |
Requisitos previos
Prerequisites configura los requisitos previos del microservicio.
Aparece en: - MicroserviceSpec
| Campo | Descripción |
|---|---|
sql booleano |
Configuración de SQL, si la carga de trabajo de destino lo requiere |
PrometheusMetrics
PrometheusMetrics configura las métricas de Prometheus expuestas por un pod.
Aparece en: - Métricas
| Campo | Descripción |
|---|---|
path cadena |
La ruta URI de las métricas de las que se extraerán las métricas. El valor predeterminado es /metrics. |
port entero |
Puerto del que se obtienen las métricas. El valor predeterminado es 80. |