Como ver os resultados da criação

Nesta página explicamos como ver informações sobre suas criações do Cloud Build usando o Console do Google Cloud Platform, a ferramenta de linha de comando gcloud e a API Cloud Build.

Antes de começar

• Se quiser usar os exemplos de linha de comando neste guia, instale a ferramenta de linha de comandogcloud.

Como ver os resultados da criação

CONSOLE

No Console do GCP, o menu Histórico de criações pode mostrar informações sobre o status de uma criação (corretamente ou com falha), origem, resultados, horário de criação, imagens e muito mais.

Para ver o menu Histórico de criações:

1. Abra a página Histórico de criações no Console do Google Cloud Platform.

   Abrir a página "Histórico de criações"

   É exibida a página Histórico de criações, que mostra uma lista das suas versões recentes.

Para ver detalhes de uma criação específica:

1. Na página Histórico de criações, clique em uma criação específica.

   É exibida a página Detalhes da criação, que mostra os detalhes dessa criação, como Status, ID da criação etc.

gcloud

O comando gcloud builds list exibe todas as suas criações.

Para visualizar suas criações, execute este comando:

gcloud builds list

O resultado será semelhante a este:

ID                                    CREATE_TIME                DURATION  SOURCE                                                                                      IMAGES                                              STATUS
3a2055bc-ccbd-4101-9434-d376b88b8940  2018-02-16T18:33:26+00:00  23S       gs://gcb-docs-project_cloudbuild/source/1518806004.25-db1e250a7b7f496eb8242bfee5ac308e.tgz  gcr.io/gcb-docs-project/quickstart-image (+1 more)  SUCCESS
900704ca-7a0c-4569-ac08-884593c19aac  2018-02-16T18:32:32+00:00            gs://gcb-docs-project_cloudbuild/source/1518805951.23-03dd53d16f684c568fa2bb7ff7ebda06.tgz  -                                                   FAILURE
021f9ede-ddaa-4cfb-8988-60142b015ebd  2018-02-14T15:48:44+00:00  10S       gs://gcb-docs-project_cloudbuild/source/1518623322.56-9cd088ffc1e04f5aa6040728772d0c2a.tgz  -                                                   SUCCESS
8126d538-3c43-4304-a14c-33aceec8cb97  2018-02-14T15:46:13+00:00  10S       gs://gcb-docs-project_cloudbuild/source/1518623172.09-327c02585a4e44e782ac97dd80d5a5d5.tgz  gcr.io/gcb-docs-project/quickstart-image (+1 more)  SUCCESS

Para exibir detalhes de uma criação específica, execute o seguinte comando:

gcloud builds describe [BUILD_ID]

em que [BUILD_ID] é o ID da criação de que você quer detalhes.

O resultado será semelhante a este:

createTime: '2018-02-22T14:49:54.066666971Z'
finishTime: '2018-02-22T14:50:05.463758Z'
id: bcdb9c48-d92c-4489-a3cb-08d0f0795a0b
images:
- gcr.io/gcb-docs-project/quickstart-image
logUrl: https://console.cloud.google.com/gcr/builds/bcdb9c48-d92c-4489-a3cb-08d0f0795a0b?project=gcb-docs-project
logsBucket: gs://404889597380.cloudbuild-logs.googleusercontent.com
projectId: gcb-docs-project
results:
    buildStepImages:
    - sha256:a4363bc75a406c4f8c569b12acdd86ebcf18b6004b4f163e8e6293171462a79d
    images:
    - digest: sha256:1b2a237e74589167e4a54a8824f0d03d9f66d3c7d9cd172b36daa5ac42e94eb9
      name: gcr.io/gcb-docs-project/quickstart-image
      pushTiming:
          endTime: '2018-02-22T14:50:04.731919081Z'
          startTime: '2018-02-22T14:50:00.874058710Z'
      - digest: sha256:1b2a237e74589167e4a54a8824f0d03d9f66d3c7d9cd172b36daa5ac42e94eb9
        name: gcr.io/gcb-docs-project/quickstart-image:latest
        pushTiming:
            endTime: '2018-02-22T14:50:04.731919081Z'
            startTime: '2018-02-22T14:50:00.874058710Z'
source:
    storageSource:
        bucket: gcb-docs-project_cloudbuild
        generation: '1519310993665963'
        object: source/1519310992.2-8465b08c79e14e89bee09adc8203c163.tgz
sourceProvenance:
    fileHashes:
        gs://gcb-docs-project_cloudbuild/source/1519310992.2-8465b08c79e14e89bee09adc8203c163.tgz#1519310993665963:
        fileHash:
        - value: -aRYrWp2mtfKhHSyWn6KNQ==
    resolvedStorageSource:
        bucket: gcb-docs-project_cloudbuild
        generation: '1519310993665963'
        object: source/1519310992.2-8465b08c79e14e89bee09adc8203c163.tgz
startTime: '2018-02-22T14:49:54.966308841Z'
status: SUCCESS
steps:
- args:
  - build
  - --no-cache
  - -t
  - gcr.io/gcb-docs-project/quickstart-image
  - .
  name: gcr.io/cloud-builders/docker
  status: SUCCESS
  timing:
      endTime: '2018-02-22T14:50:00.813257422Z'
      startTime: '2018-02-22T14:50:00.102600442Z'
timeout: 600s
timing:
    BUILD:
        endTime: '2018-02-22T14:50:00.873604173Z'
        startTime: '2018-02-22T14:50:00.102589403Z'
    FETCHSOURCE:
        endTime: '2018-02-22T14:50:00.087286880Z'
        startTime: '2018-02-22T14:49:56.962717504Z'
    PUSH:
        endTime: '2018-02-22T14:50:04.731958202Z'
        startTime: '2018-02-22T14:50:00.874057159Z'

Status da etapa e da criação

Depois que uma criação for concluída, o Cloud Build fornecerá um conjunto status para a criação e status para cada etapa da criação individual.

A tabela a seguir resume os status de quando uma criação ou etapa é bem-sucedida, atinge o tempo limite ou falha:

Evento	Status da criação	Status da etapa
Criação bem-sucedida	SUCCESS	Todas as etapas estão marcadas como SUCCESS.
A criação falha	FAILURE	A etapa com falha é marcada como FAILED. Etapas que foram bem-sucedidas antes do término da criação são marcadas como SUCCESS. Etapas no meio da execução são marcadas como CANCELLED. As etapas não iniciadas são marcadas como QUEUED.
A criação é cancelada pelo usuário	CANCELLED	Etapas que foram bem-sucedidas antes do cancelamento da criação são marcadas como SUCCESS. Etapas no meio da execução são marcadas como CANCELLED. As etapas que não começaram a ser executadas são marcadas como QUEUED.
A criação foi encerrada	TIMEOUT	Etapas que foram bem-sucedidas antes do tempo-limite da criação são marcadas como SUCCESS. Etapas no meio da execução são marcadas como CANCELLED. As etapas que não começaram a ser executadas são marcadas como QUEUED.
Etapa expirada	FAILED	A etapa expirada está marcada como TIMEOUT. Etapas que tiveram sucesso antes da etapa expirada são marcadas como SUCCESS. Etapas no meio da execução são marcadas como CANCELLED. As etapas que não começaram a ser executadas são marcadas como QUEUED.

Para ver o status por etapa e de criação, execute o comando gcloud builds describe:

gcloud builds describe [BUILD_ID]

[BUILD_ID] é o código da criação.

O snippet a seguir mostra o status por etapa de uma criação com uma etapa com tempo limite atingido:

status: FAILURE
steps:
- args:
  - sleep
  - '60'
id: long sleep
name: alpine
status: CANCELLED
timing:
    endTime: '2018-02-26T14:09:18.531368493Z'
    startTime: '2018-02-26T14:09:11.023235026Z'
waitFor:
- '-'
- args:
- sleep
- '3'
id: shorty
name: alpine
status: SUCCESS
timeout: 60s
timing:
    endTime: '2018-02-26T14:09:15.497724138Z'
    startTime: '2018-02-26T14:09:11.023676903Z'
waitFor:
- '-'
- args:
  - sleep
  - '60'
name: alpine
status: TIMEOUT
timeout: 3s
timing:
    endTime: '2018-02-26T14:09:18.527488475Z'
    startTime: '2018-02-26T14:09:15.497736775Z'
waitFor:
- shorty
- args:
  - 'false'
name: alpine
status: QUEUED
waitFor:
- long sleep
timeout: 60s

Como filtrar resultados de criação usando consultas

Para encontrar informações de criações que se encaixam em critérios específicos, forneça uma string de consulta no campo Filtrar criações na página Histórico de criações no Console do Google Cloud Platform. Por exemplo, é possível consultar criações que falharam (que têm um valor FAILURE no campo de status), criações que foram criadas após um determinado período, criações com tags e outras condições.

Campos compatíveis para consultas

É possível consultar criações com base no valor dos seguintes campos:

• status
• build_id
• trigger_id
• source.storage_source.bucket
• source.storage_source.object
• source.repo_source.repo_name
• source.repo_source.branch_name
• source.repo_source.tag_name
• source.repo_source.commit_sha
• source_provenance.resolved_repo_source.commit_sha
• results.images.name
• results.images.digest
• options.requested_verify_option
• tags
• images
• create_time
• start_time
• finish_time

Os campos listados com um ponto (..) são subcampos.

Como criar uma string de consulta

Strings de consulta usam o formato geral:

field="value"

Use o ponto para especificar um subcampo, como results.images.name. As consultas são compatíveis com os operadores de comparação = e != e também com >, >=, < e <= para campos com valores numéricos (como create_time).

Para criar consultas compostas, use as expressões booleanas AND e OR.

Exemplos de consultas comuns

Para consultar todas as criações bem-sucedidas:

status="SUCCESS"

Para consultar todas as criações ainda não concluídas:

status="QUEUED" OR status="WORKING"

Para consultar as criações com um nome de imagem resultante específico:

(status="SUCCESS" OR status="FAILURE") AND \
    results.images.name="gcr.io/argo-integration-testing/stubby-probe"

Para consultar todas as criações com a tag "prod":

tags="prod"

Para consultar as criações marcadas como verificadas:

options.requested_verify_option="VERIFIED"

Para consultar as criações provenientes de uma fonte do Cloud Storage (em oposição a um Cloud Source Repository):

source.storage_source.bucket!=""

Para consultar as criações com um resumo resultante específico:

results.images.digest="sha256:6c7147fe4c813845ac2a9aa6f937bb272b68784f647c4f64c7325723c7245c88"

Para consultar as criações iniciadas depois de um período específico e concluídas antes de um período específico (fuso horário UTC):

create_time>"2016-10-12T18:43:49+00:00" AND finish_time<"2016-10-13T18:43:49+00:00"

Observação: esta resposta à consulta está no formato ISO 8601.

Como filtrar resultados de criação usando tags

Use tags nos arquivos de configuração. Assim é possível organizar as criações em grupos e filtrá-las. Também é possível especificar strings em tags, como "prod" ou "test".

As tags têm as seguintes limitações:

• O limite de caracteres de cada tag é de 128 caracteres.
• É possível definir um máximo de 64 tags por criação.
• As tags podem conter letras, números e sublinhados.

Para adicionar tags à sua criação:

1. No seu arquivo de configuração da criação, adicione o campo tags:

   steps:
   - name: 'gcr.io/cloud-builders/docker'
     args: [ 'build', '-t', 'gcr.io/$PROJECT_ID/cb-demo-img', '.' ]
   images:
   - 'gcr.io/$PROJECT_ID/cb-demo-img'
   tags:
   - "test"
   - "tag2"
   

2. Para ver criações com tags em seu cluster, use a opção --filter em gcloud builds list. Por exemplo, o comando a seguir lista todas as criações marcadas com 'test':

   gcloud builds list --filter "tags='test'"
   

   Você verá um resultado semelhante a este:

   ID                                    CREATE_TIME                DURATION  SOURCE                                                                             IMAGES                                 STATUS
   d33a9895-...                          ...                        1M45S     gs://...                                                                           gcr.io/...                             SUCCESS
   

Observação: as tags de criação são separadas das tags de imagem do Docker. Verifique se está usando as tags corretas.

A seguir

• Saiba como enviar notificações sobre eventos de criações.
• Saiba como configurar notificações do Slack e notificações de e-mail usando o Cloud Pub/Sub e o Cloud Functions.