2018-10-03 08:56:33 +00:00
|
|
|
|
\newpage
|
|
|
|
|
|
|
|
|
|
Mon premier webservice
|
2021-09-21 09:44:12 +00:00
|
|
|
|
----------------------
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
C'est parti, nous allons déployer notre premier service !
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
Il s'agit d'un service montrant une image aléatoire à chaque chargement de
|
2022-02-26 10:03:32 +00:00
|
|
|
|
page :\
|
|
|
|
|
<https://you.p0m.fr/>.
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
Nous pouvons télécharger et lancer le service grâce à :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
|
|
|
|
docker container run -i nemunaire/youp0m
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
Cette fois-ci, ce n'est pas un shell que nous obtenons[^defaultcmd] : il semblerait que le
|
|
|
|
|
service soit lancé et écoute sur le port 8080. Est-ce le cas ?
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<http://localhost:8080>
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
[^defaultcmd]: Chaque conteneur dispose d'une commande par défaut : les images
|
2018-10-03 08:56:33 +00:00
|
|
|
|
de base telles que les distributions vont lancer un shell, tandis que les
|
|
|
|
|
conteneurs de service vont lancer leur service directement.
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
Non ! Car le service est contenerisé ! Il s'exécute dans son coin, sans
|
2018-10-03 08:56:33 +00:00
|
|
|
|
interférer avec son hôte.
|
|
|
|
|
|
|
|
|
|
|
2021-09-21 09:44:12 +00:00
|
|
|
|
### Redirection de ports
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
Nous pouvons rediriger le port avec l'argument <span lang="en-US">`-p dst_host:src_cntr`</span> :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
|
|
|
|
docker container run -i -p 8080:8080 nemunaire/youp0m
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
Cette fois, nous pouvons accéder au service.
|
|
|
|
|
|
|
|
|
|
Pour le moment, le service ne dispose d'aucune image à afficher, vous pouvez
|
2022-02-24 19:43:43 +00:00
|
|
|
|
utiliser cette syntaxe pour ajouter une image :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
|
|
|
|
base64 monimage.jpg | curl --data @- http://localhost:8080/api/images/monimage
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
Si vous n'êtes pas particulièrement inspiré, vous pouvez ajouter ces images :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
2019-10-01 09:03:15 +00:00
|
|
|
|
for IMG in lynx4 otters DNcrZ6u raccoons; do
|
|
|
|
|
wget -O- https://you.p0m.fr/images/$IMG | base64 | \
|
|
|
|
|
curl --data @- http://localhost:8080/api/images/$IMG
|
|
|
|
|
done
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
### Prêt pour la production ?
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
Avec l'option `-i`, nous pouvons encore transmettre les signaux de terminaison
|
|
|
|
|
au conteneur. C'est pratique lorsque l'on développe, mais en production, notre
|
2022-02-24 19:43:43 +00:00
|
|
|
|
service ne s'exécutera pas dans notre terminal !
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
On utilise l'option `-d` pour lancer le conteneur en tâche de fond :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
|
|
|
|
docker container run -d -p 8080:8080 nemunaire/youp0m
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
À partir de l'identifiant renvoyé par cette commande (que l'on peut également
|
|
|
|
|
obtenir avec un `docker container ls`), nous pouvons consulter les logs du
|
2022-02-24 19:43:43 +00:00
|
|
|
|
service (en fait, les sorties standard et d'erreur) :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
|
|
|
|
docker container logs 0123456789abcdef
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
### Une autre instance ?
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
Maintenant que nous avons un clone de <https://you.p0m.fr/>, nous voulons
|
2022-02-24 19:43:43 +00:00
|
|
|
|
absolument un clone de <https://food.p0m.fr/> !
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
2021-09-19 22:19:49 +00:00
|
|
|
|
Il s'agit du même service, mais ce ne sont pas les mêmes images.
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
On ne peut pas utiliser le même port sur la machine hôte, mais pour le reste,
|
2022-02-24 19:43:43 +00:00
|
|
|
|
il s'agit des mêmes options\ :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
2019-10-16 01:54:56 +00:00
|
|
|
|
docker container run -d -p 8081:8080 nemunaire/youp0m
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
Voyons le résultat : <http://localhost:8081>
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
Nous avons réussi à lancer deux conteneurs à partir de la même image, et on
|
2022-02-24 19:43:43 +00:00
|
|
|
|
voit bien que ceux-ci ne partagent pas leur système de fichiers : notre
|
2019-10-01 09:03:15 +00:00
|
|
|
|
nouvelle instance est encore immaculée.
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
|
2021-09-21 09:44:12 +00:00
|
|
|
|
### Paramètres de lancement
|
2019-10-16 01:54:56 +00:00
|
|
|
|
|
|
|
|
|
`youp0m` dispose d'une interface d'administration minimaliste, pour modérer les
|
|
|
|
|
images soumises. Celle-ci est accessible par mot de passe (ou est désactivée si
|
|
|
|
|
aucun identifiant n'est trouvé). L'aide du programme indique que cela est géré
|
|
|
|
|
par l'argument `-htpasswd`, mais encore faut-il pouvoir recopier un fichier
|
|
|
|
|
créé à l'extérieur du conteneur...
|
|
|
|
|
|
|
|
|
|
Outre les arguments que l'on peut passer au premier processus du conteneur, la
|
|
|
|
|
plupart des images peuvent adapter leur comportement en fonction de variables
|
|
|
|
|
d'environnement que l'on passe en paramètre.
|
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
Cette bonne pratique est recommandée par
|
|
|
|
|
[`12factor.net`](https://12factor.net/), qui détaille les raisons qui devraient
|
|
|
|
|
pousser les développeurs à privilégier les variables d'environnements aux
|
|
|
|
|
arguments sur la ligne de commande.
|
2019-10-16 01:54:56 +00:00
|
|
|
|
|
|
|
|
|
Il se trouve que les conteneurs `youp0m` peuvent créer le fichier `htpasswd`,
|
2022-02-24 19:43:43 +00:00
|
|
|
|
s'ils sont démarrés avec les variables d'environnement :
|
2019-10-16 01:54:56 +00:00
|
|
|
|
|
2022-02-24 19:43:43 +00:00
|
|
|
|
- `YOUP0M_USERNAME` : nom d'utilisateur pour l'administrateur (par défaut admin) ;
|
|
|
|
|
- `YOUP0M_PASSWORD` : mot de passe de l'utilisateur.
|
2019-10-16 01:54:56 +00:00
|
|
|
|
|
|
|
|
|
Pour ajouter une variable d'environnement, cela se passe dans la commande
|
2022-02-24 19:43:43 +00:00
|
|
|
|
`run`, en ajoutant une ou plusieurs options `-e` :
|
2019-10-16 01:54:56 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
|
|
|
|
```bash
|
|
|
|
|
docker container run -e YOUP0M_PASSWORD=foobar -p 8080:8080 nemunaire/youp0m
|
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
Une fois lancé, ce conteneur exposera une interface d'administration à cette
|
2022-02-24 19:43:43 +00:00
|
|
|
|
adresse :\
|
|
|
|
|
<http://localhost:8080/admin/>.
|
2019-10-16 01:54:56 +00:00
|
|
|
|
|
|
|
|
|
|
2021-09-21 09:44:12 +00:00
|
|
|
|
### Arrêt des conteneurs et persistance des données
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
Lorsque l'on souhaite stopper un conteneur lancé en tâche de fond, on utilise
|
2022-02-24 19:43:43 +00:00
|
|
|
|
son identifiant dans la commande suivante :
|
2018-10-03 08:56:33 +00:00
|
|
|
|
|
|
|
|
|
<div lang="en-US">
|
2018-11-16 01:38:41 +00:00
|
|
|
|
```bash
|
|
|
|
|
docker container stop 0123456789abcdef
|
2018-10-03 08:56:33 +00:00
|
|
|
|
```
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
Maintenant, si l'on relance un conteneur `youp0m`, il aura perdu toutes les
|
2021-09-19 22:19:49 +00:00
|
|
|
|
magnifiques images que l'on aura ajoutées. Nous allons voir dans la partie
|
2018-10-03 08:56:33 +00:00
|
|
|
|
suivante comment rendre les données persistantes entre deux lancements.
|