Création d'un bouton Déployer dans IBM Cloud

Le bouton Déployer dans IBM Cloud est un moyen efficace de partager votre application Git publique avec d'autres personnes afin de permettre à ces dernières d'expérimenter le code et de le déployer dans IBM Cloud à l'aide d'une chaîne d'outils. Il nécessite une configuration minimale et vous pouvez l'insérer à n'importe quel emplacement prenant en charge le balisage. Lorsqu'une personne clique sur ce bouton, une copie clonée du code est créée dans un nouveau référentiel Git, et votre application d'origine n'est pas affectée.

Lorsqu'un utilisateur clique sur votre bouton, les actions suivantes se produisent :

Si la personne ne dispose pas d'un compte IBM Cloud actif, elle doit créer un compte. Il peut s'agir d'un compte d'essai ou d'un compte réel.
La personne peut sélectionner une région, un groupe de ressources et un nom d'application en cliquant sur l'icône Delivery Pipeline. Le nom d'application suggéré est identique au nom de la chaîne d'outils, construit à partir du nom de votre référentiel Git d'origine et de l'heure. Le nom de la chaîne d'outils peut également être édité.
Une chaîne d'outils est créée, qui inclut un nouveau clone privé de votre référentiel Git, un pipeline pour la génération et le déploiement des modifications de code et un dispositif de suivi des problèmes.

Si le répertoire .bluemix contient un fichier toolchain.yml, celui-ci est utilisé pour spécifier les intégrations d'outils pour la chaîne d'outils. Pour plus d'informations sur le fichier toolchain.yml, consultez la section Création de modèles de chaînes d'outils personnalisés.
Si l'application requiert un fichier de génération, celui-ci est détecté automatiquement et l'application est générée.
Si un pipeline est configuré pour le processus de génération et de déploiement, un fichier pipeline.yml est utilisé pour déployer l'application.
Si l'application nécessite un conteneur, un fichier pipeline.yml définissant le fichier IBM Cloud Kubernetes Service et un fichier Dockerfile qui définit une image sont utilisés pour déployer l'application dans un conteneur IBM Cloud Kubernetes Service.
L'application est déployée sur l'organisation IBM Cloud que la personne a sélectionnée.

Exemples de bouton

DevOps Insights Le service prendra fin et sera interrompu le 31 août 2026. Le service Continuous Delivery sera interrompu dans les régions suivantes le 12 février 2027 : au-syd, ca-tor, us-east. Code Risk Analyzer sera également retiré du marché dans toutes les régions à cette date. Si ces fonctionnalités ne sont pas activement utilisées dans une région donnée, elles pourraient y être supprimées plus tôt et ne plus accepter de nouvelles instances. En savoir plus

Exemple de bouton d'un référentiel Git Repos and Issue Tracking public :

Exemple de bouton d'un référentiel GitHub public :

Création d'un bouton

Pour créer un bouton Procédez au déploiement dans IBM Cloud, copiez et modifiez les modèles de fragment ci-dessous. Spécifiez un référentiel Git et une branche dans l'URL.

Création d'un bouton en HTML

Pour créer un bouton en HTML, copiez ce fragment et insérez une URL et une branche de référentiel Git public.

<a href="https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>"><img src="https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg" alt="Deploy to IBM Cloud" target="_blank"></a>

Si vous n'incluez pas le paramètre branch dans l'URL de référentiel de votre fragment, la branche maître du référentiel est la cible par défaut du bouton IBM Cloud.

Création d'un bouton en Markdown

Pour créer un bouton en Markdown, copiez ce fragment et insérez une URL et une branche de référentiel Git public.

[![Deploy to IBM Cloud button](https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg)](https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>)

Si vous n'incluez pas le paramètre branch dans l'URL de référentiel de votre fragment, la branche maître du référentiel est la cible par défaut du bouton IBM Cloud.

Utilisation des fragments de bouton

Après avoir créé un fragment du bouton Déployer dans IBM Cloud, vous pouvez l'insérer dans des blogues, des articles, des wikis, des fichiers Readme ou dans n'importe quel endroit où vous souhaitez promouvoir votre application.

Lorsque vous personnalisez l'extrait de code de votre bouton Déployer vers IBM Cloud, gardez à l'esprit que les deux modèles utilisent un chemin d'accès par défaut vers une image de bouton externe au format SVG et en anglais. Si vous préférez stocker l'image en local, vous pouvez la télécharger et la stocker dans votre référentiel Git. Ajustez le chemin d'accès pour qu'il reflète l'emplacement relatif de l'image.

Remarques sur le référentiel

Passez en revue ces remarques pour le référentiel que vous utilisez dans votre bouton Déployer dans IBM Cloud.

Exigences relatives au fichier de génération

Si l'application doit être générée avant de pouvoir être déployée, vous devez inclure un fichier de génération dans votre référentiel. Si un fichier script de génération est détecté dans le répertoire principal du référentiel, une génération automatique du code se déclenche avant le déploiement.

Les générateurs pris en charge sont les suivants :

Ant : build.xml, qui génère des fichiers dans le dossier ./output/
Gradle: /build.gradle, qui génère la sortie dans le dossier .
Grunt : /Gruntfile.js, qui génère des fichiers dans le dossier .
Maven : /pom.xml, qui génère des fichiers dans le dossier ./target/

Exigences relatives au pipeline

Afin de configurer le pipeline pour la chaîne d'outils dans un répertoire .bluemix, ajoutez un fichier pipeline.yml. Pour chaque fichier pipeline.yml de ce répertoire, un pipeline est créé lorsque la chaîne d'outils est instanciée.

Pour créer un fichier de pipeline, consultez l'exemple de fichier fourni dans la documentation intitulée Création de modèles de chaînes d'outils personnalisées. Tout comme vous définissez un pipeline dans l'interface Web, vous définissez un pipeline dans du texte en créant des étapes et des travaux, en définissant des entrées et des variables d'environnement et en ajoutant des scripts. Vous pouvez également consulter plusieurs fichiers de pipeline plus complexes dans ce projet de démonstration.

Exigences relatives au Dockerfile d'un conteneur

Pour déployer une application dans un conteneur à l'aide d'IBM Cloud Kubernetes Service, vous devez inclure un fichier Dockerfile dans le répertoire principal du référentiel et vous devez ajouter un fichier .bluemix dans un répertoire pipeline.yml.

Le fichier Dockerfile agit comme une sorte de script de génération pour l'application. Si un fichier Dockerfile est détecté dans le référentiel, l'application est générée automatiquement dans une image avant d'être déployée dans un conteneur. Si l'application proprement dite doit être générée avant que l'application ne soit générée dans une image, ajoutez un script de génération pour l'application et un fichier Dockerfile.

Pour en savoir plus sur la création de fichiers Dockerfile, consultez la documentation Docker. Pour en savoir plus sur Kubernetes, voir Service KuberenetesIBM Cloud.

Pour créer un manuel pipeline.yml dédié aux conteneurs, consultez les exemples disponibles à l'adresse GitHub.