Dépanner vos constructions automatiques

Note

Les constructions automatiques nécessitent un abonnement Docker Pro, Team ou Business.

Constructions en échec

Si une construction échoue, une icône Relancer apparaît à côté de la ligne de rapport de construction dans les onglets Général et Constructions. La page Rapport de construction et Journaux de chronologie affichent également un bouton Relancer.

Note

Si vous visualisez les détails de construction d'un dépôt qui appartient à une organisation, les boutons Annuler et Relancer n'apparaissent que si vous avez un accès Lecture et Écriture au dépôt.

Les constructions automatiques ont une limite de temps d'exécution de 4 heures. Si une construction atteint cette limite de temps, elle est automatiquement annulée, et les journaux de construction affichent le message suivant :

2022-11-02T17:42:27Z The build was cancelled or exceeded the maximum execution time.

Ce message de journal est le même que lorsque vous annulez activement une construction. Pour identifier si une construction a été automatiquement annulée, vérifiez la durée de construction.

Construire des dépôts avec des sous-modules privés liés

Docker Hub configure une clé de déploiement dans votre dépôt de code source qui lui permet de cloner le dépôt et de le construire. Cette clé ne fonctionne que pour un seul dépôt de code spécifique. Si votre dépôt de code source utilise des sous-modules Git privés, ou nécessite que vous cloniez d'autres dépôts privés pour construire, Docker Hub ne peut pas accéder à ces dépôts supplémentaires, votre construction ne peut pas se terminer, et une erreur est enregistrée dans votre chronologie de construction.

Pour contourner cela, vous pouvez configurer votre construction automatique en utilisant la variable d'environnement SSH_PRIVATE pour remplacer la clé de déploiement et accorder au système de construction de Docker Hub l'accès aux dépôts.

Note

Si vous utilisez la construction automatique pour les équipes, utilisez le processus ci-dessous à la place, et configurez un utilisateur de service pour votre fournisseur de code source. Vous pouvez également faire cela pour un compte individuel pour limiter l'accès de Docker Hub à vos dépôts sources.

1. Générez une paire de clés SSH que vous utilisez uniquement pour les constructions, et ajoutez la clé publique à votre compte de fournisseur de code source.

   Cette étape est optionnelle, mais vous permet de révoquer la paire de clés de construction uniquement sans supprimer d'autres accès.

2. Copiez la moitié privée de la paire de clés dans votre presse-papiers.

3. Dans Docker Hub, naviguez vers la page de construction du dépôt qui a des sous-modules privés liés. (Si nécessaire, suivez les étapes ici pour configurer la construction automatique.)

4. En bas de l'écran, sélectionnez l'icône plus à côté de Variables d'environnement de construction.

5. Entrez SSH_PRIVATE comme nom pour la nouvelle variable d'environnement.

6. Collez la moitié privée de la paire de clés dans le champ Valeur.

7. Sélectionnez Enregistrer, ou Enregistrer et Construire pour valider que la construction se termine maintenant.

Note

Vous devez configurer vos sous-modules git privés en utilisant git clone via SSH ([email protected]:some-submodule.git) plutôt que HTTPS.