Exécution d'une configuration de génération

Une fois que vous avez créé une configuration de génération, vous pouvez soumettre une exécution s'appuyant sur cette configuration de génération. Exécutez votre génération à partir de la console ou à l'aide de l'interface de ligne de commande.

Code Engine applique des quotas pour les générations et les exécutions de génération dans un projet. Pour plus d'informations sur les limites dans Code Engine, voir Limites et quotas pour Code Engine.

Les cycles de construction qui se terminent sont automatiquement supprimés. Lorsque votre cycle de construction est basé sur la configuration de la construction, ce cycle de construction est supprimé au bout de trois heures si le cycle de construction est réussi. Si le cycle de construction n'est pas réussi, il est supprimé au bout d'une semaine.

Exécution d'une génération à partir de la console

Accédez au tableau de bord Code Engine.
Sélectionnez le projet dans lequel vous avez créé votre génération.
Sur la page du projet, cliquez sur Générations d'image.
Dans l'onglet Génération d'image, sélectionnez le nom de la génération d'image à utiliser.
Dans la section Configuration, vous pouvez revoir la configuration de la construction et modifier les valeurs, si nécessaire.
Vérifiez les informations supplémentaires, telles que l'image de sortie pour cette exécution de génération, ou remplacez la valeur Délai d'attente.
Soumettez l'exécution de génération en cliquant sur Soumettre une génération.

Surveillez la progression de votre génération dans la section Exécutions de génération.

Exécution d'une génération avec l'interface de ligne de commande pour la source à partir d'un référentiel (non local)

Pour soumettre une exécution de génération à partir d'une configuration de génération à l'aide de l'interface de ligne de commande, utilisez la commande buildrun submit. Cette commande requiert le nom d'une configuration de génération. D'autres arguments facultatifs peuvent être spécifiés. Pour obtenir la liste complète des options, voir la commande ibmcloud ce buildrun submit.

L'exemple suivant exécute une génération appelée helloworld-build-run et utilise la génération helloworld-build.

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

Exemple de sortie

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

Le tableau suivant récapitule les options utilisées avec la commande buildrun submit dans cet exemple. Pour plus d'informations sur la commande et ses options, voir la commande ibmcloud ce buildrun submit.

Description de la commande
Option	Description
`--build`	Nom de la configuration de génération à utiliser. Cette valeur est obligatoire.
`--name`	Nom de l'exécution de génération. Utilisez un nom unique dans le projet. -Le nom doit commencer et se terminer par un caractère alphanumérique en minuscules. -Le nom doit contenir 63 caractères ou moins et peut contenir des caractères alphanumériques en minuscules et des traits d'union (-).

Votre exécution de génération commence. Surveillez la progression à l'aide de la commande ibmcloud ce buildrun get.

Par exemple, pour vérifier l'état de l'exécution de la génération à partir de l'exemple précédent,

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

Exemple de sortie

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

Pour plus d'informations sur les générations, voir Conseils relatifs au traitement des incidents liés aux générations.

Exécution d'une génération avec l'interface de ligne de commande pour la source à partir d'un répertoire local (local)

Pour soumettre une génération à partir d'une configuration de génération à l'aide de l'interface de ligne de commande qui extrait la source à partir d'un répertoire local, utilisez la commande buildrun submit. Cette commande requiert le nom d'une configuration de génération et le chemin d'accès à votre source locale. D'autres arguments facultatifs peuvent être spécifiés. Pour obtenir la liste complète des options, voir la commande ibmcloud ce buildrun submit.

Le scénario suivant clone le répertoire Samples for IBM Cloud Code Engine GitHub dans un répertoire CodeEngineLocalSample sur votre station de travail locale.

Clonez le répertoire Samples for IBM Cloud Code Engine GitHub dans un sous-répertoire créé sur votre station de travail locale, par exemple le sous-répertoire CodeEngineLocalSamples. À partir de ce répertoire, exécutez la commande git clone ; par exemple,
```
git clone https://github.com/IBM/CodeEngine
```
Accédez au répertoire dans lequel votre code source se trouve sur votre poste de travail. Par exemple, accédez au sous-répertoire CodeEngine dans lequel se trouvent les exemples Code Engine.
A partir du répertoire où réside votre code source, soumettez l'exécution de la génération. L'exemple suivant exécute une génération appelée buildrun-local-dockerfileet utilise la configuration de génération build-local-dockerfile. L'option --sourceindique le chemin d'accès de la source sur le poste de travail local à l'exemple helloworld.
```
ibmcloud ce buildrun submit --name buildrun-local-dockerfile --build build-local-dockerfile --source ./helloworld
```
Exemple de sortie
```
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
```

Surveillez la progression de l'exécution de votre génération à l'aide de la commande ibmcloud ce buildrun get. Par exemple, pour vérifier l'état de l'exécution de la génération à partir de l'exemple précédent,

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

Exemple de sortie

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

Lorsque vous soumettez une génération qui extrait du code à partir d'un répertoire local, votre code source est compressé dans un fichier archive et téléchargé sur votre instance IBM Cloud Container Registry. Une fois l'exécution de la génération terminée, vous pouvez voir votre image générée, telle que codeengine-build, dans l'instance IBM Cloud Container Registry. Vous pouvez également voir une image source avec -source ajouté au nom de votre construction, comme codeengine-build-source. Vous pouvez supprimer cette image source sans qu'il n'y ait d'impact.

Pour plus d'informations sur les générations, voir Conseils relatifs au traitement des incidents liés aux générations.