Création d'un travail qui fait référence à une image dans Container Registry à l'aide de la console

Créez une configuration de travail qui utilise une image dans Container Registry à l'aide de la console Code Engine.

Code Engine peut automatiquement extraire des images à partir d'un espace de nom Container Registry dans votre compte. Pour extraire des images d'un autre compte Container Registry ou d'un compte du Docker Hub privé, voir Créer un travail à partir d'images dans un registre privé.

1. Ouvrez la console Code Engine.
2. Sélectionnez « Commencer la création ».
3. Sélectionnez un projet dans la liste des projets disponibles. Vous pouvez aussi en créer un. Notez que vous devez disposer d'un projet sélectionné pour créer un travail.
4. Sélectionnez Travail.
5. Entrez un nom pour le travail, par exemple myjob.
6. Sélectionnez « Utiliser une image de conteneur existante », puis cliquez sur « Configurer l'image ».
7. Sélectionnez un emplacement de registre de conteneurs, tel que IBM Registry Dallas.
8. Sélectionnez Code Engine managed secret pour Registry secret. Comme cet exemple utilise une image située dans l'espace de noms Container Registry de votre compte, Code Engine peut créer et gérer automatiquement le secret de registre à votre place.
9. Sélectionnez un espace de nom existant et le nom de l'image dans le registre pour le travail Code Engine à référencer. Par exemple, sélectionnez mynamespace et l'image hello_repo dans cet espace de nom.
10. Sélectionnez une valeur pour Balise, par exemple latest.
11. Cliquez sur Terminé.
12. Modifiez les valeurs par défaut des variables d'environnement ou des paramètres d'exécution. Pour plus d'informations sur ces options, voir Options de création et d'exécution d'un travail.
13. Sur la page Créer un travail, cliquez sur Créer.
14. Une fois votre travail créé, sa page s'affiche. Dans votre page de travail, cliquez sur Soumettre le travail pour soumettre un travail basé sur la configuration actuelle.

Maintenant que vous avez créé votre travail et exécuter votre travail, vous pouvez afficher les détails de votre configuration de travail et de votre travail à partir de votre page de travail.

Si vous souhaitez ajouter un accès au registre avant de créer un travail, voir Accès aux registres de conteneurs.

Création d'un travail avec une image dans Container Registry via l'interface de ligne de commande

Créez une configuration de travail qui utilise une image dans IBM Cloud® Container Registry avec l'interface de ligne de commande, utilisez la commande**job create**. Pour obtenir la liste complète des options, voir la commande ibmcloud ce job create.

Avant de commencer

• Configurez votre environnement d'interface de ligne de commande Code Engine.
• Créez et utilisez un projet.
• Avant de pouvoir utiliser un travail Code Engine qui référence une image dans Container Registry, vous devez d'abord ajouter l'accès au registre afin que Code Engine puisse extraire l'image lors de l'exécution du travail. Pour plus d'informations sur les droits requis pour l'accès aux registres d'images, voir Configuration des droits pour les registres d'images.

1. Pour ajouter un accès dans Container Registry, créez une clé d'API IAM. Pour créer une clé d'API IAM IBM Cloud à partir de l'interface de ligne de commande, exécutez la commande iam api-key-create. Par exemple, pour créer une clé API nommée « cliapikey » avec la description « My CLI API key » et l'enregistrer dans un fichier nommé « key_file », exécutez la commande suivante :

   ibmcloud iam api-key-create cliapikey -d "My CLI API key" --file key_file
   

   Si vous choisissez de ne pas sauvegarder votre clé dans un fichier, vous devez enregistrer la clé d'API qui s'affiche lors de sa création. Vous ne pourrez pas la récupérer ultérieurement.

2. Après avoir créé votre clé d'API, ajoutez un accès au registre à Code Engine. Pour ajouter l'accès à Container Registry à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud ce secret create --format registry pour créer un secret de registre. Par exemple, la commande suivante crée une entrée de registre permettant d'accéder à une instance d' Container Registry nommée myregistry. Notez que, même si les options --server et --username sont spécifiées dans l'exemple de commande, la valeur par défaut pour l'option --server est us.icr.io et que l'option --username prend par défaut la valeur iamapikey lorsque le serveur est us.icr.io.

   ibmcloud ce secret create --format registry --name myregistry --server us.icr.io --username iamapikey --password APIKEY
   

   Exemple de sortie

   Creating registry secret 'myregistry'...
   OK
   

3. Créez votre configuration de travail et référencez l'image hello_repo dans Container Registry. Par exemple, la commande job create suivante crée le travail myhellojob pour faire référence au us.icr.io/mynamespace/hello_repo à l'aide des informations d'accès de myregistry.

   ibmcloud ce job create --name myhellojob --image us.icr.io/mynamespace/hello_repo --registry-secret myregistry
   

   Le format du nom de l'image pour ce travail est REGISTRY/NAMESPACE/REPOSITORY:TAG, où REGISTRY et TAG sont facultatifs. Si REGISTRY n'est pas spécifié, la valeur par défaut est docker.io. Si TAG n'est pas spécifié, la valeur par défaut est latest.

Etapes suivantes

• Après avoir créé votre travail, soumettez le travail pour l'exécuter. Voir Exécution d'un travail. Vous pouvez exécuter votre travail plusieurs fois.

• Après avoir exécuter votre travail, pour afficher les détails de votre travail et de vos exécutions de travail, voir Accès aux détails du travail.

• Maintenant que votre travail est créé, envisagez de faire vos travaux en fonctions des événements. En utilisant des abonnements à des événements, vous pouvez déclencher vos travaux par des calendriers périodiques ou configurer votre travail pour qu'il réagisse à des événements comme des téléchargements de fichiers.

• Vous pouvez mettre à jour votre travail et son code référencé avec n'importe quelle manières suivantes, indépendamment de la façon dont vous avez créé ou mis à jour votre travail.

  • Si vous disposez d'une image de conteneur conforme à la norme Open Container Initiative(OCI), il vous suffit de fournir une référence à cette image, qui pointe vers l'emplacement de votre registre de conteneurs, lorsque vous créez (ou mettez à jour) votre tâche. Vous pouvez créer (ou mettre à jour) votre tâche à partir d'images issues d'un registre public ou privé, puis accéder à l'image référencée depuis l'exécution de votre tâche.

    Si vous avez créé votre travail à l'aide de la commande job create et que vous avez spécifié l'option --build-source pour générer l'image de conteneur à partir de la source locale ou du référentiel, et que vous souhaitez modifier votre travail pour qu'il pointe vers une autre image de conteneur, vous devez d'abord supprimer l'association de la génération de votre travail. Par exemple, exécutez ibmcloud ce job update -n JOB_NAME --build-clear. Après avoir supprimé l'association de la génération de votre travail, vous pouvez mettre à jour le travail pour référencer une image différente.

  • Si vous démarrez avec le code source qui réside dans un référentiel Git, vous pouvez choisir de laisser Code Engine prendre soin de générer l'image à partir de votre source et de créer (ou de mettre à jour) le travail avec une opération unique. Dans ce scénario, Code Engine télécharge votre image sur IBM Cloud® Container Registry. Pour en savoir plus, reportez-vous à la section Création d'un travail à partir du code source du référentiel. Si vous souhaitez plus de contrôle sur la génération de votre image, vous pouvez choisir de générer l'image avec Code Engine avant de créer (ou mettre à jour) votre travail et d'exécuter le travail.

  • Si vous démarrez avec le code source résidant sur un poste de travail local, vous pouvez choisir de laisser Code Engine prendre soin de créer l'image à partir de votre source et de créer le travail avec une commande CLI unique. Dans ce scénario, Code Engine télécharge votre image sur IBM Cloud® Container Registry. Pour en savoir plus, reportez-vous à la section Création de votre travail à partir du code source local avec l'interface de ligne de commande. Si vous souhaitez plus de contrôle sur la génération de votre image, vous pouvez choisir de générer l'image avec Code Engine avant de créer (ou mettre à jour) votre travail et d'exécuter le travail.

  Par exemple, vous pouvez choisir de laisser Code Engine gérer la génération de votre source locale pendant que vous faites évoluer le développement de votre source pour le travail. Ensuite, après la maturation de l'image, vous pouvez mettre à jour le travail pour référencer l'image spécifique de votre choix. Vous pouvez répéter ce processus si nécessaire.

  Lorsque vous exécutez votre travail mis à jour, la dernière version de votre image de conteneur référencée est utilisée pour l'exécution du travail, sauf si une balise est spécifiée pour l'image. Si une balise est spécifiée pour l'image, l'image référencée est utilisée pour l'exécution du travail.

Vous recherchez d'autres exemples de code ? Découvrez le site Exemples pour le dépôt « IBM Cloud Code Engine GitHub ».