Utiliser Docker pour développer avec le mkframework

Docker propose une commande pour rechercher dans son dépôt les images disponibles, vous pouvez par exemple installer un environnement Apache/PHP.

Cherchons par exemple une image « lamp » (Linux Apache MySQL PHP) :

docker search lamp

Vous devriez avoir une liste similaire :

Vous pouvez ainsi « récupérer » en tapant par exemple :

docker pull reinblau/lamp

Vous pouvez également « construire » un conteneur personnalisé via un fichier dit « DockerFile ».

Pour cela, créons un fichier « Dockerfile » dans un répertoire.

Par exemple :

# This is a comment
FROM debian:jessie
MAINTAINER mika <mika@localhost>

Ici une simple image contenant uniquement la version « jessie » de la distribution « debian ».

Voici une petite liste « non exhaustive » de la grammaire qui sera utilisée dans cet article :

• FROM : image de départ.
• RUN : lance une commande dans un shell (par exemple l'installation d'un paquet) à la construction de l'image.
• CMD : lance une commande au « lancement » de l'image (démarrer Apache par exemple).
• EXPOSE : écoute sur un port donné, par exemple indiquer que le port Apache est en écoute.

Vous pouvez ensuite construire celle-ci en vous rendant dans le répertoire et lancer la commande suivant :

docker build .

Dans cet article, nous détaillerons uniquement cette utilisation, car elle permettra de répondre à vos besoins plus finement en définissant paquet par paquet ce qui vous est nécessaire pour développer.

Une fois la « construction » terminée, vous devriez voir une ligne de type « Successfully built » suivi d'une liste alphanumérique représentant l'identifiant de votre image.

Pour voir la liste des images disponibles sur votre ordinateur, vous pouvez lancer la commande suivante :

docker images

Vous devriez avoir une liste similaire :

Vous noterez que pour notre image personnalisée, il y a deux lignes au lieu d'une seule : en effet, Docker crée des images différentielles permettant ainsi de mutualiser une image de base comme Debian/Jessie pour plusieurs conteneurs différents.

Les identifiants alphanumériques sont un peu inconfortables à écrire, l'utilisation de tag peut faciliter l'exécution des commandes.

Par exemple pour notre image « 2ea481ff9ce9 », nous allons créer le tag « mkf » via la commande suivante :

docker tag 2ea481ff9ce9 mkf

Vous allez voir le mot « mkf » dans la première colonne et « latest » dans la suivante :

Vous avez plusieurs façons de démarrer un conteneur.

Vous pouvez « juste » la démarrer, via la ligne suivante :

docker start identifiantImage

Le souci est que nous manquons ici d'options qui s'avéreront bien pratiques comme le fait de pouvoir définir à la volée un autre port ou la possibilité de « monter » un répertoire à la place d'un autre.

Pour cela, nous utilisons la commande run :

docker run identifiantImage

Que nous pouvons également utiliser avec un tag (comme le précédent ajouté) :

docker run mkf:latest

Ajoutons par exemple la redirection de port.

Imaginons que vous ayez déjà un serveur web qui tourne en local, le port 80 étant déjà utilisé vous souhaiteriez lancer ce conteneur sur un autre port.

Vous pouvez indiquer de rediriger le port 80 du conteneur vers le 81 de votre ordinateur via la commande suivante :

docker run -p 81:80 mkf:latest

Même chose pour le « montage » de volume, pour notre exemple, nous avons un répertoire « www » dans notre espace personnel, nous lançons ici le même conteneur en indiquant de lier le répertoire « /var/www/html » du conteneur au répertoire « www » de notre ordinateur via la commande suivante :

docker run -v /home/mika/www:/var/www/html mkf:latest

Le conteneur démarré fonctionnera ainsi comme si vous aviez branché votre répertoire « www » au répertoire web du conteneur.

Vous pouvez soit éteindre complètement un conteneur via la commande :

docker stop identifiantImage

Ou le mettre en « pause » :

docker pause identifiantImage

Une fois démarré, vous pouvez vous connecter à votre conteneur. Pour cela, après avoir récupéré l'identifiant de votre image, via l'habituel :

docker ps

Il vous suffit d'exécuter la commande suivante :

docker exec -it identifiantImage bash

Vous aurez ainsi une invite de commande connectée en tant que « root ».

Ceci peut vous permettre de vérifier un log/erreur, ou d'installer un paquet.

Si vous souhaitez conserver les modifications effectuées via la commande précédente (ajout de paquet, modification d'un fichier de configuration), vous pouvez le faire avec la commande suivante qui créera un nouveau conteneur :

docker commit identifiantImage monBackup

Vous pouvez voir votre nouveau conteneur en faisant un habituel :

docker images

Vous verrez une nouvelle ligne du type :

Vous pouvez également effectuer une sauvegarde d'un conteneur pour plusieurs raisons :

• sauvegarde de sécurité de vos conteneurs ;
• pouvoir communiquer/partager des conteneurs avec des collègues/amis ;
• permettre de déployer une application « packagée » sur un autre serveur.

Pour cela, vous pouvez lancer la commande suivante :

docker save identifiantImage > maSauvegarde.tar

Vous noterez ici que l'on utilise le chevron pour indiquer d'envoyer la sauvegarde vers une archive « TAR ».

Quand on parle de sauvegarde, on doit donc logiquement expliquer comment restaurer celle-ci.

Il suffit de charger cette même archive « TAR » via la commande suivante :

docker load maSauvegarde.tar

La sauvegarde recréera dans la liste de vos images le conteneur d'origine.

En l'état, si vous travaillez avec une base de données, vous pouvez vous y connecter « normalement » en modifiant le fichier de configuration pour y indiquer l'adresse du serveur.

Mais si vous souhaitez embarquer un serveur de base de données comme MySQL/PostgreSQL pour faciliter vos développements (par exemple en déplacement, loin du serveur de base de données)…

Pour ajouter un serveur MySQL à notre conteneur, il nous faut ajouter les paquets « mysql-server » et « mysql-client ».

Pour cela nous allons modifier notre fichier Dockerfile ainsi :

# This is a comment
FROM debian:jessie
MAINTAINER mika <mika@localhost>
RUN export DEBIAN_FRONTEND=noninteractive
RUN echo "mysql-server-5.6 mysql-server/root_password password  monmotdepasse " | debconf-set-selections
RUN echo "mysql-server-5.6 mysql-server/root_password_again password  monmotdepasse " | debconf-set-selections
RUN apt-get update && apt-get install -q -y apache2 subversion php5 php5-mysql libapache2-mod-php5 mysql-server mysql-client
RUN a2enmod php5
RUN rm /var/www/html/* -f
RUN svn checkout http://subversion.developpez.com/projets/mkframework /var/www/html/
RUN chmod 777 -R /var/www/html/data/genere
CMD /usr/sbin/apache2ctl -D FOREGROUND & /usr/sbin/mysqld

EXPOSE 80

Il nous faut reconstruire notre conteneur pour prendre en compte nos modifications avec l'habituelle commande (vu plus haut) :

docker build .

Une fois créé, il nous faut « déplacer » notre tag « mkf » sur cette nouvelle image, pour cela appelez simplement la méthode « tag » :

Pour utiliser cette base de données, nous pourrons simplement indiquer dans nos fichiers de configuration :

• « localhost » comme serveur ;
• « root » comme utilisateur ;
• et « monmotdepasse » comme mot de passe (comme indiqué dans le fichier dockerfile).

Il vous faudra ajouter un script d'initialisation de votre base de données pour chaque projet, par exemple en créant un sous-répertoire « init » dans votre répertoire « mkProjects » qui contiendra des scripts PHP d'initialisation comme celui-ci :

<?php

$sServeur='127.0.0.1';
$sUsername='root';
$sPassword='monmotdepasse';

$sDatabaseCreation='
CREATE DATABASE monApplicationDb;

use monApplicationDb;

CREATE TABLE auteur (
id INT NULL AUTO_INCREMENT,
nom varchar(50) NULL,
prenom varchar(50) NULL,

PRIMARY KEY id (id)
);

';

try {
    $oPdo=new pdo('mysql:dbname=mysql;host='.$sServeur,$sUsername,$sPassword);
} catch (PDOException $e) {
    die('Erreur connexion:'. $e->getMessage() );
}

$oStmt = $oPdo->prepare($sDatabaseCreation);
$oStmt->execute();

print "bases et tables cr&eacute;&eacutes;s avec succ&egrave;s";

Maintenant, vous pouvez lancer votre nouveau conteneur docker (incluant une base MySQL) :

docker run -d -p 80:80 -v /home/mika/mkProjects:/var/www/html/data/genere -v /home/mika/virtualhosts/:/etc/apache2/sites-enabled/ mkf:latest

Ouvrons notre navigateur, et apprécions dans notre second onglet de voir apparaître notre répertoire « init » précédemment créé.

Cliquons sur le bouton « voir le site » pour voir listé nos scripts de création de base de données :

Si nous cliquons sur notre premier script, celui-ci créera la base de données et la ou les tables nécessaires au développement de votre application.

Vous aurez un message « bases et tables créées avec succès ».

Notre table créée, nous pouvons modifier le fichier de configuration de notre application « monApplication ».

En éditant le fichier mkProjects/monApplication/conf/connexion.php :

;<?php die()?>
[db]

pdoMysqlExple.dsn="mysql:dbname=monApplicationDb;host=localhost"
pdoMysqlExple.sgbd=pdo_mysql
pdoMysqlExple.username=root
pdoMysqlExple.password=monmotdepasse

Ainsi vous pourrez, via le builder, utiliser votre base de données :

Vous voilà prêt pour travailler en toute autonomie avec un serveur web et sa base MySQL.

Si vous souhaitez vous connecter à votre serveur MySQL, vous le pouvez via la ligne de commande suivante.

Connectez-vous d'abord à celle-ci via l'habituel :

Docker exec -it identifiantImage bash

Et une fois connecté à votre conteneur, vous pouvez vous y loguer simplement.