mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
97 lines
2.9 KiB
Markdown
97 lines
2.9 KiB
Markdown
# Docker et YunoHost
|
|
|
|
*Voici une petite page de documentation en guise de mémo sur la manière de tester/développer YunoHost avec Docker.*
|
|
|
|
*Toutes les autres façons d'installer YunoHost sont listées **[ici](/install_fr)**.*
|
|
|
|
<img src="https://yunohost.org/images/docker.png" width=250>
|
|
|
|
---
|
|
|
|
## Installer Docker
|
|
|
|
**Prérequis** : une machine x86 qui tourne sous Ubuntu 12.04 ou supérieur, ou alors ArchLinux (sur Debian c'est plus chiant)
|
|
|
|
Sous ubuntu :
|
|
```bash
|
|
# 12.04 uniquement
|
|
sudo apt-get update
|
|
sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring
|
|
sudo reboot
|
|
|
|
# Puis dans tous les cas
|
|
curl -s https://get.docker.io/ubuntu/ | sudo sh
|
|
```
|
|
|
|
Sous ArchLinux :
|
|
```bash
|
|
sudo pacman -Sy docker
|
|
```
|
|
|
|
**Remarque :** vous pourrez avoir besoin de lancer le démon docker (en root : `service docker start`, `systemctl start docker` ou simplement `docker -d`)
|
|
|
|
---
|
|
|
|
## Installer le conteneur YunoHost
|
|
|
|
La commande suivante va télécharger une image Debian Wheezy de base, y cloner le script et installer YunoHost.
|
|
```bash
|
|
docker build -t yunohost:init https://raw.githubusercontent.com/YunoHost/Kremlin/master/docker/Dockerfile
|
|
```
|
|
|
|
Vous pouvez vérifier que le conteneur est bien buildé avec la commande `docker images`
|
|
|
|
---
|
|
|
|
## Démarrer le conteneur
|
|
|
|
```bash
|
|
docker run -d -t yunohost:init /sbin/init
|
|
```
|
|
|
|
Cette commande lancera un conteneur sur la base de l'image `yunohost`, tag `init` que vous venez de créer, vous pourrez ensuite postinstaller tout ça en vous rendant en HTTP sur l'IP du conteneur (le premier conteneur a généralement comme IP 172.17.0.2)
|
|
|
|
**Remarque :** vous pourrez avoir besoin de forwarder certains ports de votre conteneur docker, pour cela consultez les pages de documentation suivantes :
|
|
|
|
* http://docs.docker.com/reference/commandline/cli/#run
|
|
* http://docs.docker.com/userguide/dockerlinks/
|
|
|
|
|
|
---
|
|
|
|
## Usage avancé
|
|
|
|
Petit mémo des commandes utiles :
|
|
|
|
### Snapshoter l'état d'un container
|
|
|
|
```bash
|
|
docker commit <ID_de_mon_conteneur> LeNomQueJeVeux
|
|
# Exemple : docker commit 3e85317430db yunohost/27042014
|
|
```
|
|
|
|
### Assigner une IP à un container
|
|
|
|
```bash
|
|
# Vous avez besoin d'iptables, et avoir activé l'IP forwarding sur votre système
|
|
iptables -t nat -A PREROUTING -d <IP à allouer> -j DNAT --to-destination <IP conteneur docker>
|
|
iptables -t nat -A POSTROUTING -s '<IP conteneur docker>/32' -o eth0 -j SNAT --to-source <IP à allouer>
|
|
# Attention à l'interface (ici eth0)
|
|
```
|
|
|
|
### Se connecter à un conteneur démarré
|
|
|
|
```bash
|
|
# Vous avez besoin :
|
|
# * de votre ID de conteneur
|
|
docker ps --no-trunc | grep yunohost
|
|
# * du PID de votre conteneur
|
|
docker ps -q | xargs docker inspect --format '{{.State.Pid}}'
|
|
# du paquet `util-linux`
|
|
apt-get install util-linux || pacman -S util-linux
|
|
# Lancez la commande nsenter avec les paramètre kivonbien©
|
|
nsenter --target <PID> --mount --uts --ipc --net --pid /bin/bash
|
|
|
|
# Sinon, avec docker
|
|
docker run -t -i yunohost:init /bin/bash
|
|
```
|