Vista geral
As APIs pré-formadas são uma coleção de serviços de IA que incluem o reconhecimento ótico de carateres (OCR), a conversão de voz em texto e a tradução. Os serviços são ativados e desativados através da API Kubernetes Resource Model (KRM). A API KRM é uma API de gestão usada opcionalmente pelo administrador da AI Platform.
O objetivo desta página é apenas fornecer informações.
aiplatform.private.gdc.goog/v1
O pacote v1 contém definições do esquema da API para o grupo de APIs aiplatform.private.gdc.goog v1
Alertas
O alerta contém os nomes dos ConfigMaps que vão ser processados e transformados em CRs de alerta da plataforma de observabilidade: MonitoringRule e LoggingRule.
Aparece em: - Observabilidade
| Campo | Descrição |
|---|---|
monitoringAlertsConfigMap string |
Configmap com CR MonitoringRule incorporado para obter do cluster K8s remoto e processar transformando-o num CR MonitoringRule da plataforma de observabilidade e implementá-lo no cluster de administrador. |
loggingAlertsConfigMap string |
ConfigMap com CR LoggingRule incorporado para obter do cluster K8s remoto e processar transformando-o num CR LoggingRule da plataforma de observabilidade e implementá-lo no cluster de administrador. |
AppConfig
O AppConfig é o esquema da API AppConfig. Deve ter um por espaço de nomes
Aparece em: - AppConfigList
| Campo | Descrição |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
AppConfig |
metadata ObjectMeta |
Consulte a documentação da API Kubernetes para os campos de metadata. |
spec AppConfigSpec |
|
status AppConfigStatus |
AppConfigList
AppConfigList contém uma lista de AppConfig
| Campo | Descrição |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
AppConfigList |
metadata ListMeta |
Consulte a documentação da API Kubernetes para os campos de metadata. |
items AppConfig |
AppConfigSpec
Aparece em: - AppConfig
| Campo | Descrição |
|---|---|
sql Base de dados |
AppConfigStatus
AppConfigStatus define o estado observado de AppConfig.
Aparece em: - AppConfig
| Campo | Descrição |
|---|---|
ready booleano |
O parâmetro pronto indica se o recurso está num estado pronto. |
primaryCondition ResourceCondition |
PrimaryCondition representa a condição principal de um recurso. Se o recurso estiver pronto, a condição indica que o recurso está pronto. Caso contrário, a condição é o motivo principal pelo qual o recurso não está pronto. |
resourceConditions ResourceCondition |
ResourceConditions é uma coleção de condições para um recurso e os respetivos sub-recursos. Pode ser usado para determinar o estado geral de um recurso e dos respetivos sub-recursos. |
conditions Matriz de condições |
Conditions representa as condições de recursos não processados preenchidas a partir de recursos do Kubernetes para fins de depuração. |
database DatabaseInfo |
Apresenta as informações do subrecurso Database. |
Painéis de controlo
Dashboards contém uma lista dos nomes dos configmaps compatíveis com o painel de controlo da plataforma de observabilidade a serem processados.
Aparece em: - Observabilidade
| Campo | Descrição |
|---|---|
configMaps matriz de strings |
ConfigMaps (com a definição JSON do painel de controlo do Grafana incorporada) a serem processados; espera-se que estes existam no cluster de utilizadores e no espaço de nomes para o qual as cargas de trabalho de IA são implementadas. Deve existir um mapeamento de 1:1 entre o número de painéis de controlo desejados e os configmaps dos painéis de controlo. Presumimos que existe uma única chave no configmap: "data", que vai alojar a string JSON de definição do painel de controlo. |
Bases de dados
A base de dados configura os requisitos da base de dados relacional para o microsserviço de destino.
Aparece em: - AppConfigSpec
| Campo | Descrição |
|---|---|
postgres PostgresConfig |
DatabaseInfo
DatabaseInfo define o estado observado das informações da base de dados.
Aparece em: - AppConfigStatus
| Campo | Descrição |
|---|---|
endpoint string |
|
port string |
HPAStatus
HPAStatus descreve as condições de estado do HorizontalPodAutoscaler.
Aparece em: - MicroserviceStatus
| Campo | Descrição |
|---|---|
statusConditions HorizontalPodAutoscalerCondition |
Condições de estado |
currentReplicas número inteiro |
Número de réplicas atuais geridas pelo HPA |
desiredReplicas número inteiro |
Número de réplicas desejadas geridas pelo HPA |
Registo
O registo configura a funcionalidade de recolha de registos para a plataforma de observabilidade no GDC isolado (não ative se estiver a testar no GKE. Esta funcionalidade não se aplica aí).
Aparece em: - Observabilidade
| Campo | Descrição |
|---|---|
enableLogCollection booleano |
EnableLogCollection indica se a recolha de registos deve ou não ser ativada através da plataforma de observabilidade. |
staticLabels objeto (chaves:string, valores:string) |
Mapeado para a propriedade "additionalLabels" do OP LoggingTargetCR. Etiquetas estáticas a adicionar a todas as entradas de registo capturadas. Os nomes das etiquetas não podem conter travessões ("-"); os valores das etiquetas podem conter travessões. |
Métrica
Metrics configura a forma como as métricas de um pod são recolhidas.
Aparece em: - Observabilidade
| Campo | Descrição |
|---|---|
prometheus PrometheusMetrics |
Microserviço
O microsserviço é o esquema da API Services
Aparece em: - MicroserviceList
| Campo | Descrição |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
Microservice |
metadata ObjectMeta |
Consulte a documentação da API Kubernetes para os campos de metadata. |
spec MicroserviceSpec |
|
status MicroserviceStatus |
MicroserviceList
MicroserviceList contém uma lista de Microservice
| Campo | Descrição |
|---|---|
apiVersion string |
aiplatform.private.gdc.goog/v1 |
kind string |
MicroserviceList |
metadata ListMeta |
Consulte a documentação da API Kubernetes para os campos de metadata. |
items Matriz de microsserviços |
MicroserviceSpec
MicroserviceSpec define o estado pretendido do Microservice.
Aparece em: - Microsserviço
| Campo | Descrição |
|---|---|
public booleano |
Se este microsserviço é público. Se for verdadeiro, tem um registo DNS exposto, bem como um ponto final público. O TLS também é configurado automaticamente no gateway de acordo com o nome DNS. O prefixo DNS é o nome do microsserviço nos metadados. |
enableBucketAccess booleano |
Se deve aprovisionar as configurações relacionadas com o contentor de armazenamento para o contentor |
dnsname string |
Nome do anfitrião de DNS. Isto vai ser usado para construir o nome do anfitrião DNS para o microsserviço no ambiente GDC quando o microsserviço for público |
autoscaling |
Configurações de escalabilidade automática. |
observability Observabilidade |
Configuração da observabilidade (registo, métricas, monitorização e painéis de controlo) (algumas das quais são aplicáveis apenas a configurações isoladas do GDC). |
prerequisites Pré-requisitos |
Configuração dos pré-requisitos. |
template PodTemplateSpec |
Modelo para criar pods no microsserviço. O microsserviço vai conter implementações sem estado para estes agrupamentos. |
PodSpec
O PodSpec é uma versão minimalista do PodSpec principal.
Aparece em: - PodTemplateSpec
| Campo | Descrição |
|---|---|
containers Matriz de contentores |
Especifica contentores. Nem todos os atributos são suportados. As portas especificadas de todos os contentores vão ser expostas. O primeiro contentor (containers[0]) é considerado o contentor principal e é o que vai ser etiquetado com pedidos de recursos para o aprovisionamento automático de nós. Os restantes contentores são considerados auxiliares (por exemplo, sidecars). |
nodeSelector objeto (chaves:string, valores:string) |
NodeSelector é um seletor que tem de ser verdadeiro para que o pod se ajuste a um nó. Seletor que tem de corresponder às etiquetas de um nó para que o pod seja agendado nesse nó. |
volumes Conjunto de |
Lista de volumes que vão ser montados nos pods |
initContainers Matriz de contentores |
Lista de contentores de inicialização pertencentes ao pod. Os contentores init são executados por ordem antes do início dos contentores. Se um contentor de inicialização falhar, o pod é considerado como tendo falhado e é processado de acordo com a respetiva restartPolicy. O nome de um contentor de inicialização ou de um contentor normal tem de ser exclusivo entre todos os contentores. Não é possível atualizar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ |
tolerations Matriz de tolerância |
Se especificado, as tolerâncias do pod. |
serviceAccount string |
A conta de serviço do Kubernetes pré-criada que vai ser usada pelo pod. |
PodTemplateSpec
PodTemplateSpec é um objeto de contentor para PodSpec e, potencialmente, especificação de metadados.
Aparece em: - Microsserviço
| Campo | Descrição |
|---|---|
metadata ObjectMeta |
Consulte a documentação da API Kubernetes para os campos de metadata. |
spec PodSpec |
MicroserviceStatus
MicroserviceStatus define o estado observado do Microservice.
Aparece em: - Microsserviço
| Campo | Descrição |
|---|---|
observedGeneration número inteiro |
A geração observada pelo controlador de implementação. |
endpoint string |
O ponto final a partir do qual este microsserviço é acessível. Preenchido apenas para serviços públicos. |
deploymentStatus DeploymentStatus |
O estado de implementação deste microsserviço. |
hpaStatus HPAStatus |
O estado do HorizontalPodAutoscaler. |
ready booleano |
Estado de prontidão geral do microsserviço |
conditions Matriz de condições |
Representa as observações mais recentes disponíveis do estado atual de um microsserviço. |
Observabilidade
A capacidade de observação configura os vários componentes e parâmetros necessários pela plataforma de capacidade de observação (no GDC isolado) ou a exposição de métricas (no GKE).
Aparece em: - MicroserviceSpec
| Campo | Descrição |
|---|---|
metrics Métricas |
Configuração de métricas. No GKE, estes dados só são recolhidos no primeiro contentor. No GDC com isolamento de ar, isto é usado em conjunto com a secção Observability para configurar o comportamento da plataforma de observabilidade. |
logging Registo |
|
alerting Alertar |
|
dashboards Painéis de controlo |
PostgresConfig
PostgresConfig define as definições de configuração de destino relevantes para uma base de dados Postgres.
Aparece em: - Base de dados
| Campo | Descrição |
|---|---|
version string |
Pré-requisitos
Prerequisites configura todos os pré-requisitos para o microsserviço.
Aparece em: - MicroserviceSpec
| Campo | Descrição |
|---|---|
sql booleano |
Configuração de SQL, se for exigida pela carga de trabalho de destino |
PrometheusMetrics
PrometheusMetrics configura as métricas do Prometheus expostas por um pod.
Aparece em: - Métricas
| Campo | Descrição |
|---|---|
path string |
O caminho do URI das métricas a extrair. A predefinição é /metrics. |
port número inteiro |
A porta a partir da qual extrair métricas. A predefinição é 80. |