Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

2.7. Effectuer et configurer des constructions de base

Les sections suivantes fournissent des instructions pour les opérations de construction de base, y compris le démarrage et l'annulation des constructions, l'édition de BuildConfigs, la suppression de BuildConfigs, l'affichage des détails de la construction et l'accès aux journaux de construction.

2.7.1. Démarrer une construction
Copier lien

Vous pouvez lancer manuellement une nouvelle compilation à partir d'une configuration de compilation existante dans votre projet actuel.

Procédure

Pour lancer manuellement une compilation, entrez la commande suivante : 

oc start-build <buildconfig_name>
Copy to Clipboard Toggle word wrap

2.7.1.1. Réexécution d'une compilation
Copier lien

Vous pouvez relancer manuellement une compilation en utilisant l'option --from-build.

Procédure

  • Pour réexécuter manuellement une compilation, entrez la commande suivante : 

    oc start-build --from-build=<nom_de_la_construction>
    Copy to Clipboard Toggle word wrap

2.7.1.2. Journaux de construction en continu
Copier lien

Vous pouvez spécifier l'option --follow pour que les journaux de la compilation soient transmis à stdout.

Procédure

  • Pour diffuser manuellement les journaux d'une compilation dans stdout, entrez la commande suivante : 

    oc start-build <buildconfig_name> --follow
    Copy to Clipboard Toggle word wrap

Vous pouvez spécifier l'option --env pour définir toute variable d'environnement souhaitée pour la construction.

Procédure

  • Pour spécifier une variable d'environnement souhaitée, entrez la commande suivante : 

    $ oc start-build <buildconfig_name> --env=<key>=<value>
    Copy to Clipboard Toggle word wrap

2.7.1.4. Démarrer une compilation avec les sources
Copier lien

Plutôt que de s'appuyer sur une extraction de source Git ou un fichier Docker pour une construction, vous pouvez également démarrer une construction en poussant directement votre source, qui peut être le contenu d'un répertoire de travail Git ou SVN, un ensemble d'artefacts binaires préconstruits que vous souhaitez déployer, ou un simple fichier. Ceci peut être fait en spécifiant l'une des options suivantes pour la commande start-build:

Expand
OptionDescription

--from-dir=<directory>

Spécifie un répertoire qui sera archivé et utilisé comme entrée binaire pour la construction.

--from-file=<file>

Spécifie un fichier unique qui sera le seul fichier dans la source de construction. Le fichier est placé à la racine d'un répertoire vide avec le même nom de fichier que le fichier original fourni.

--from-repo=<local_source_repo>

Spécifie un chemin vers un dépôt local à utiliser comme entrée binaire pour une compilation. Ajoutez l'option --commit pour contrôler quelle branche, balise ou commit est utilisé pour la compilation.

Si vous passez l'une de ces options directement à la compilation, le contenu est transmis à la compilation et remplace les paramètres actuels de la source de la compilation.

Note

Les reconstructions déclenchées par une entrée binaire ne préserveront pas la source sur le serveur, de sorte que les reconstructions déclenchées par des modifications de l'image de base utiliseront la source spécifiée dans la configuration de la construction.

Procédure

  • Lancez une compilation à partir d'une source en utilisant la commande suivante pour envoyer le contenu d'un dépôt Git local sous forme d'archive à partir de la balise v2: 

    $ oc start-build hello-world --from-repo=../hello-world --commit=v2
    Copy to Clipboard Toggle word wrap

2.7.2. Annulation d'une construction
Copier lien

Vous pouvez annuler une construction à l'aide de la console web ou de la commande CLI suivante.

Procédure

  • Pour annuler manuellement une construction, entrez la commande suivante : 

    oc cancel-build <build_name>
    Copy to Clipboard Toggle word wrap

2.7.2.1. Annulation de plusieurs constructions
Copier lien

Vous pouvez annuler plusieurs constructions à l'aide de la commande CLI suivante.

Procédure

  • Pour annuler manuellement plusieurs constructions, entrez la commande suivante : 

    oc cancel-build <build1_name> <build2_name> <build3_name> $ oc cancel-build <build1_name> <build2_name>
    Copy to Clipboard Toggle word wrap

2.7.2.2. Annulation de toutes les constructions
Copier lien

Vous pouvez annuler toutes les constructions à partir de la configuration de la construction avec la commande CLI suivante.

Procédure

  • Pour annuler toutes les constructions, entrez la commande suivante : 

    oc cancel-build bc/<buildconfig_name>
    Copy to Clipboard Toggle word wrap

Vous pouvez annuler toutes les constructions dans un état donné, tel que new ou pending, tout en ignorant les constructions dans d'autres états.

Procédure

  • Pour annuler tout ce qui se trouve dans un état donné, entrez la commande suivante : 

    oc cancel-build bc/<buildconfig_name>
    Copy to Clipboard Toggle word wrap

2.7.3. Modifier une BuildConfig
Copier lien

Pour modifier vos configurations de construction, vous utilisez l'option Edit BuildConfig dans la vue Builds de la perspective Developer.

Vous pouvez utiliser l'une des vues suivantes pour modifier un site BuildConfig:

  • Le site Form view vous permet de modifier votre site BuildConfig à l'aide des champs de formulaire et des cases à cocher standard.
  • Le site YAML view vous permet d'éditer votre site BuildConfig avec un contrôle total sur les opérations.

Vous pouvez passer de Form view à YAML view sans perdre de données. Les données contenues dans le site Form view sont transférées vers le site YAML view et vice versa.

Procédure

  1. Dans la vue Builds de la perspective Developer, cliquez sur le menu kebab pour voir l'option Edit BuildConfig.
  2. Cliquez sur Edit BuildConfig pour voir l'option Form view.

  3. Dans la section Git, entrez l'URL du dépôt Git pour la base de code que vous souhaitez utiliser pour créer une application. L'URL est ensuite validée.

    • Optionnel : Cliquez sur Show Advanced Git Options pour ajouter des détails tels que

      • Git Reference pour spécifier une branche, une balise ou un commit qui contient le code que vous voulez utiliser pour construire l'application.
      • Context Dir pour spécifier le sous-répertoire qui contient le code que vous voulez utiliser pour construire l'application.
      • Source Secret pour créer un site Secret Name avec des informations d'identification permettant d'extraire votre code source d'un dépôt privé.

  4. Dans la section Build from, sélectionnez l'option à partir de laquelle vous souhaitez construire. Vous pouvez utiliser les options suivantes :

    • Image Stream tag référence une image pour un flux d'images et une balise donnés. Saisissez le projet, le flux d'images et la balise de l'emplacement à partir duquel vous souhaitez construire et pousser.
    • Image Stream image référence une image pour un flux d'images et un nom d'image donnés. Saisissez l'image du flux d'images à partir duquel vous souhaitez construire. Saisissez également le projet, le flux d'images et la balise à utiliser.
    • Docker image: L'image Docker est référencée par le biais d'un dépôt d'images Docker. Vous devrez également entrer le projet, le flux d'image et le tag pour faire référence à l'endroit où vous souhaitez pousser.
  5. Facultatif : dans la section Environment Variables, ajoutez les variables d'environnement associées au projet en utilisant les champs Name et Value. Pour ajouter d'autres variables d'environnement, utilisez Add Value, ou Add from ConfigMap et Secret.

  6. Facultatif : Pour personnaliser davantage votre application, utilisez les options avancées suivantes :

    Déclencheur
    Déclenche la construction d'une nouvelle image lorsque l'image du constructeur change. Ajoutez d'autres déclencheurs en cliquant sur Add Trigger et en sélectionnant Type et Secret.
    Secrets
    Ajoute des secrets pour votre application. Ajoutez d'autres secrets en cliquant sur Add secret et en sélectionnant Secret et Mount point.
    Politique
    Cliquez sur Run policy pour sélectionner la politique d'exécution de la construction. La politique sélectionnée détermine l'ordre dans lequel les builds créés à partir de la configuration de build doivent être exécutés.
    Crochets
    Sélectionnez Run build hooks after image is built pour exécuter des commandes à la fin de la construction et vérifier l'image. Ajoutez Hook type, Command, et Arguments à la commande.
  7. Cliquez sur Save pour enregistrer l'adresse BuildConfig.

2.7.4. Suppression d'une BuildConfig
Copier lien

Vous pouvez supprimer un site BuildConfig à l'aide de la commande suivante.

Procédure

  • Pour supprimer un site BuildConfig, entrez la commande suivante : 

    oc delete bc <BuildConfigName> $ oc delete bc <BuildConfigName>
    Copy to Clipboard Toggle word wrap

    Cette opération supprime également toutes les constructions qui ont été instanciées à partir de ce site BuildConfig.

  • Pour supprimer un site BuildConfig et conserver les constructions installées à partir du site BuildConfig, spécifiez l'indicateur --cascade=false lorsque vous entrez la commande suivante : 

    oc delete --cascade=false bc <BuildConfigName>
    Copy to Clipboard Toggle word wrap

2.7.5. Voir les détails de la construction
Copier lien

Vous pouvez afficher les détails de la construction à l'aide de la console Web ou de la commande CLI oc describe.

Cette fonction permet d'afficher des informations telles que

  • La source de construction.
  • La stratégie de construction.
  • La destination de la sortie.
  • Digest de l'image dans le registre de destination.
  • Comment la construction a été créée.

Si la compilation utilise la stratégie Docker ou Source, la sortie oc describe inclut également des informations sur la révision des sources utilisée pour la compilation, y compris l'ID du commit, l'auteur, le committer et le message.

Procédure

  • Pour afficher les détails de la construction, entrez la commande suivante : 

    oc describe build <nom_de_la_construction>
    Copy to Clipboard Toggle word wrap

2.7.6. Accès aux journaux de construction
Copier lien

Vous pouvez accéder aux journaux de construction à l'aide de la console web ou de l'interface de programmation.

Procédure

  • Pour diffuser les journaux en utilisant directement la compilation, entrez la commande suivante : 

    oc describe build <nom_de_la_construction>
    Copy to Clipboard Toggle word wrap

2.7.6.1. Accès aux journaux de BuildConfig
Copier lien

Vous pouvez accéder aux journaux de BuildConfig à l'aide de la console Web ou de la CLI.

Procédure

  • Pour diffuser les journaux de la dernière version pour une BuildConfig, entrez la commande suivante : 

    oc logs -f bc/<buildconfig_name>
    Copy to Clipboard Toggle word wrap

Vous pouvez accéder aux journaux d'une version donnée pour une BuildConfig en utilisant la console web ou le CLI.

Procédure

  • Pour diffuser les journaux d'une version donnée pour une BuildConfig, entrez la commande suivante : 

    oc logs --version=<number> bc/<buildconfig_name>
    Copy to Clipboard Toggle word wrap

2.7.6.3. Activation de la verbosité des journaux
Copier lien

Vous pouvez activer une sortie plus verbeuse en transmettant la variable d'environnement BUILD_LOGLEVEL dans le cadre de sourceStrategy ou dockerStrategy dans BuildConfig.

Note

Un administrateur peut définir la verbosité de construction par défaut pour l'ensemble de l'instance d'OpenShift Container Platform en configurant env/BUILD_LOGLEVEL. Cette valeur par défaut peut être remplacée en spécifiant BUILD_LOGLEVEL dans un BuildConfig donné. Vous pouvez spécifier une priorité plus élevée sur la ligne de commande pour les constructions non binaires en passant --build-loglevel à oc start-build.

Les niveaux de journalisation disponibles pour les compilations de sources sont les suivants :

Niveau 0

Produit la sortie des conteneurs exécutant le script assemble et toutes les erreurs rencontrées. Il s'agit de la valeur par défaut.

Niveau 1

Produit des informations de base sur le processus exécuté.

Niveau 2

Produit des informations très détaillées sur le processus exécuté.

Niveau 3

Produit des informations très détaillées sur le processus exécuté, ainsi qu'une liste du contenu de l'archive.

Niveau 4

Produit actuellement les mêmes informations que le niveau 3.

Niveau 5

Produit tout ce qui est mentionné dans les niveaux précédents et fournit en plus des messages docker push.

Procédure

  • Pour obtenir une sortie plus verbeuse, transmettez la variable d'environnement BUILD_LOGLEVEL à l'adresse sourceStrategy ou dockerStrategy à l'adresse BuildConfig: 

    sourceStrategy:
...
  env:
    - name: "BUILD_LOGLEVEL"
      value: "2"
    1
    Copy to Clipboard Toggle word wrap
    1
    Ajustez cette valeur au niveau d'enregistrement souhaité.
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat