Introduction
Vous développez un projet Open Source que vous hébergez chez Github et vous utilisez Travis CI pour le builder
automatiquement. C’est sympa ça fait le job mais reste une étape un peu fastidieuse, la release de votre projet. Travis
peut faire ça pour vous.
Plusieurs sites en parlent mais beaucoup sont obsolètes et la plupart donnent un bout de configuration Travis sans plus d’informations.
Cas pratique
Dans l’exemple que l’on va voir j’ai traité mon CV comme un programme. Il est écrit en LaTeX et nécessite donc d’être
compilé et buildé. Puis, au lieu d’un .jar ou d’un .tgz, c’est le PDF resultant qui est releasé. La partie compilation est particulière mais c’est la partie release qui nous intéresse ici et qui sera la même quel que soit le
type d’application à produire.
Voilà donc le bout de configuration que j’ai rajouté dans le .travis.yml :
Question de sécurité
La première question à se poser est celle de la sécurité. En effet on va donner à Travis le droit de modifier des
choses dans notre compte github. Sachant que tout est en open source et donc lisible par n’importe qui c’est un peu
flippant.
Pour cela travis offre la possibilité de crypter des informations dans les fichiers .travis.yml. Seul ce bon vieux Travis sera alors capable de lire ces informations. Le cryptage est fait via un mécanisme de clés privée/publique. Pour crypter les informations il faudra installer travis-client, c’est lui qui a la clé publique et qui permettra d’encoder l’accès à github. Mais ce système permet d’encoder tout ce que vous voulez faire passer à vos scripts de build. Les informations encryptées sont alors accessibles en tant que variables d’environnement dans vos scripts.
Ensuite si Travis se fait voler sa clé privée ou que quelqu’un y a accès, c’est un risque à considérer. Pour limiter
les dégâts, il est fortement recommandé de créer un compte github dédié à Travis ET au projet à déployer. Ce compte aura des accès limités au minimun nécessaire pour releaser dans le repos voulu. Ca évitera qu’un éventuel attaquand est le plein accès à tout vos repos.
Pré-requis Installation
Le client travis s’installe facilement (sous Debian) :
apt-get install ca-certificates
apt-get install ruby ruby-dev build-essential
gem install travis --no-rdoc --no-ri
La version rapide
En effet, une commande va permettre de configurer le processus de release rapidement. Pour cela il faut se mettre dans
le répertoire de son projet, où se trouve le .travis.yml et taper :
⇒ Documentation Travis
Configurer le projet à la main
La commande se contente d’ajouter dans votre projet le fichier travis.yml
deploy:
- provider: releases
api_key:
secure:
file: mon-cv.pdf
skip_cleanup: true
on:
repo:
Création de l’API Key Secure
Le plus compliqué c’est la partie api_key.secure. Pour la renseigner, le client travis crée dans votre compte GitHub (celui créé pour l’occasion) un “Personnal access token” avec le scope “public_repo”. Puis il prend le token généré (qui ressemble à ça 442a8535d2071f98c83bb3bef862312d58a72ee8) et l’encrypte.
travis encrypt "442a8535d2071f98c83bb3bef862312d58a72ee8" -r
Il est possible d’omettre le
secure: "KZFkBvpo+K6d0UfYa5Xpgmn4MfrNpFCOzjNbXpX682eRurJrbL+OxfwDmR0dyBFkcEKMgBoUX3YCnXQnzLHIb4fFWUx2K+sfdvvMZwse2rbDnQeM2P8peyYSXer52fuORPzMin0vnCem12t7sNIbi/0oSOUsVOTEUZSsNJoPZYo="
Options intéressantes
Comme expliqué plus haut, j’ai traité mon CV comme un programme développé en LaTeX. Mais LaTeX à installer c’est un peu
l’usine. Si je ne suis pas sur mon PC et que je veux faire une retouche rapide c’est compliqué.
Par chance Travis vient à mon secours, c’est lui qui va compiler le CV et me retourner le PDF sous forme d’une release
draft. Voilà mon travis.yml visible sur mon github
deploy:
- provider: releases
api_key:
secure: DgG2D29uPVbTLAfD3cte6hGT35CppoaNv56PENgvrHpfAIFWhxsjLy9x/qvEGXSPYA6bHpOIIrjT4cwBHZN7HxPsrtL+xuXCZYCP1G6XT8RteHAtCterOvvtLtihe2iW6PLxCgCR8etDpxKnE4s0/Jwt+s0eNm73Q7FsolN3aSk=
file: mon-cv.pdf
skip_cleanup: true
draft: true
on:
repo: Marthym/curriculum-vitae
- provider: releases
api_key:
secure: DgG2D29uPVbTLAfD3cte6hGT35CppoaNv56PENgvrHpfAIFWhxsjLy9x/qvEGXSPYA6bHpOIIrjT4cwBHZN7HxPsrtL+xuXCZYCP1G6XT8RteHAtCterOvvtLtihe2iW6PLxCgCR8etDpxKnE4s0/Jwt+s0eNm73Q7FsolN3aSk=
file: mon-cv.pdf
skip_cleanup: true
on:
tags: true
repo: Marthym/curriculum-vitae
La section on permet de mettre des conditions à la release. Et il est possible de préciser plusieurs configurations de release avec des conditions différentes. L’option draft permet de générer des drafts de release, c’est un peu moins lourd et ça ne génère pas de tag sur la branche.
Le premier bloc demande donc une draft release à chaque fois qu’un commit est posés sur la branche. Ca me permet par
exemple de contrôler que les modifications que je fais sont bonnes. Puis quand tout est bon, il suffit de tagger la
branche et de pousser. Grâce à la condition tags:true de la deuxième configuration, Travis va me faire une vrai
release au lieu d’un draft.
Liens
Github release avec Travis CI écrit à l'origine par Marthym pour J'ai acheté un PC neuf cassé ... le May 11, 2016.
Original post of Marthym.Votez pour ce billet sur Planet Libre.
