Descripción general
Las APIs previamente entrenadas son una colección de servicios de IA que incluyen el reconocimiento óptico de caracteres (OCR), Speech-to-Text y Translation. Los servicios se habilitan y se inhabilitan con la API del modelo de recursos de Kubernetes (KRM). La API de KRM es una API de administración que el administrador de AI Platform usa de forma opcional.
El propósito de esta página es solo brindar información.
aiplatform.private.gdc.goog/v1
El paquete v1 contiene definiciones de esquemas de API para el grupo de API de aiplatform.private.gdc.goog v1
Alertas
Alerting contiene los nombres de los ConfigMaps que se procesarán y transformarán en CR de alerta de la Plataforma de observabilidad: MonitoringRule y LoggingRule.
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
monitoringAlertsConfigMap string |
Configmap con CR de MonitoringRule integrada para recuperar del clúster de K8s remoto y procesar transformando en una CR de MonitoringRule de la plataforma de observabilidad y, luego, implementar en el clúster de administrador. |
loggingAlertsConfigMap string |
ConfigMap con CR de LoggingRule incorporado para recuperar del clúster de K8s remoto y procesar transformándolo en un CR de LoggingRule de la plataforma de observabilidad y, luego, implementarlo en el clúster de administrador. |
AppConfig
AppConfig es el esquema de la API de AppConfig. Debe haber uno por espacio de nombres
Aparece en: - AppConfigList
| Campo | Descripción |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
AppConfig |
metadata ObjectMeta |
Consulta la documentación de la API de Kubernetes para conocer los campos de metadata. |
spec AppConfigSpec |
|
status AppConfigStatus |
AppConfigList
AppConfigList contiene una lista de AppConfig
| Campo | Descripción |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
AppConfigList |
metadata ListMeta |
Consulta la documentación de la API de Kubernetes para conocer los campos de metadata. |
items arreglo de 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 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 Array de ResourceCondition |
ResourceConditions es una colección de condiciones para un recurso y sus subrecursos. Se puede usar para determinar el estado general de un recurso y sus subrecursos. |
conditions arreglo de condiciones |
Conditions representa las condiciones de recursos sin procesar propagadas desde los recursos de Kubernetes con fines de depuración. |
database DatabaseInfo |
Presenta la información del recurso secundario de la base de datos. |
Paneles
Dashboards contiene una lista de los nombres de los configmaps compatibles con el panel de la Plataforma de Observabilidad que se procesarán.
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
configMaps arreglo de strings |
Son los ConfigMaps (con la definición json del panel de Grafana incorporado) que se procesarán. Se espera que existan en el clúster de usuario y el espacio de nombres en los que se implementan las cargas de trabajo de IA. Debe haber una asignación 1:1 entre la cantidad de paneles deseados y los configmaps de paneles. Suponemos que habrá una sola clave en el configmap: "data", que contendrá la cadena json de la definición del panel. |
Base de datos
La base de datos configura los requisitos de la base de datos relacional para el 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 string |
|
port string |
HPAStatus
HPAStatus describe las condiciones de estado del HorizontalPodAutoscaler.
Aparece en: - MicroserviceStatus
| Campo | Descripción |
|---|---|
statusConditions HorizontalPodAutoscalerCondition array |
Condiciones de estado |
currentReplicas número entero |
Cantidad de réplicas actuales administradas por el HPA |
desiredReplicas número entero |
Cantidad de réplicas deseadas que administra el HPA |
Logging
Logging configura la funcionalidad de recopilación de registros para la Plataforma de observabilidad en GDC aislada (no habilites esta opción si realizas pruebas en GKE, ya que esta funcionalidad no se aplica allí).
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
enableLogCollection booleano |
EnableLogCollection indica si se debe habilitar la recopilación de registros a través de la Plataforma de Observabilidad. |
staticLabels objeto (claves:cadena, valores:cadena) |
Se asigna a la propiedad "additionalLabels" del CR LoggingTarget de OP. Son etiquetas estáticas que se agregan 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 recopilarán las métricas de un Pod.
Aparece en: - Observabilidad
| Campo | Descripción |
|---|---|
prometheus PrometheusMetrics |
Microservicio
Microservice es el esquema de la API de services
Aparece en: - MicroserviceList
| Campo | Descripción |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
Microservice |
metadata ObjectMeta |
Consulta la documentación de la API de Kubernetes para conocer los campos de metadata. |
spec MicroserviceSpec |
|
status MicroserviceStatus |
MicroserviceList
MicroserviceList contiene una lista de Microservice
| Campo | Descripción |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
MicroserviceList |
metadata ListMeta |
Consulta la documentación de la API de Kubernetes para conocer los campos de metadata. |
items Microservice array |
MicroserviceSpec
MicroserviceSpec define el estado deseado de Microservice.
Aparece en: - Microservice
| Campo | Descripción |
|---|---|
public booleano |
Indica si este microservicio es público. Si es verdadero, tendrá un registro DNS de exposición y un extremo público. El protocolo TLS también se configurará automáticamente en la puerta de enlace según el nombre de DNS. El prefijo de DNS será el nombre del microservicio en los metadatos. |
enableBucketAccess booleano |
Indica si se debe aprovisionar la configuración relacionada con el bucket de almacenamiento en el contenedor. |
dnsname string |
Nombre de host de DNS. Se usará para construir el nombre de host de DNS para el microservicio en el entorno de GDC cuando el microservicio sea público. |
autoscaling |
Son las configuraciones del ajuste de escala automático. |
observability Observabilidad |
Configuración de observabilidad (registros, métricas, supervisión y paneles) (algunos de los cuales solo se aplican a las configuraciones aisladas de GDC) |
prerequisites Requisitos previos |
Configuración de requisitos previos |
template PodTemplateSpec |
Es una 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 Matriz de contenedores |
Especifica contenedores. No todos los atributos son compatibles. 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 (p.ej.,sidecars). |
nodeSelector objeto (claves:cadena, valores:cadena) |
NodeSelector es un selector que debe ser verdadero para que el pod se ajuste a un nodo. Es el selector que debe coincidir con las etiquetas de un nodo para que el pod se programe en ese nodo. |
volumes Arreglo de volumen |
Lista de volúmenes que se activarán en los pods |
initContainers Matriz de contenedores |
Es la 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 de inicialización, se considera que el pod falló y se controla según su restartPolicy. El nombre de un contenedor de inicialización 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 arreglo de Toleration |
Si se especifica, son las tolerancias del pod. |
serviceAccount string |
Cuenta de servicio de Kubernetes creada previamente que usará el Pod. |
PodTemplateSpec
PodTemplateSpec es un objeto contenedor para PodSpec y, potencialmente, para la especificación de metadatos.
Aparece en: - Microservice
| Campo | Descripción |
|---|---|
metadata ObjectMeta |
Consulta la documentación de la API de Kubernetes para conocer los campos de metadata. |
spec PodSpec |
MicroserviceStatus
MicroserviceStatus define el estado observado de Microservice.
Aparece en: - Microservice
| Campo | Descripción |
|---|---|
observedGeneration número entero |
Es la generación que observa el controlador de la implementación. |
endpoint string |
Es el extremo desde el que se puede acceder a este microservicio. Solo se propaga para los servicios públicos. |
deploymentStatus DeploymentStatus |
Es el estado de implementación de este microservicio. |
hpaStatus HPAStatus |
Es el estado del HorizontalPodAutoscaler. |
ready booleano |
Estado general de preparación del microservicio |
conditions arreglo de condiciones |
Representa las últimas observaciones disponibles del estado actual de un microservicio. |
Observabilidad
La observabilidad configura los diversos componentes y parámetros que requiere la Plataforma de observabilidad (en GDC con aislamiento de aire) o la Exposición de métricas (en GKE).
Aparece en: - MicroserviceSpec
| Campo | Descripción |
|---|---|
metrics Métricas |
Es la configuración de las métricas. En GKE, estos datos solo se recopilan en el primer contenedor. En GDC aislado del aire, esto se usa junto con la sección Observability para configurar el comportamiento de la plataforma de Observability. |
logging Registro |
|
alerting Alertas |
|
dashboards Paneles |
PostgresConfig
PostgresConfig define la configuración de destino pertinente para una base de datos de Postgres.
Aparece en: - Base de datos
| Campo | Descripción |
|---|---|
version string |
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 que expone un Pod.
Aparece en: - Métricas
| Campo | Descripción |
|---|---|
path string |
Es la ruta de URI de las métricas desde las que se recopilan datos. La configuración predeterminada es /metrics. |
port número entero |
Es el puerto desde el que se recopilan las métricas. El valor predeterminado es 80. |