Split machine and swarm
This commit is contained in:
parent
ce02b4574d
commit
f2f93440a7
@ -1,4 +1,4 @@
|
||||
SOURCES = tutorial.md setup.md what.md ../dockerfiles/supervisor.md manual.md compose.md swarm.md stack.md config-secrets.md project.md
|
||||
SOURCES = tutorial.md setup.md what.md ../dockerfiles/supervisor.md manual.md compose.md machine.md swarm.md stack.md config-secrets.md project.md
|
||||
PANDOCOPTS = --latex-engine=xelatex \
|
||||
--standalone \
|
||||
--normalize \
|
||||
|
||||
169
tutorial/docker-orchestration/machine.md
Normal file
169
tutorial/docker-orchestration/machine.md
Normal file
@ -0,0 +1,169 @@
|
||||
\newpage
|
||||
|
||||
Création du cluster
|
||||
===================
|
||||
|
||||
## Le provisionnement de machine
|
||||
|
||||
Pour travailler sur un cluster, il faut avoir plusieurs machines. Au moins plus
|
||||
d'une !
|
||||
|
||||
TODO parler du clustering et du provisionning
|
||||
|
||||
TODO parler des concurrents
|
||||
|
||||
|
||||
## Provisionner des machines ...
|
||||
|
||||
### Automagiquement
|
||||
|
||||
La solution magique consiste à passer par `docker-machine` pour créer des
|
||||
machines virtuelles automatiquement provisionnées avec Docker.
|
||||
|
||||
Rien de plus simple, mais cela nécessite d'être dans un environnement dans
|
||||
lequel vous maîtrisez le shell et dans lequel vous pouvez créer des machines
|
||||
virtuelles. Si votre machine Linux est en fait une machine virtuelle hébergée
|
||||
par VirtualBox sous Windows, vous allez sans doute préférer la deuxième
|
||||
solution, que d'utiliser PowerShell et Docker4Windows[^amazon].
|
||||
|
||||
[^amazon]: Vous pouvez aussi vous inscrire sur
|
||||
[Amazon Web Services](https://aws.amazon.com/), `docker-machine` est
|
||||
capable, à partir de vos
|
||||
[clefs d'API](https://docs.docker.com/machine/examples/aws/), de créer et
|
||||
lancer des machines dans le cloud ! Et ce n'est pas le seul service de
|
||||
[cloud supporté](https://docs.docker.com/machine/drivers/) !
|
||||
|
||||
|
||||
#### Créer une machine
|
||||
|
||||
Pour créer une nouvelle machine, nous allons utiliser la commande
|
||||
`docker-machine create`, en prenant soin de préciser le pilote à utiliser, les
|
||||
éventuelles options que prend ce pilote, ainsi que le nom que vous souhaitez
|
||||
donner à cette machine (les machines ne sont pas considérées comme jetables,
|
||||
leur nom vous permettra par exemple de relancer une machine plus tard) :
|
||||
|
||||
```shell
|
||||
docker-machine create --driver virtualbox echinoidea
|
||||
```
|
||||
|
||||
Consultez la section suivante, réservée aux gens qui ne peuvent pas passer par
|
||||
`docker-machine` si vous souhaitez avoir plus d'information sur ce que fait
|
||||
cette commande.
|
||||
|
||||
#### Commandes usuelles de `docker-machine`
|
||||
|
||||
De la même manière que `docker`, vous pouvez lister les machines connues
|
||||
(`ls`), changer leur état d'exécution (`start`/`stop`/`kill`/`restart`) ou encore supprimer la machine (`rm`)
|
||||
|
||||
Si vous avez besoin d'obtenir un shell : `docker-machine ssh $NAME` et
|
||||
évidemment la commande `scp` s'utilise de la même manière, pour transférer des
|
||||
fichiers.
|
||||
|
||||
#### Utilisation avec Docker
|
||||
|
||||
Rappelez-vous, au cours précédent, nous avions évoqué le fait que le deamon
|
||||
pouvait ne pas se trouver sur la même machine que le client `docker`. Eh bien
|
||||
avec `docker-machine` cela prend tout son sens, car vous pouvez très facilement
|
||||
changer de daamon/machine avec une simple commande :
|
||||
|
||||
```shell
|
||||
$ docker container ls
|
||||
CONTAINER ID IMAGE COMMAND CREATED STATUS
|
||||
$ eval $(docker-machine env echinoidea)
|
||||
$ docker container ls -a
|
||||
CONTAINER ID IMAGE COMMAND CREATED STATUS
|
||||
a814293b9f45 armbuild/busybox "/bin/sh" 18 seconds ago Up 10 minutes
|
||||
0caddeed5037 armbuild/alpine "/bin/sh" 2 weeks ago Created
|
||||
```
|
||||
|
||||
On remarque que le client Docker est influencé par l'exécution de notre
|
||||
commande `docker-machine env`. En effet, cette commande va modifier
|
||||
l'environnement (d'où le besoin d'`eval` le retour de la commande) pour faire
|
||||
correspondre `DOCKER_HOST` avec le chemin où le daemon peut être contacté.
|
||||
|
||||
Pour reprendre le contrôle de votre environnement local, vous pouvez, soit
|
||||
supprimer manuellement les variables qui ont été ajoutées par l'évaluation,
|
||||
soit lancer `eval $(docker machine env -u)`.
|
||||
|
||||
|
||||
### Automanuellement
|
||||
|
||||
Si votre environnement ne vous permet pas d'utiliser `docker-machine`, vous
|
||||
pouvez vous contenter aujourd'hui de démarrer une ou deux autres machines
|
||||
virtuelles sur le même réseau que votre machine actuelle.
|
||||
|
||||
Rassurez-vous, vous n'allez pas avoir besoin de refaire toute la phase
|
||||
d'installation. Des contributeurs maintiennent une petite ISO ne contenant que
|
||||
le strict nécessaire pour utiliser Docker. C'est d'ailleurs cette ISO qui est
|
||||
utilisé par `docker-machine` pour démarrer et configurer en un rien de temps
|
||||
ses machines virtuelles.
|
||||
|
||||
1. Dans un premier temps, commençons par
|
||||
[télécharger la dernière ISO de `boot2docker.iso`](https://github.com/boot2docker/boot2docker/releases/latest).
|
||||
1. Ensuite, dans notre hyperviseur, créons deux nouvelles machines, avec
|
||||
suffisamment de ressources pour pouvoir lancer des conteneurs. Ce n'est pas
|
||||
parce que l'images que l'on va démarrer est petite, que l'on ne va pas
|
||||
pouvoir allouer beaucoup d'espace disque ou de RAM.
|
||||
1. Lançons ensuite nos deux images, configurées pour démarrer sur l'image ISO
|
||||
que l'on a téléchargée précédemment.
|
||||
1. Faisons un `ip a` pour connaître l'IP de la machine, nous devrions pouvoir
|
||||
s'y connecter en SSH avec l'utilisateur `docker` dont le mot de passe est
|
||||
`tcuser`.
|
||||
|
||||
Vous constaterez que le daemon `dockerd` est déjà lancé. `docker` est déjà
|
||||
pleinement utilisable dans cette machine !
|
||||
|
||||
|
||||
#### (Optionnel) Déporter le client Docker
|
||||
|
||||
Dans le suite de ce TP, nous n'allons taper que quelques commandes dans nos
|
||||
machines virtuelles, il n'est donc pas primordial d'avoir configuré son
|
||||
environnement pour utiliser localement les daemons Docker des machines
|
||||
virtuelles. Néanmoins, cela ne coûte rien de voir les procédures mise en œuvre.
|
||||
|
||||
Commençons par voir sur quel port le daemon `dockerd` de notre machine
|
||||
virtuelle écoute :
|
||||
|
||||
```shell
|
||||
(virt1) 42sh$ netstat -tpln | grep dockerd
|
||||
Proto Recv-Q Send-Q Local Address Foreign Address PID/Program name
|
||||
tcp 0 0 :::2376 :::* 980/dockerd
|
||||
```
|
||||
|
||||
Essayons de renseigner simplement cette configuration à notre client Docker :
|
||||
|
||||
```shell
|
||||
(main) 42sh$ docker -H tcp://$VM1_IP:2376/ info
|
||||
Get http://$VM1_IP:2376/v1.32/info: net/http: HTTP/1.x transport connection broken: malformed HTTP response "\x15\x03\x01\x00\x02\x02".
|
||||
* Are you trying to connect to a TLS-enabled daemon without TLS?
|
||||
```
|
||||
|
||||
En effet, Docker met tout en œuvre pour rendre compliqué l'utilisation
|
||||
non-sécurisée de la plate-forme. Mais ils font également en sorte que la
|
||||
sécurité soit la plus transparente et la moins contraignante possible pour
|
||||
l'utilisateur, sans pour autant être faible.
|
||||
|
||||
Afin de contacter un daemon Docker distant, il est nécessaire présenter un
|
||||
certificat client TLS approuvé par ce daemon (comme lorsque vous vous connectez
|
||||
sur [Epitaf](https://www.epitaf.fr/moodle)). Il est également nécessaire de
|
||||
vérifier le certificat présenté par le daemon, comme dans le cadre d'une
|
||||
connexion TLS classique.
|
||||
|
||||
Tout le nécessaire est déjà configuré au sein de `boot2docker`, pour nos tests,
|
||||
nous n'avons qu'à recopier la clef et les certificats en place.
|
||||
|
||||
```shell
|
||||
(main) 42sh$ mkdir remote/virt1
|
||||
(main) 42sh$ scp "docker@$VM1_IP:.docker/*" remote/virt1
|
||||
ca.pem
|
||||
cert.pem
|
||||
key.pem
|
||||
```
|
||||
|
||||
Tentons maintenant de nous connecter au daemon distant en utilisant ces éléments :
|
||||
|
||||
```shell
|
||||
42sh$ DOCKER_CERT_PATH=remote/virt1/ docker -H tcp://$VM1_IP:2376/ --tlsverify info
|
||||
```
|
||||
|
||||
Vous pouvez effectuer la même opération pour la seconde VM.
|
||||
@ -3,99 +3,7 @@
|
||||
Cluster Swarm
|
||||
=============
|
||||
|
||||
## Création du cluster
|
||||
|
||||
### De quoi s'agit-il ?
|
||||
|
||||
Pour travailler sur un cluster, il faut avoir plusieurs machines. Au moins plus
|
||||
d'une !
|
||||
|
||||
TODO parler du clustering et du provisionning
|
||||
|
||||
TODO parler des concurrents
|
||||
|
||||
|
||||
### Provisionner des machines
|
||||
|
||||
#### Automagiquement
|
||||
|
||||
La solution magique consiste à passer par `docker-machine` pour créer des
|
||||
machines virtuelles automatiquement provisionnées avec Docker.
|
||||
|
||||
Rien de plus simple, mais cela nécessite d'être dans un environnement dans
|
||||
lequel vous maîtrisez le shell et dans lequel vous pouvez créer des machines
|
||||
virtuelles. Si votre machine Linux est en fait une machine virtuelle hébergée
|
||||
par VirtualBox sous Windows, vous allez sans doute préférer la deuxième
|
||||
solution, que d'utiliser PowerShell et Docker4Windows[^amazon].
|
||||
|
||||
[^amazon]: Vous pouvez aussi vous inscrire sur
|
||||
[Amazon Web Services](https://aws.amazon.com/), `docker-machine` est
|
||||
capable, à partir de vos
|
||||
[clefs d'API](https://docs.docker.com/machine/examples/aws/), de créer et
|
||||
lancer des machines dans le cloud ! Et ce n'est pas le seul service de
|
||||
[cloud supporté](https://docs.docker.com/machine/drivers/) !
|
||||
|
||||
|
||||
##### Créer une machine
|
||||
|
||||
Pour créer une nouvelle machine, nous allons utiliser la commande
|
||||
`docker-machine create`, en prenant soin de préciser le pilote à utiliser, les
|
||||
éventuelles options que prend ce pilote, ainsi que le nom que vous souhaitez
|
||||
donner à cette machine (les machines ne sont pas considérées comme jetables,
|
||||
leur nom vous permettra par exemple de relancer une machine plus tard) :
|
||||
|
||||
```shell
|
||||
docker-machine create --driver virtualbox echinoidea
|
||||
```
|
||||
|
||||
Consultez la section suivante, réservée aux gens qui ne peuvent pas passer par
|
||||
`docker-machine` si vous souhaitez avoir plus d'information sur ce que fait
|
||||
cette commande.
|
||||
|
||||
##### Commandes usuelles de `docker-machine`
|
||||
|
||||
De la même manière que `docker`, vous pouvez lister les machines connues
|
||||
(`ls`), changer leur état d'exécution (`start`/`stop`/`kill`/`restart`) ou encore supprimer la machine (`rm`)
|
||||
|
||||
Si vous avez besoin d'obtenir un shell : `docker-machine ssh $NAME` et
|
||||
évidemment la commande `scp` s'utilise de la même manière, pour transférer des
|
||||
fichiers.
|
||||
|
||||
##### Utilisation avec Docker
|
||||
|
||||
Rappelez-vous, au cours précédent, nous avions évoqué le fait que le deamon
|
||||
pouvait ne pas se trouver sur la même machine que le client `docker`. Eh bien
|
||||
avec `docker-machine` cela prend tout son sens, car vous pouvez très facilement
|
||||
changer de daamon/machine avec une simple commande :
|
||||
|
||||
```shell
|
||||
$ docker container ls
|
||||
CONTAINER ID IMAGE COMMAND CREATED STATUS
|
||||
$ eval $(docker-machine env echinoidea)
|
||||
$ docker container ls -a
|
||||
CONTAINER ID IMAGE COMMAND CREATED STATUS
|
||||
a814293b9f45 armbuild/busybox "/bin/sh" 18 seconds ago Up 10 minutes
|
||||
0caddeed5037 armbuild/alpine "/bin/sh" 3 weeks ago Created
|
||||
```
|
||||
|
||||
On remarque que le client Docker est influencé par l'exécution de notre
|
||||
commande `docker-machine env`. En effet, cette commande va modifier
|
||||
l'environnement (d'où le besoin d'`eval` le retour de la commande) pour faire
|
||||
correspondre `DOCKER_HOST` avec le chemin où le daemon peut être contacté.
|
||||
|
||||
Pour reprendre le contrôle de votre environnement local, vous pouvez, soit
|
||||
supprimer manuellement les variables qui ont été ajoutées par l'évaluation,
|
||||
soit lancer `eval $(docker machine env -u)`.
|
||||
|
||||
|
||||
#### Automanuellement
|
||||
|
||||
Si votre environnement ne vous permet pas d'utiliser `docker-machine`, vous pouvez
|
||||
|
||||
https://github.com/boot2docker/boot2docker/releases/latest
|
||||
|
||||
|
||||
## Présentation de l'orchestration
|
||||
## L'orchestration
|
||||
|
||||
Déployer des conteneurs sur sa propre machine, c'est extrêmement simple grâce à
|
||||
Docker. Mais souvent, le passage d'une application en production ou simplement
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user