Resource: CustomTargetType
A CustomTargetType
resource in the Cloud Deploy API.
A CustomTargetType
defines a type of custom target that can be referenced in a Target
in order to facilitate deploying to other systems besides the supported runtimes.
JSON representation |
---|
{ "name" : string , "customTargetTypeId" : string , "uid" : string , "description" : string , "annotations" : { string : string , ... } , "labels" : { string : string , ... } , "createTime" : string , "updateTime" : string , "etag" : string , // Union field |
name
string
Identifier. Name of the CustomTargetType
. Format is projects/{project}/locations/{location}/customTargetTypes/{customTargetType}
. The customTargetType
component must match [a-z]([a-z0-9-]{0,61}[a-z0-9])?
customTargetTypeId
string
Output only. Resource id of the CustomTargetType
.
uid
string
Output only. Unique identifier of the CustomTargetType
.
description
string
Optional. Description of the CustomTargetType
. Max length is 255 characters.
annotations
map (key: string, value: string)
Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations.
An object containing a list of "key": value
pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }
.
labels
map (key: string, value: string)
Optional. Labels are attributes that can be set and used by both the user and by Cloud Deploy. Labels must meet the following constraints:
- Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes.
- All characters must use UTF-8 encoding, and international characters are allowed.
- Keys must start with a lowercase letter or international character.
- Each resource is limited to a maximum of 64 labels.
Both keys and values are additionally constrained to be <= 128 bytes.
An object containing a list of "key": value
pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }
.
createTime
string (
Timestamp
format)
Output only. Time at which the CustomTargetType
was created.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
or "2014-10-02T15:01:23+05:30"
.
updateTime
string (
Timestamp
format)
Output only. Most recent time at which the CustomTargetType
was updated.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
or "2014-10-02T15:01:23+05:30"
.
etag
string
Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
definition
. Defines the CustomTargetType
renderer and deployer. definition
can be only one of the following:customActions
object (
CustomTargetSkaffoldActions
)
Optional. Configures render and deploy for the CustomTargetType
using Skaffold custom actions.
CustomTargetSkaffoldActions
CustomTargetSkaffoldActions represents the CustomTargetType
configuration using Skaffold custom actions.
JSON representation |
---|
{
"renderAction"
:
string
,
"deployAction"
:
string
,
"includeSkaffoldModules"
:
[
{
object (
|
Fields | |
---|---|
renderAction
|
Optional. The Skaffold custom action responsible for render operations. If not provided then Cloud Deploy will perform the render operations via |
deployAction
|
Required. The Skaffold custom action responsible for deploy operations. |
includeSkaffoldModules[]
|
Optional. List of Skaffold modules Cloud Deploy will include in the Skaffold Config as required before performing diagnose. |
SkaffoldModules
Skaffold Config modules and their remote source.
JSON representation |
---|
{ "configs" : [ string ] , // Union field |
configs[]
string
Optional. The Skaffold Config modules to use from the specified source.
source
. The source that contains the Skaffold Config modules. source
can be only one of the following:git
object (
SkaffoldGitSource
)
Optional. Remote git repository containing the Skaffold Config modules.
googleCloudStorage
object (
SkaffoldGCSSource
)
Optional. Cloud Storage bucket containing the Skaffold Config modules.
googleCloudBuildRepo
object (
SkaffoldGCBRepoSource
)
Optional. Cloud Build V2 repository containing the Skaffold Config modules.
SkaffoldGitSource
Git repository containing Skaffold Config modules.
JSON representation |
---|
{ "repo" : string , "path" : string , "ref" : string } |
Fields | |
---|---|
repo
|
Required. Git repository the package should be cloned from. |
path
|
Optional. Relative path from the repository root to the Skaffold file. |
ref
|
Optional. Git branch or tag to use when cloning the repository. |
SkaffoldGCSSource
Cloud Storage bucket containing Skaffold Config modules.
JSON representation |
---|
{ "source" : string , "path" : string } |
Fields | |
---|---|
source
|
Required. Cloud Storage source paths to copy recursively. For example, providing "gs://my-bucket/dir/configs/*" will result in Skaffold copying all files within the "dir/configs" directory in the bucket "my-bucket". |
path
|
Optional. Relative path from the source to the Skaffold file. |
SkaffoldGCBRepoSource
Cloud Build V2 Repository containing Skaffold Configs.
JSON representation |
---|
{ "repository" : string , "path" : string , "ref" : string } |
Fields | |
---|---|
repository
|
Required. Name of the Cloud Build V2 Repository. Format is projects/{project}/locations/{location}/connections/{connection}/repositories/{repository}. |
path
|
Optional. Relative path from the repository root to the Skaffold Config file. |
ref
|
Optional. Branch or tag to use when cloning the repository. |
Methods |
|
---|---|
|
Creates a new CustomTargetType in a given project and location. |
|
Deletes a single CustomTargetType. |
|
Gets details of a single CustomTargetType. |
|
Gets the access control policy for a resource. |
|
Lists CustomTargetTypes in a given project and location. |
|
Updates a single CustomTargetType. |
|
Sets the access control policy on the specified resource. |