- Recurso: versão
- BuildArtifact
- RenderState
- TargetArtifact
- PhaseArtifact
- TargetRender
- TargetRenderState
- RenderMetadata
- CloudRunRenderMetadata
- FailureCause
- ReleaseCondition
- ReleaseReadyCondition (link em inglês)
- SkaffoldSupportedCondition
- SkaffoldSupportState
- Métodos
Recurso: Release
Um recurso Release
na API Cloud Deploy.
Um Release
define uma instância de configuração específica do Skaffold que pode ser implantada.
Representação JSON |
---|
{ "name": string, "uid": string, "description": string, "annotations": { string: string, ... }, "labels": { string: string, ... }, "abandoned": boolean, "createTime": string, "renderStartTime": string, "renderEndTime": string, "skaffoldConfigUri": string, "skaffoldConfigPath": string, "buildArtifacts": [ { object ( |
Campos | |
---|---|
name |
Opcional. Nome da |
uid |
Apenas saída. Identificador exclusivo do |
description |
Descrição do |
annotations |
Anotações do usuário. Esses atributos só podem ser definidos e usados pelo usuário, e não pelo Cloud Deploy. Consulte https://google.aip.dev/128#annotations para ver mais detalhes sobre limitações de formato e tamanho. Um objeto com uma lista de pares |
labels |
Rótulos são atributos que podem ser definidos e usados pelo usuário e pelo Cloud Deploy. Os rótulos precisam atender às seguintes restrições:
As chaves e os valores são restritos a <= 128 bytes. Um objeto com uma lista de pares |
abandoned |
Apenas saída. Indica se esta é uma versão abandonada. |
createTime |
Apenas saída. Horário em que o Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
renderStartTime |
Apenas saída. Horário em que a renderização começou. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
renderEndTime |
Apenas saída. Horário em que a renderização foi concluída. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
skaffoldConfigUri |
URI do Cloud Storage do arquivo tar.gz contendo a configuração do Skaffold. |
skaffoldConfigPath |
Caminho de arquivo da configuração do Skaffold dentro do URI de configuração. |
buildArtifacts[] |
Lista de artefatos para transmitir ao comando do Skaffold. |
deliveryPipelineSnapshot |
Apenas saída. Snapshot do pipeline pai capturado no momento da criação da versão. |
targetSnapshots[] |
Apenas saída. Snapshot dos destinos no momento da criação da versão. |
customTargetTypeSnapshots[] |
Apenas saída. Snapshot dos tipos de segmentações personalizadas referenciadas pelos destinos no momento da criação da versão. |
renderState |
Apenas saída. Estado atual da operação de renderização. |
etag |
Essa soma de verificação é calculada pelo servidor com base no valor de outros campos e pode ser enviada em solicitações de atualização e exclusão para garantir que o cliente tenha um valor atualizado antes de continuar. |
skaffoldVersion |
A versão do Skaffold a ser usada ao operar nesta versão, como "1.20.0". Nem todas as versões são válidas. O Cloud Deploy oferece suporte a um conjunto específico de versões. Se ela for deixada sem definição, a versão compatível mais recente do Skaffold será usada. |
targetArtifacts |
Apenas saída. Mapeie do ID de destino para os artefatos de destino criados durante a operação de renderização. Um objeto com uma lista de pares |
targetRenders |
Apenas saída. Mapeie do ID do destino para os detalhes da operação de renderização desse destino. Um objeto com uma lista de pares |
condition |
Apenas saída. Informações sobre o estado do lançamento. |
deployParameters |
Opcional. Os parâmetros de implantação a serem usados para todos os destinos nesta versão. Um objeto com uma lista de pares |
BuildArtifact
Descrição de uma imagem a ser usada durante a renderização do Skaffold.
Representação JSON |
---|
{ "image": string, "tag": string } |
Campos | |
---|---|
image |
Nome da imagem na configuração do Skaffold. |
tag |
Tag de imagem a ser usada. Geralmente, será o caminho completo para uma imagem, como "gcr.io/my-project/novembro" ou "gcr.io/my-project/deprecationbox@sha256:abc123" em um arquivo. |
RenderState
Estados válidos da operação de renderização.
Tipos enumerados | |
---|---|
RENDER_STATE_UNSPECIFIED |
O estado de renderização não foi especificado. |
SUCCEEDED |
Todas as operações de renderização foram concluídas com êxito. |
FAILED |
Todas as operações de renderização foram concluídas, e uma ou mais falharam. |
IN_PROGRESS |
A renderização foi iniciada e não foi concluída. |
TargetArtifact
Os artefatos produzidos por uma operação de renderização de destino.
Representação JSON |
---|
{ "skaffoldConfigPath": string, "manifestPath": string, "phaseArtifacts": { string: { object ( |
Campos | |
---|---|
skaffoldConfigPath |
Apenas saída. Caminho do arquivo da configuração do Skaffold resolvida em relação ao URI. |
manifestPath |
Apenas saída. Caminho do arquivo do manifesto renderizado relativo ao URI. |
phaseArtifacts |
Apenas saída. Mapeie o ID da fase para os artefatos de fase do Um objeto com uma lista de pares |
Campo de união
|
|
artifactUri |
Apenas saída. URI de um diretório que contém os artefatos. Ele contém a configuração de implantação usada pelo Skaffold durante um lançamento, e todos os caminhos são relativos a esse local. |
PhaseArtifact
Contém os caminhos para os artefatos, relativos ao URI, de uma fase.
Representação JSON |
---|
{ "skaffoldConfigPath": string, "manifestPath": string, "jobManifestsPath": string } |
Campos | |
---|---|
skaffoldConfigPath |
Apenas saída. Caminho do arquivo da configuração do Skaffold resolvida em relação ao URI. |
manifestPath |
Apenas saída. Caminho do arquivo do manifesto renderizado relativo ao URI. |
jobManifestsPath |
Apenas saída. Caminho do arquivo do diretório de manifestos de jobs renderizados relativos ao URI. Isso só é definido se for aplicável. |
TargetRender
Detalhes da renderização para um único destino.
Representação JSON |
---|
{ "renderingBuild": string, "renderingState": enum ( |
Campos | |
---|---|
renderingBuild |
Apenas saída. O nome do recurso do objeto |
renderingState |
Apenas saída. Estado atual da operação de renderização para este destino. |
metadata |
Apenas saída. Os metadados relacionados ao |
failureCause |
Apenas saída. Motivo da falha na renderização. Ele sempre não será especificado enquanto a renderização estiver em andamento. |
failureMessage |
Apenas saída. Informações adicionais sobre a falha de renderização, se disponíveis. |
TargetRenderState
Estados válidos da operação de renderização.
Tipos enumerados | |
---|---|
TARGET_RENDER_STATE_UNSPECIFIED |
O estado da operação de renderização não foi especificado. |
SUCCEEDED |
A operação de renderização foi concluída. |
FAILED |
Falha na operação de renderização. |
IN_PROGRESS |
A operação de renderização está em andamento. |
RenderMetadata
RenderMetadata inclui informações associadas a uma renderização Release
.
Representação JSON |
---|
{ "cloudRun": { object ( |
Campos | |
---|---|
cloudRun |
Apenas saída. Metadados associados à renderização do Cloud Run. |
custom |
Apenas saída. Metadados personalizados fornecidos por operação de renderização definida pelo usuário. |
CloudRunRenderMetadata
CloudRunRenderMetadata contém informações do Cloud Run associadas a uma renderização Release
.
Representação JSON |
---|
{ "service": string } |
Campos | |
---|---|
service |
Apenas saída. O nome do serviço do Cloud Run no manifesto renderizado. O formato é |
FailureCause
Falhas de renderização conhecidas.
Tipos enumerados | |
---|---|
FAILURE_CAUSE_UNSPECIFIED |
Nenhum motivo para a falha foi especificado. |
CLOUD_BUILD_UNAVAILABLE |
O Cloud Build não está disponível porque não está ativado ou porque o Cloud Deploy não tem permissões suficientes. Consulte a permissão necessária. |
EXECUTION_FAILED |
A operação de renderização não foi concluída. Verifique os registros do Cloud Build. |
CLOUD_BUILD_REQUEST_FAILED |
O Cloud Build falhou ao atender à solicitação do Cloud Deploy. Consulte failedMessage para mais detalhes. |
VERIFICATION_CONFIG_NOT_FOUND |
A operação de renderização não foi concluída porque a estrofe de verificação necessária para verificação não foi encontrada na configuração do Skaffold. |
CUSTOM_ACTION_NOT_FOUND |
A operação de renderização não foi concluída porque a ação personalizada necessária para pré ou pós-implantação não foi encontrada na configuração do Skaffold. Consulte failedMessage para mais detalhes. |
DEPLOYMENT_STRATEGY_NOT_SUPPORTED |
A versão falhou durante a renderização porque a configuração de versão não é compatível com a estratégia de implantação especificada. |
RENDER_FEATURE_NOT_SUPPORTED |
A operação de renderização teve um recurso configurado que não é compatível. |
ReleaseCondition
ReleaseCondition contém todas as condições relevantes para um Release.
Representação JSON |
---|
{ "releaseReadyCondition": { object ( |
Campos | |
---|---|
releaseReadyCondition |
Detalhes sobre o status geral dos lançamentos. |
skaffoldSupportedCondition |
Detalhes sobre o estado de suporte da versão de lançamento do Skaffold. |
ReleaseReadyCondition
ReleaseReadyCondition contém informações sobre o status do Release. Se uma versão não estiver pronta, não será possível criar um lançamento com ela.
Representação JSON |
---|
{ "status": boolean } |
Campos | |
---|---|
status |
Verdadeiro se o lançamento estiver em um estado válido. Caso contrário, pelo menos uma condição em |
SkaffoldSupportedCondition
SkaffoldSupportedCondition contém informações sobre quando termina o suporte para a versão de lançamento do Skaffold.
Representação JSON |
---|
{
"status": boolean,
"skaffoldSupportState": enum ( |
Campos | |
---|---|
status |
Verdadeiro se a versão do Skaffold usada por esta versão for compatível. |
skaffoldSupportState |
O estado de suporte do Skaffold para esta versão do Skaffold. |
maintenanceModeTime |
A hora em que a versão do Skaffold desta versão entrará no modo de manutenção. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
supportExpirationTime |
A hora em que esta versão do Skaffold não terá mais suporte. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
SkaffoldSupportState
O estado de suporte de uma versão específica do Skaffold.
Tipos enumerados | |
---|---|
SKAFFOLD_SUPPORT_STATE_UNSPECIFIED |
Valor padrão. Esse valor não é usado. |
SKAFFOLD_SUPPORT_STATE_SUPPORTED |
Esta versão do Skaffold é compatível atualmente. |
SKAFFOLD_SUPPORT_STATE_MAINTENANCE_MODE |
Esta versão do Skaffold está em modo de manutenção. |
SKAFFOLD_SUPPORT_STATE_UNSUPPORTED |
Esta versão do Skaffold não é mais suportada. |
Métodos |
|
---|---|
|
Abandona uma versão no pipeline de entrega. |
|
Cria um novo lançamento em um determinado projeto e local. |
|
Recebe detalhes de um único Release. |
|
Lista os lançamentos em um determinado projeto e local. |