Executando uma Configuração de Construção

Após a criação de uma configuração de construção, é possível enviar uma execução com base nessa configuração de construção. Execute sua compilação por meio do console ou com a CLI.

O Code Engine tem cotas para compilações e execuções de compilação dentro de um projeto. Para obter mais informações sobre limites do Code Engine, consulte Limites e cotas para o Code Engine.

As execuções de compilação concluídas são automaticamente excluídas. Quando sua execução de compilação é baseada na configuração de compilação, essa execução de compilação é excluída após três horas se a execução de compilação for bem-sucedida. Se a execução da compilação não for bem-sucedida, ela será excluída após uma semana.

Executando uma construção por meio do console

  1. Acesse o painel do Code Engine.
  2. Selecione o projeto no qual sua construção foi criada.
  3. Na página de projeto, clique em Construções de imagem.
  4. Na guia Compilação de imagem, selecione o nome da compilação de imagem com a qual você deseja trabalhar com.
  5. Na seção Configuration (Configuração ), é possível revisar a configuração de compilação e alterar os valores, se necessário.
  6. Verifique quaisquer informações adicionais, como a Imagem de Saída para essa execução de construção, ou sobrescreva o valor de Tempo Limite
  7. Envie a execução de compilação clicando em Enviar construção.

Monitore o seu progresso de construção na seção Execuções de compilação.

Executando uma compilação com a CLI para a origem por meio de um repositório (não local)

Para enviar uma execução de compilação por meio de uma configuração de construção com a CLI, use o comando buildrun submit. Este comando requer o nome de uma configuração de construção. Outros argumentos opcionais podem ser especificados. Para obter uma listagem completa de opções, consulte o comando ibmcloud ce buildrun submit.

O exemplo a seguir executa uma construção que é chamada helloworld-build-run e usa a construção helloworld-build.

ibmcloud ce buildrun submit --build helloworld-build --name helloworld-build-run

Saída de exemplo

Submitting build run 'helloworld-build-run'...
Run 'ibmcloud ce buildrun get -n helloworld-build-run' to check the build run status.
OK

A tabela a seguir resume as opções que são usadas com o comando buildrun submit neste exemplo. Consulte o comando ibmcloud ce buildrun submit para obter mais informações sobre ele e as opções que ele oferece.

Descrição do comando
Opção Descrição
--build O nome da configuração de construção a ser usado. Este valor é necessário.
--name

O nome da execução de compilação. Use um nome que seja exclusivo dentro do projeto.

  • O nome deve começar e terminar com um caractere alfanumérico minúscula.
  • O nome deve ter 63 caracteres ou menos e pode conter caracteres alfanuméricos minúsculos e hifens (-).

Suas execuções de construção começam. Monitore o progresso usando o comando ibmcloud ce buildrun get.

Por exemplo, para verificar o status da execução de compilação por meio do exemplo anterior,

ibmcloud ce buildrun get --name helloworld-build-run

Saída de exemplo

Getting build run 'helloworld-build-run'...
[...]
OK

Name:          helloworld-build-run
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21m
Created:       2021-03-14T14:50:13-05:00

Summary:  Succeeded
Status:   Succeeded
Reason:   Succeeded

Para obter mais informações sobre construções, verifique as Dicas de resolução de problemas.

Executando uma construção com a CLI para a origem por meio de um diretório local (local)

Para enviar uma execução de compilação por meio de uma configuração de construção com a CLI que extrai a origem de um diretório local, use o comando buildrun submit. Este comando requer o nome de uma configuração de construção e o caminho para a origem local. Outros argumentos opcionais podem ser especificados. Para obter uma listagem completa de opções, consulte o comando ibmcloud ce buildrun submit.

O cenário a seguir clona o repositório Samples for IBM Cloud Code Engine GitHub em um diretório CodeEngineLocalSample em sua estação de trabalho local.

  1. Clone o repositório Samples for IBM Cloud Code Engine GitHub em um subdiretório criado em sua estação de trabalho local, como o subdiretório CodeEngineLocalSamples. Nesse diretório, execute o comando git clone ; por exemplo,

    git clone https://github.com/IBM/CodeEngine
    
  2. Acesse o diretório em que seu código-fonte está na estação de trabalho. Por exemplo, acesse o subdiretório CodeEngine no qual as amostras Code Engine residem.

  3. No diretório onde o seu código-fonte reside, envie a execução de compilação. O exemplo a seguir executa uma construção que é chamada buildrun-local-dockerfile e usa a configuração de construção build-local-dockerfile. A opção --source especifica o caminho para a origem na estação de trabalho local para a amostra helloworld.

    ibmcloud ce buildrun submit --name buildrun-local-dockerfile --build build-local-dockerfile --source ./helloworld
    

    Saída de exemplo

    Getting build 'build-local-dockerfile'
    Packaging files to upload from source path './helloworld' ...
    Submitting build run 'buildrun-local-dockerfile'...
    Run 'ibmcloud ce buildrun get -n buildrun-local-dockerfile' to check the build run status.
    OK
    
  4. Monitore o progresso de sua execução de compilação usando o comando ibmcloud ce buildrun get. Por exemplo, para verificar o status da execução de compilação por meio do exemplo anterior,

    ibmcloud ce buildrun get --name helloworld-build-run
    

    Saída de exemplo

    Getting build run 'buildrun-local-dockerfile'...
    Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun events -n buildrun-local-dockerfile' to get the system events of the build run.
    Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun logs -f -n buildrun-local-dockerfile' to follow the logs of the build run.
    OK
    
    Name:          buildrun-local-dockerfile
    ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
    Project Name:  myproject
    Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
    Age:           40s
    Created:       2022-01-19T12:22:33-05:00
    
    Summary:       Succeeded
    Status:        Succeeded
    Reason:        All Steps have completed executing
    Source:
      Source Image Digest:  sha256:07159930b5abcf94e1a7451ea18490d4ad1162a77c2b987da5b7493fa1f1e49d
    Image Digest:  sha256:04c7be7db438a41040ea24d646314f1c847c191d88fffdbea6f483fc443c2bbe
    
    Build Name:    build-local-dockerfile
    Source Image:  us.icr.io/mynamespace/codeengine-build-source
    Image:         us.icr.io/mynamespace/codeengine-build
    Timeout:       10m0s
    

Ao enviar uma construção que extrai código de um diretório local, seu código-fonte é empacotado em um archive e carregado para a sua instância do IBM Cloud Container Registry. Depois que a execução de compilação é concluída, é possível ver sua imagem construída, como codeengine-build, na instância do IBM Cloud Container Registry. Você também pode ver uma imagem de origem com -source anexado ao nome de sua compilação, como codeengine-build-source. É possível excluir essa imagem de origem sem impacto.

Para obter mais informações sobre construções, verifique as Dicas de resolução de problemas.