Documentation sur Oracle Cloud Infrastructure

Préparation des artefacts d'étape de pipeline

Voyez comment créer un artefact d'étape de pipeline à utiliser dans les pipelines et les exécutions de pipeline.

Les étapes de pipeline sont des artefacts qui incluent le code à exécuter à chaque étape. Ce code contient les scripts qui s'exécutent lors de l'exécution de l'étape de pipeline et qui sont définis dans l'étape de pipeline en tant qu'artefact unique.

Voici les types d'artefact de pipeline que vous pouvez utiliser :

Fichiers Python

L'artefact peut être un fichier Python simple et unique qui contient du code pour exécuter un pipeline tel que cet exemple de fichier Python :

# simple pipeline step
import time
 
print(" This is a step in a pipeline.")
time.sleep(3)
print("Pipeline step done.")

Cette étape de pipeline imprime deux messages avec une durée de veille de trois secondes. Vous pouvez enregistrer le code dans un seul fichier simple_pipeline_step.py, puis l'inclure en tant qu'étape dans un pipeline. Les exécutions de pipeline fournissent déjà Python préinstallé et peuvent exécuter le code avec toutes les bibliothèques du système Python.

Cet exemple n'utilise pas de bibliothèques Python tierces. Vous contrôlez les bibliothèques et les environnements Python installés en utilisant votre pipeline dans un environnement Conda.

Scripts Bash ou d'interpréteur de commandes

Vous pouvez utiliser un seul fichier de script comme dans l'exemple suivant ou un fichier plus complexe :

#!/bin/bash
var=$1
if [ -z "$var" ]
then
      echo "no argument provided"
      exit 100
else
      while [ "$1" != "" ]; do
        echo "Received: ${1}" && shift;
      done
fi

Seul Bash sur Oracle Linux est pris en charge.

Fichiers zip ou tar compressés

Souvent, les projets sont plus complexes et nécessitent plus de code que ne peut en contenir un seul fichier. Si vous avez des scripts complexes de projet et d'interpréteur de commandes Python, vous pouvez archiver tous les fichiers dans un seul fichier zip et l'utiliser comme artefact d'étape. À l'aide d'un gros fichier JAR, vous pouvez exécuter du code Java en tant qu'étape de pipeline.

Aucune exigence spéciale ne s'applique à l'écriture du code Python ou du script d'interpréteur de commandes pour l'exécuter en tant que pipeline. Vous pouvez pointer vers le fichier principal à l'aide du paramètre PIPELINE_STEP_RUN_ENTRYPOINT après avoir chargé le fichier zip ou l'artefact tar compressé.

Considérations relatives au fichier d'archives :

  • Archiver tout le code dans un seul répertoire.

  • Le nom du fichier doit correspondre au nom du répertoire racine que vous avez défini avec PIPELINE_STEP_RUN_ENTRYPOINT.

    STEP_RUN_ENTRYPOINT apparaît dans la page Détails des exécutions de pipeline lorsqu'il est en cours d'utilisation.

Pour commencer, téléchargez, décompressez et examinez le fichier zipped_python_job.zip, fourni à titre d'exemple.

"environmentVariables": {
    "PIPELINE_STEP_RUN_ENTRYPOINT": "zipped_python_pipeline/entry.py"
}

Notez que le point d'entrée est différent pour le pipeline complexe.

Utilisez ces étapes pour créer un fichier d'artefact de pipeline :

  1. Une fois que vous avez le code Java prêt, créez un gros fichier JAR du projet qui inclut un script d'interpréteur de commandes qui exécute la méthode Java main.

  2. Créez un répertoire racine pour le code du projet.

    L'ensemble du projet doit se trouver dans un répertoire racine pour être compressé dans un fichier d'archives.

  3. Créez le code de pipeline sous le répertoire racine.

    Le code de pipeline dans son intégralité doit se trouver dans le répertoire racine.

  4. Compressez le répertoire racine dans un fichier zip ou tar.

Maintenant, vous pouvez charger le fichier d'archives en tant qu'artefact de pipeline lors de la création d'un pipeline. Lors de la création du pipeline, ajoutez PIPELINE_STEP_RUN_ENTRYPOINT en tant que variable d'environnement personnalisée dans la configuration du pipeline.