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
- Acesse o painel do Code Engine.
- Selecione o projeto no qual sua construção foi criada.
- Na página de projeto, clique em Construções de imagem.
- Na guia Compilação de imagem, selecione o nome da compilação de imagem com a qual você deseja trabalhar com.
- Na seção Configuration (Configuração ), é possível revisar a configuração de compilação e alterar os valores, se necessário.
- 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
- 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.
| 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.
|
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.
-
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 comandogit clone; por exemplo,git clone https://github.com/IBM/CodeEngine -
Acesse o diretório em que seu código-fonte está na estação de trabalho. Por exemplo, acesse o subdiretório
CodeEngineno qual as amostras Code Engine residem. -
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-dockerfilee usa a configuração de construçãobuild-local-dockerfile. A opção--sourceespecifica o caminho para a origem na estação de trabalho local para a amostrahelloworld.ibmcloud ce buildrun submit --name buildrun-local-dockerfile --build build-local-dockerfile --source ./helloworldSaí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 -
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-runSaí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.