⌨️aws codebuild batch-get-builds

O estado de um ou mais builds. — comando da trilha de AWS CodeBuild.

Exemplo: o que o terminal devolve

Na atividade Passou ou quebrou?, este é o comando e a resposta, como aparecem no terminal do CLImb.

$ aws codebuild batch-get-builds --ids api-loja-build:5188f822-d03f-5e4d-0ed6-a5a93eb80874
{
    "builds": [
        {
            "id": "api-loja-build:5188f822-d03f-5e4d-0ed6-a5a93eb80874",
            "arn": "arn:aws:codebuild:us-east-1:123456789012:build/api-loja-build:5188f822-d03f-5e4d-0ed6-a5a93eb80874",
            "buildNumber": 1,
            "startTime": 1791151249.011,
            "currentPhase": "BUILD",
            "buildStatus": "IN_PROGRESS",
            "projectName": "api-loja-build",
            "phases": [
                {
                    "phaseType": "SUBMITTED",
                    "phaseStatus": "SUCCEEDED",
                    "startTime": 1791151249.011,
                    "endTime": 1791151249.411,
                    "durationInSeconds": 0
                },
                {
                    "phaseType": "QUEUED",
                    "phaseStatus": "SUCCEEDED",
                    "startTime": 1791151249.411,
                    "endTime": 1791151250.011,
                    "durationInSeconds": 1
                },
                {
                    "phaseType": "PROVISIONING",
                    "phaseStatus": "SUCCEEDED",
                    "startTime": 1791151250.011,
                    "endTime": 1791151264.011,
  (...)

Se faltar argumento

Sem nenhum argumento, o terminal do CLImb responde assim. A mensagem de uso é o caminho mais rápido pra descobrir o que faltou, antes de abrir o manual inteiro.

$ aws codebuild batch-get-builds
aws: error: the following arguments are required: --ids

Manual do comando

É o mesmo texto que aws codebuild batch-get-builds help devolve dentro do CLImb.

USO
    aws codebuild batch-get-builds --ids <id-do-build> [<id2> ...]

O estado de um ou mais builds: buildStatus (IN_PROGRESS, SUCCEEDED,
FAILED, FAULT, STOPPED, TIMED_OUT), a fase atual e a lista de fases.

QUANDO FALHA
    procure a fase com phaseStatus FAILED e leia o campo contexts: é ali
    que vem o motivo. FAILED costuma ser o seu código (teste quebrado);
    FAULT costuma ser o ambiente (rede, permissão, serviço fora).

Onde você pratica isto (7 atividades)

Cada uma é um pedido de trabalho real; você resolve digitando o comando, e o estado fica salvo pro exercício seguinte.

Passou ou quebrou?

O build está rodando. Consulte o estado dele pelo id — e consulte de novo até o buildStatus sair de IN_PROGRESS.

Só o veredito

O script do deploy só quer saber se o build passou. Consulte o build trazendo só o buildStatus.

O build vermelho

O projeto de testes de integração, testes-api-build, usa o repositório https://github.com/climb-labs/testes-quebrados. Crie o projeto (mesma máquina e role), rode um build e consulte até ele terminar. Descubra em que fase ele quebrou e por quê.

A rede caiu no meio do build

O projeto do app, app-mobile-build (repositório https://github.com/climb-labs/app-instavel), falhou na primeira vez — e não foi o código. Crie o projeto, rode, consulte até terminar e veja a fase que falhou. Depois, repita o build igualzinho.

A repetição passou?

Confira o build repetido do app-mobile-build até ele terminar — agora tem que dar SUCCEEDED.

Repetir não conserta código

Pra fixar a diferença: repita o último build do testes-api-build e consulte até terminar. Ele vai falhar igual — erro de código não passa na base da insistência.

Por que o build quebrou?

A esteira só diz "Build terminated with state: FAILED". Ache o motivo de verdade: liste as ações da execução que falhou, pegue o externalExecutionId do Build e consulte esse build no CodeBuild.

Outros comandos com página própria

Ler a sintaxe explica. Digitar fixa. No CLImb você roda aws codebuild batch-get-builds num terminal AWS simulado e vê a saída — inclusive a mensagem de erro, quando erra a flag.

Praticar no terminal