Executar uma compilação (AWS CLI)

Execute o comando start-build de uma das seguintes maneiras:

aws codebuild start-build --project-name <project-name>

Use esta maneira se você quiser executar um build que utiliza a versão mais recente do artefato de entrada de build e as configurações existentes do projeto de build.

aws codebuild start-build --generate-cli-skeleton

Use esta maneira se quiser executar uma compilação com uma versão anterior do artefato de entrada da compilação ou se quiser substituir as configurações dos artefatos de saída da compilação, as variáveis de ambiente, o buildspec ou o período de tempo limite padrão da compilação.

Se você executar o comando start-build com a opção --project-name, substitua <project-name> pelo nome do projeto de compilação e avance para a etapa 6 deste procedimento. Para obter uma lista de projetos de build, consulte Visualizar uma lista de nomes de projetos de compilação.

Se você executar o comando start-build com a opção --idempotency-token, um identificador, ou token, exclusivo que diferencia maiúsculas e minúsculas é incluído na solicitação start-build. O token é válido por 5 minutos após a solicitação . Se você repetir a solicitação start-build com o mesmo token, mas alterar um parâmetro, o CodeBuild vai gerar um erro de incompatibilidade de parâmetro.

Se você executar o comando start-build com a opção --generate-cli-skeleton, os dados formatados JSON serão exibidos na saída. Copie os dados para um arquivo (por exemplo, start-build.json) em um local no computador local ou em uma instância na qual a AWS CLI esteja instalada. Altere os dados copiados para corresponder ao seguinte formato, e salve os resultados:

{
  "projectName": "projectName",
  "sourceVersion": "sourceVersion",
  "artifactsOverride": {
    "type": "type",
    "location": "location",
    "path": "path",
    "namespaceType": "namespaceType",
    "name": "artifactsOverride-name",
    "packaging": "packaging"
  },
  "buildspecOverride": "buildspecOverride",
  "cacheOverride": {
    "location": "cacheOverride-location",
    "type": "cacheOverride-type"
  },
  "certificateOverride": "certificateOverride",
  "computeTypeOverride": "computeTypeOverride",
  "environmentTypeOverride": "environmentTypeOverride",
  "environmentVariablesOverride": {
    "name": "environmentVariablesOverride-name",
    "value": "environmentVariablesValue",
    "type": "environmentVariablesOverride-type"
  },
  "gitCloneDepthOverride": "gitCloneDepthOverride",
  "imageOverride": "imageOverride",
  "idempotencyToken": "idempotencyToken",
  "insecureSslOverride": "insecureSslOverride",
  "privilegedModeOverride": "privilegedModeOverride",
  "queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride",
  "reportBuildStatusOverride": "reportBuildStatusOverride",
  "timeoutInMinutesOverride": "timeoutInMinutesOverride",
  "sourceAuthOverride": "sourceAuthOverride",
  "sourceLocationOverride": "sourceLocationOverride",
  "serviceRoleOverride": "serviceRoleOverride",
  "sourceTypeOverride": "sourceTypeOverride"
}

Substitua os seguintes espaços reservados:

Recomendamos armazenar uma variável de ambiente com um valor confidencial, como um ID de chave de acesso da AWS, uma chave de acesso secreta da AWS ou uma senha como um parâmetro no Amazon EC2 Systems Manager Parameter Store. O CodeBuild poderá usar um parâmetro armazenado no Amazon EC2 Systems Manager Parameter Store apenas se o nome do parâmetro começar com /CodeBuild/ (por exemplo, /CodeBuild/dockerLoginPassword). É possível usar o console do CodeBuild para criar um parâmetro no Amazon EC2 Systems Manager. Escolha Create a parameter (Criar um parâmetro) e siga as instruções. (Nessa caixa de diálogo, em Chave do KMS, é possível especificar o ARN de uma chave do AWS KMS na conta. O Amazon EC2 Systems Manager usa essa chave para criptografar o valor do parâmetro durante o armazenamento e descriptografá-lo durante a recuperação.) Se você usar o console do CodeBuild para criar um parâmetro, o console começará o nome do parâmetro com /CodeBuild/, pois ele está sendo armazenado. No entanto, se você usar o console do Amazon EC2 Systems Manager Parameter Store para criar um parâmetro, deverá iniciar o nome do parâmetro com /CodeBuild/ e definir Tipo como String segura. Para obter mais informações, consulte AWS Systems Manager Parameter Store e Walkthrough: Create and test a String parameter (console) no Guia do usuário do Amazon EC2 Systems Manager.

Se o projeto de compilação se referir a parâmetros armazenados no Amazon EC2 Systems Manager Parameter Store, o perfil de serviço do projeto de compilação deverá permitir a ação ssm:GetParameters. Se você tiver escolhido Criar um perfil de serviço na conta antes, o CodeBuild incluirá essa ação no perfil de serviço padrão para o projeto de compilação automaticamente. No entanto, se escolher Choose an existing service role from your account, você deverá incluir essa ação na função de serviço separadamente.

As variáveis de ambiente definidas por você substituem variáveis de ambiente existentes. Por exemplo, se a imagem de Docker já contiver uma variável de ambiente chamada MY_VAR com um valor de my_value e você definir uma variável de ambiente chamada MY_VAR com um valor de other_value, my_value será substituído por other_value. Da mesma maneira, se a imagem de Docker já contiver uma variável de ambiente chamada PATH com um valor de /usr/local/sbin:/usr/local/bin e você definir uma variável de ambiente chamada PATH com um valor de $PATH:/usr/share/ant/bin, /usr/local/sbin:/usr/local/bin será substituído pelo valor literal $PATH:/usr/share/ant/bin.

Não defina nenhuma variável de ambiente com um nome que comece com CODEBUILD_. Este prefixo está reservado para uso interno da .

Se uma variável de ambiente com o mesmo nome for definida em vários locais, o valor da variável de ambiente será determinado como se segue:

Para obter informações sobre valores válidos para esses espaços reservados, consulte Criar um projeto de compilação (AWS CLI). Para obter uma lista das últimas configurações de um projeto de compilação, consulte Visualizar detalhes de um projeto de compilação.

Alterne para o diretório que contenha o arquivo que você acabou de salvar e execute o comando start-build novamente.

aws codebuild start-build --cli-input-json file://start-build.json

Se bem-sucedidos, dados semelhantes aos descritos no procedimento Para executar a compilação serão exibidos na saída.