개요
선행 학습된 API는 광학 문자 인식 (OCR), 음성 텍스트 변환, 번역을 포함하는 AI 서비스 모음입니다. 서비스는 Kubernetes 리소스 모델 (KRM) API를 사용하여 사용 설정 및 중지됩니다. KRM API는 AI Platform 관리자가 선택적으로 사용하는 관리 API입니다.
이 페이지의 목적은 정보 제공에만 있습니다.
aiplatform.private.gdc.goog/v1
v1 패키지에는 aiplatform.private.gdc.goog v1 API 그룹의 API 스키마 정의가 포함되어 있습니다.
알림
알림에는 처리되어 관측 가능성 플랫폼 알림 CR인 MonitoringRule 및 LoggingRule로 변환될 ConfigMap의 이름이 포함됩니다.
표시 위치: - 관측 가능성
| 필드 | 설명 |
|---|---|
monitoringAlertsConfigMap 문자열 |
원격 K8s 클러스터에서 가져와 관측 가능성 플랫폼 MonitoringRule CR로 변환하여 관리자 클러스터에 배포하기 위해 MonitoringRule CR이 삽입된 Configmap입니다. |
loggingAlertsConfigMap 문자열 |
원격 K8s 클러스터에서 가져오고 관측 가능성 플랫폼 LoggingRule CR로 변환하여 처리하고 관리자 클러스터에 배포하기 위해 LoggingRule CR이 삽입된 ConfigMap |
AppConfig
AppConfig는 AppConfig API의 스키마입니다. 네임스페이스당 하나씩 있어야 합니다.
표시 위치: - AppConfigList
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
aiplatform.private.gdc.goog/v1 |
kind 문자열 |
AppConfig |
metadata ObjectMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
spec AppConfigSpec |
|
status AppConfigStatus |
AppConfigList
AppConfigList에는 AppConfig 목록이 포함됩니다.
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
aiplatform.private.gdc.goog/v1 |
kind 문자열 |
AppConfigList |
metadata ListMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
items AppConfig 배열 |
AppConfigSpec
표시 위치: - AppConfig
| 필드 | 설명 |
|---|---|
sql 데이터베이스 |
AppConfigStatus
AppConfigStatus는 AppConfig의 관찰된 상태를 정의합니다.
표시 위치: - AppConfig
| 필드 | 설명 |
|---|---|
ready 불리언 |
Ready는 리소스가 준비 상태인지 여부를 나타냅니다. |
primaryCondition ResourceCondition |
PrimaryCondition은 리소스의 기본 조건을 나타냅니다. 리소스가 준비되면 조건에 리소스가 준비되었다고 표시됩니다. 그렇지 않으면 조건이 리소스가 준비되지 않은 기본 이유가 됩니다. |
resourceConditions ResourceCondition 배열 |
ResourceConditions는 리소스와 하위 리소스의 조건 모음입니다. 이를 사용하여 리소스와 하위 리소스의 전반적인 상태를 확인할 수 있습니다. |
conditions Condition 배열 |
Conditions는 디버깅 목적으로 Kubernetes 리소스에서 채워진 원시 리소스 조건을 나타냅니다. |
database DatabaseInfo |
데이터베이스 하위 리소스 정보를 표시합니다. |
대시보드
대시보드에는 처리할 관측 가능성 플랫폼-대시보드 호환 configmap의 이름 목록이 포함됩니다.
표시 위치: - 관측 가능성
| 필드 | 설명 |
|---|---|
configMaps 문자열 배열 |
처리할 ConfigMap (삽입된 Grafana 대시보드 json 정의 포함)입니다. 이러한 ConfigMap은 AI 워크로드가 배포된 사용자 클러스터 및 네임스페이스에 있어야 합니다. 원하는 대시보드 수와 대시보드 configmap 간에 1:1 매핑이 있어야 합니다. configmap에는 대시보드 정의 json 문자열을 포함하는 'data'라는 단일 키가 있다고 가정합니다. |
데이터베이스
데이터베이스는 타겟 마이크로서비스의 관계형 DB 요구사항을 구성합니다.
표시 위치: - AppConfigSpec
| 필드 | 설명 |
|---|---|
postgres PostgresConfig |
DatabaseInfo
DatabaseInfo는 관찰된 데이터베이스 정보의 상태를 정의합니다.
표시 위치: - AppConfigStatus
| 필드 | 설명 |
|---|---|
endpoint 문자열 |
|
port 문자열 |
HPAStatus
HPAStatus는 HorizontalPodAutoscaler의 상태 조건을 설명합니다.
표시 위치: - MicroserviceStatus
| 필드 | 설명 |
|---|---|
statusConditions HorizontalPodAutoscalerCondition 배열 |
상태 조건 |
currentReplicas 정수 |
HPA에서 관리하는 현재 복제본 수 |
desiredReplicas 정수 |
HPA에서 관리하는 원하는 복제본 수 |
로깅
로깅은 GDC 오프라인 환경에서 관측 가능성 플랫폼의 로그 수집 기능을 구성합니다 (GKE에서 테스트하는 경우 사용 설정하지 마세요. 이 기능은 GKE에는 적용되지 않음).
표시 위치: - 관측 가능성
| 필드 | 설명 |
|---|---|
enableLogCollection 불리언 |
EnableLogCollection은 관측 가능성 플랫폼을 통해 로그 수집을 사용 설정할지 여부를 나타냅니다. |
staticLabels 객체 (키:문자열, 값:문자열) |
OP LoggingTargetCR의 'additionalLabels' 속성에 매핑됩니다. 캡처된 모든 로그 항목에 추가할 정적 라벨입니다. 라벨 이름에는 대시 ('-')가 포함되어서는 안 되지만 라벨 값에는 대시가 포함될 수 있습니다. |
측정항목
측정항목은 포드의 측정항목이 수집되는 방식을 구성합니다.
표시 위치: - 관측 가능성
| 필드 | 설명 |
|---|---|
prometheus PrometheusMetrics |
마이크로서비스
Microservice는 서비스 API의 스키마입니다.
표시 위치: - MicroserviceList
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
aiplatform.private.gdc.goog/v1 |
kind 문자열 |
Microservice |
metadata ObjectMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
spec MicroserviceSpec |
|
status MicroserviceStatus |
MicroserviceList
MicroserviceList에는 Microservice 목록이 포함됩니다.
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
aiplatform.private.gdc.goog/v1 |
kind 문자열 |
MicroserviceList |
metadata ListMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
items Microservice 배열 |
MicroserviceSpec
MicroserviceSpec은 원하는 마이크로서비스 상태를 정의합니다.
표시 위치: - Microservice
| 필드 | 설명 |
|---|---|
public 불리언 |
이 마이크로서비스가 공개인지 여부입니다. true인 경우 DNS 레코드와 공개 엔드포인트가 노출됩니다. DNS 이름에 따라 게이트웨이에도 TLS가 자동으로 설정됩니다. DNS 접두사는 메타데이터의 마이크로서비스 이름이 됩니다. |
enableBucketAccess 불리언 |
컨테이너에 스토리지 버킷 관련 구성을 프로비저닝할지 여부입니다. |
dnsname 문자열 |
DNS 호스트 이름입니다. 마이크로서비스가 공개된 경우 GDC 환경에서 마이크로서비스의 DNS 호스트 이름을 구성하는 데 사용됩니다. |
autoscaling |
자동 확장 구성입니다. |
observability 관측 가능성 |
관측 가능성 (로깅, 측정항목, 모니터링, 대시보드) 구성 (일부는 GDC 오프라인 구성에만 적용됨) |
prerequisites 기본 요건 |
기본 요건 구성입니다. |
template PodTemplateSpec |
마이크로서비스에서 포드를 만드는 템플릿입니다. 마이크로서비스에는 이러한 포드의 스테이트리스(Stateless) 배포가 포함됩니다. |
PodSpec
PodSpec은 핵심 PodSpec의 최소 버전입니다.
표시 위치: - PodTemplateSpec
| 필드 | 설명 |
|---|---|
containers 컨테이너 배열 |
컨테이너를 지정합니다. 일부 속성은 지원되지 않습니다. 모든 컨테이너에서 지정된 포트가 노출됩니다. 첫 번째 컨테이너 (containers[0])는 기본 컨테이너로 간주되며 노드 자동 프로비저닝을 위한 리소스 요청으로 태그됩니다. 나머지 컨테이너는 보조 컨테이너 (예: 사이드카)로 간주됩니다. |
nodeSelector 객체 (키:문자열, 값:문자열) |
NodeSelector는 포드가 노드에 적합하려면 참이어야 하는 선택기입니다. 포드가 해당 노드에 예약되려면 노드의 라벨과 일치해야 하는 선택기입니다. |
volumes 볼륨 배열 |
포드에 마운트될 볼륨 목록 |
initContainers 컨테이너 배열 |
포드에 속하는 초기화 컨테이너 목록입니다. init 컨테이너는 컨테이너가 시작되기 전에 순서대로 실행됩니다. 초기화 컨테이너가 실패하면 포드가 실패한 것으로 간주되고 restartPolicy에 따라 처리됩니다. init 컨테이너 또는 일반 컨테이너의 이름은 모든 컨테이너 중에서 고유해야 합니다. 이 설정은 업데이트할 수 없습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/를 참고하세요. |
tolerations Toleration 배열 |
지정된 경우 포드의 톨러레이션입니다. |
serviceAccount 문자열 |
포드에서 사용할 사전 생성된 Kubernetes 서비스 계정입니다. |
PodTemplateSpec
PodTemplateSpec은 PodSpec 및 잠재적으로 메타데이터 사양의 컨테이너 객체입니다.
표시 위치: - Microservice
| 필드 | 설명 |
|---|---|
metadata ObjectMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
spec PodSpec |
MicroserviceStatus
MicroserviceStatus는 관찰된 Microservice 상태를 정의합니다.
표시 위치: - Microservice
| 필드 | 설명 |
|---|---|
observedGeneration 정수 |
배포 컨트롤러에서 모니터링한 생성입니다. |
endpoint 문자열 |
이 마이크로서비스에 액세스할 수 있는 엔드포인트입니다. 공개 서비스에만 채워집니다. |
deploymentStatus DeploymentStatus |
이 마이크로서비스의 배포 상태입니다. |
hpaStatus HPAStatus |
HorizontalPodAutoscaler의 상태입니다. |
ready 불리언 |
전반적인 마이크로서비스 준비 상태 |
conditions Condition 배열 |
마이크로서비스의 현재 상태에 대한 최근 관찰 결과를 나타냅니다. |
관측 가능성
관측 가능성은 관측 가능성 플랫폼 (GDC 에어갭) 또는 측정항목 노출 (GKE)에 필요한 다양한 구성요소와 매개변수를 구성합니다.
표시 위치: - MicroserviceSpec
| 필드 | 설명 |
|---|---|
metrics 측정항목 |
측정항목 구성입니다. GKE에서는 첫 번째 컨테이너에서만 수집됩니다. GDC 오프라인에서는 관측 가능성 플랫폼의 동작을 구성하기 위해 관측 가능성 섹션과 함께 사용됩니다. |
logging 로깅 |
|
alerting 알림 |
|
dashboards 대시보드 |
PostgresConfig
PostgresConfig는 Postgres DB의 관련 타겟 구성 설정을 정의합니다.
표시 위치: - 데이터베이스
| 필드 | 설명 |
|---|---|
version 문자열 |
기본 요건
Prerequisites는 마이크로서비스의 모든 기본 요건을 구성합니다.
표시 위치: - MicroserviceSpec
| 필드 | 설명 |
|---|---|
sql 불리언 |
타겟 워크로드에 필요한 경우 SQL 구성 |
PrometheusMetrics
PrometheusMetrics는 포드에서 노출하는 Prometheus 측정항목을 구성합니다.
표시 위치: - 측정항목
| 필드 | 설명 |
|---|---|
path 문자열 |
측정항목을 스크레이핑할 측정항목 URI 경로입니다. 기본값은 /metrics입니다. |
port 정수 |
측정항목을 스크래핑할 포트입니다. 기본값은 80입니다. |