doc/docker_fr.md

# 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
```