REST Resource: projects.locations.customTargetTypes

리소스: CustomTargetType

Cloud Deploy API의 CustomTargetType 리소스입니다.

CustomTargetType은 지원되는 런타임 외에도 기타 시스템에 대한 배포를 촉진하기 위해 Target에서 참조할 수 있는 커스텀 타겟 유형을 정의합니다.

JSON 표현
{
  "name": string,
  "customTargetTypeId": string,
  "uid": string,
  "description": string,
  "annotations": {
    string: string,
    ...
  },
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,

  // Union field definition can be only one of the following:
  "customActions": {
    object (CustomTargetSkaffoldActions)
  }
  // End of list of possible types for union field definition.
}
필드
name

string

선택사항. CustomTargetType의 이름입니다. 형식은 projects/{project}/locations/{location}/customTargetTypes/{customTargetType}입니다. customTargetType 구성요소가 [a-z]([a-z0-9-]{0,61}[a-z0-9])?와 일치해야 합니다.

customTargetTypeId

string

출력 전용입니다. CustomTargetType의 리소스 ID입니다.

uid

string

출력 전용입니다. CustomTargetType의 고유 식별자입니다.

description

string

선택사항. CustomTargetType에 대한 설명입니다. 최대 길이는 255자(영문 기준)입니다.

annotations

map (key: string, value: string)

선택사항. 사용자 주석입니다. 이러한 속성은 Cloud Deploy가 아닌 사용자만 설정하고 사용할 수 있습니다. 형식 및 크기 제한에 대한 자세한 내용은 https://google.aip.dev/128#annotations를 참조하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

labels

map (key: string, value: string)

선택사항. 라벨은 사용자와 Cloud Deploy가 모두 설정 및 사용할 수 있는 속성입니다. 라벨은 다음 제약조건을 충족해야 합니다.

  • 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용할 수 있습니다.
  • 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
  • 키는 소문자나 국제 문자로 시작해야 합니다.
  • 각 리소스는 최대 64개 라벨로 제한됩니다.

또한 키와 값 모두 128바이트 이하로 제한됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

createTime

string (Timestamp format)

출력 전용입니다. CustomTargetType이 생성된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. CustomTargetType이 업데이트된 최근 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

etag

string

선택사항. 이 체크섬은 다른 필드의 값을 기준으로 서버에서 계산되며, 처리 전 클라이언트에 최신 값이 적용되도록 업데이트 및 삭제 요청이 있을 때 전송될 수 있습니다.

통합 필드 definition. CustomTargetType 렌더러 및 배포자를 정의합니다. definition은 다음 중 하나일 수 있습니다.
customActions

object (CustomTargetSkaffoldActions)

Skaffold 커스텀 작업을 사용하여 CustomTargetType의 렌더링 및 배포를 구성합니다.

CustomTargetSkaffoldActions

CustomTargetSkaffoldActions는 Skaffold 커스텀 작업을 사용한 CustomTargetType 구성을 나타냅니다.

JSON 표현
{
  "renderAction": string,
  "deployAction": string,
  "includeSkaffoldModules": [
    {
      object (SkaffoldModules)
    }
  ]
}
필드
renderAction

string

선택사항. 렌더링 작업을 책임지는 Skaffold 커스텀 작업입니다. 제공하지 않으면 Cloud Deploy가 skaffold render를 통해 렌더링 작업을 수행합니다.

deployAction

string

필수. 배포 작업을 책임지는 Skaffold 커스텀 작업입니다.

includeSkaffoldModules[]

object (SkaffoldModules)

선택사항. 진단을 수행하기 전 필요에 따라 Skaffold 구성에서 Cloud Deploy에 포함되는 Skaffold 모듈 목록입니다.

SkaffoldModules

Skaffold 구성 모듈과 원격 소스입니다.

JSON 표현
{
  "configs": [
    string
  ],

  // Union field source can be only one of the following:
  "git": {
    object (SkaffoldGitSource)
  },
  "googleCloudStorage": {
    object (SkaffoldGCSSource)
  },
  "googleCloudBuildRepo": {
    object (SkaffoldGCBRepoSource)
  }
  // End of list of possible types for union field source.
}
필드
configs[]

string

선택사항. 지정된 소스에서 사용할 Skaffold 구성 모듈입니다.

통합 필드 source. Skaffold 구성 모듈을 포함하는 소스입니다. source는 다음 중 하나여야 합니다.
git

object (SkaffoldGitSource)

Skaffold 구성 모듈을 포함하는 원격 git 저장소입니다.

googleCloudStorage

object (SkaffoldGCSSource)

Skaffold 구성 모듈을 포함하는 Cloud Storage 버킷입니다.

googleCloudBuildRepo

object (SkaffoldGCBRepoSource)

Skaffold 구성 모듈을 포함하는 Cloud Build V2 저장소입니다.

SkaffoldGitSource

Skaffold 구성 모듈을 포함하는 Git 저장소입니다.

JSON 표현
{
  "repo": string,
  "path": string,
  "ref": string
}
필드
repo

string

필수. 패키지를 클론해야 하는 Git 저장소입니다.

path

string

선택사항. 저장소 루트에서 Skaffold 파일에 대한 상대 경로입니다.

ref

string

선택사항. 저장소를 클론할 때 사용할 Git 브랜치 또는 태그입니다.

SkaffoldGCSSource

Skaffold 구성 모듈을 포함하는 Cloud Storage 버킷입니다.

JSON 표현
{
  "source": string,
  "path": string
}
필드
source

string

필수. 재귀적으로 복사할 Cloud Storage 소스 경로입니다. 예를 들어 "gs://my-bucket/dir/configs/*"를 제공하면 "my-bucket" 버킷의 "dir/configs" 디렉터리 내에 있는 모든 파일이 Skaffold에서 복사됩니다

path

string

선택사항. 소스에서 Skaffold 파일에 대한 상대 경로입니다.

SkaffoldGCBRepoSource

Skaffold 구성을 포함하는 Cloud Build V2 저장소입니다.

JSON 표현
{
  "repository": string,
  "path": string,
  "ref": string
}
필드
repository

string

필수. Cloud Build V2 저장소의 이름입니다. 형식은 projects/{project}/locations/{location}/connections/{connection}/repositories/{repository}입니다.

path

string

선택사항. 저장소 루트에서 Skaffold 구성 파일에 대한 상대 경로입니다.

ref

string

선택사항. 저장소를 클론할 때 사용할 브랜치 또는 태그입니다.

메서드

create

특정 프로젝트 및 위치에 새 CustomTargetType을 만듭니다.

delete

단일 CustomTargetType을 삭제합니다.

get

단일 CustomTargetType의 세부정보를 가져옵니다.

getIamPolicy

리소스의 액세스 제어 정책을 가져옵니다.

list

특정 프로젝트 및 위치의 CustomTargetType을 나열합니다.

patch

단일 CustomTargetType을 업데이트합니다.

setIamPolicy

지정된 리소스의 액세스 제어 정책을 설정합니다.