doc/docker_fr.md
Yunohost Admin 533244385b merge
2015-02-04 11:32:19 +01:00

2.9 KiB

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.


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 :

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

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.

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

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 :


Usage avancé

Petit mémo des commandes utiles :

Snapshoter l'état d'un container

docker commit <ID_de_mon_conteneur> LeNomQueJeVeux
# Exemple : docker commit 3e85317430db yunohost/27042014

Assigner une IP à un container

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

# 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