• Créer la VM supportant les conteneurs Windows, depuis Visual Studio
• Retrouver la VM sur le portail Azure (ce n’est pas nécessaire, mais ça peut toujours servir !)
• Déployer l’application (et constater que le déploiement échoue)
• Modifier le fichier dockerfile
• Déployer l’application à nouveau
• Et si chez moi ça ne marche pas ?

Créer la VM supportant les conteneurs Windows, depuis Visual Studio

Retrouver la VM sur le portail Azure

Déployer l’application

Modifier le fichier dockerfile

Et si chez moi ça marche pas ?

Et après ?

Sommaire

I. Description

II. Installer Skript

III. Création et test du Skript

IV. Aller plus loin

I. Description

J’ai choisi de vous parler de Skript : un langage de développement spécifique à Minecraft .

Je trouve que c’est un magnifique langage car il est réellement simple et pourtant peu connu à mon grand regret.

Il vous permettra de créer des plugins qu’on appellera Skript. Les fichiers Skript se finissent en .sk. Ils ne nécessitent aucun éditeur spécifique. Un bloc-notes suffit. Je vais pour ma part utiliser le logiciel NotePad++. Dans ce tutoriel nous allons créer un Skript qui aura pour but de nous afficher la vie du joueur que nous venons d’attaquer dans le chat du jeu.

II. Installer Skript

Pour utiliser Skript, il faut avoir installé le plugin Skript. Il existe beaucoup d’addons à Skript pour faire des choses plus complexes comme par exemple RandomSK qui vous donne accès à 30 fonctionnalités en plus que par défaut (3 évents, 6 conditions, …). Un site anglais vous référence tous les évènements, addons, etc… il s’appelle SkUnity. Un forum français est aussi disponible : https://skript-mc.fr/

III. Création et test du skript

Pour commencer, nous allons créer un document texte dans le dossier <Dossier de votre serveur>\plugins\Skript\scripts. Si vous ne les avez pas déjà supprimés, vous pouvez voir plusieurs fichiers déjà présents dans ce dossier avec un préfixe ‘-‘, cela veut dire qu’ils sont désactivés. En enlevant ce ‘–‘ et en faisant une reload de votre serveur, ils seront activés. Vous pouvez les visualiser pour voir leur code. Nous allons appeler notre document texte « tutoriel.sk » comme ceci :

Maintenant nous allons l’ouvrir et taper la première ligne de code :

on damage : veut dire « dès qu’il y a un dommage alors : » cela permet de réagir sur l’évènement on damage pour y déclencher une suite d’actions.
Pour continuer, nous allons utiliser des termes techniques comme :
%victim% qui définit le pseudo de celui qui a reçu le dommage
%attacker% qui définit le pseudo de celui qui a frappé la victime

{_health.%victim%} qui définit l’appellation pour faire référence à la vie de la victime.

Pour commencer la deuxième ligne de code nous allons écrire :
wait 1 tick

Le tick est la plus petite unité de mesure de Minecraft (20 ticks = 1 seconde). Nous marquons cela pour que la vie de la victime ait le temps de s’actualiser.

Cela donne ceci :

Ensuite, nous allons nous attaquer à la troisième ligne :
Nous allons marquer :
set {_health.%victim%} to health of victim
qui va faire en sorte que {_health.%victim%} soit égal à la vie de la victime.
Voilà ce que ça donne :

Et pour finir, nous allons nous attaquer à la dernière ligne :
send "&3%victim% &7à maintenant &4%{_health.%victim%}% ♥" to attacker

Nous utilisons:

• send qui veut dire envoyer un message
• to attacker qui veut dire à l’attaquant

Donc on envoie un message à l’attaquant
et "&3%victim% &7à maintenant &4%{_health.%victim%}% ♥"

qui envoie donc :
<pseudo de la victime> a maintenant <nombre de cœur> ♥

Tout cela avec des couleurs car &3 correspond à la couleur bleu sombre, &7 à la couleur grise et &4 à la couleur rouge sombre.

Voilà ce que cela donne en jeu :
Ce test est effectué sur un animal donc le nom est celui de l’animal :

IV. Aller plus loin

J’espère que cela vous donne envie d’aller plus loin et pour cela je vais vous donner quelques liens :
Skript-MC : Un forum Français avec des membres qui vous aideront
Sk-Unity : Bibliothèques ou sont répertoriés tous les addons avec de la documentation sur les events, les arguments etc

Les concepts généraux de Docker ont été rappelés sur la page 1/3 de cet article.

Nous utiliserons 2 manières différentes de déployer l’application:

- d’abord vers un conteneur Linux (cette page): en créant les différents composants de manière “manuelle” pour bien comprendre comment fonctionne Docker

- ensuite vers un conteneur Windows (dans la page 3/3 de l’article): en se reposant entièrement sur l’assistant dans Visual Studio qui prendra en charge intégralement les opérations, y compris la création de la VM dans Azure.

Notez que les  2 procédures (manuelle ou auto) fonctionnent aussi bien sur Linux que sur Windows.

Pré-requis

De manière générale pour déployer une application dans un conteneur Docker, il faut:

Nous verrons tout cela étape par étape : à ce stade du tutoriel il vous faut simplement:

• un compte Azure
• Visual Studio 2015 RTM (ce tuto a été créé sur la version Enterprise mais cela devrait fonctionner aussi sur la version Community)
• SDK Azure disponible via le Web Platform Installer

Je suis partie d’un Visual Studio vierge en terme d’extensions, ce qui me permettra de vous montrer au fur et à mesure les différents composants à installer pour faire fonctionner ce petit monde-là.

Les étapes

Pour publier une application dans un conteneur Docker sur Azure, vous pouvez très bien n’utiliser qu’un seul outil : Visual Studio. En effet, l’extension Docker pour Visual Studio vous fournit un assistant qui va s’occuper de provisionner la VM, créer et uploader les certificats et y déployer le code sous la forme d’une image Docker.

Soit. Vous aurez votre application qui tourne dans Docker.

Mais vous n’aurez pas compris comment ça marche en dehors de Visual Studio...et ne saurez pas prendre la main dessus avec les outils Docker.

Donc dans ce tutoriel, on va se retrousser les manches et réaliser les différentes étapes nous-même, jusqu’à arriver à la publication du code où nous passerons effectivement la main à l’extension Docker pour le télécharger et démarrer le conteneur.

Nous allons donc:

1. Créer une VM Linux avec l’extension Docker dans Azure
   • Créer des certificats SSL à ajouter dans la configuration de l’extension Docker
   • Ajouter des point de terminaison/endpoints sur la VM pour pouvoir se connecter au docker host depuis le client Docker
2. Installer l’extension Docker pour Visual Studio
3. Créer une application console ASP.Net 5
4. Déployer l’application dans un conteneur linux sur notre VM Linux
5. Déployer la même application dans un conteneur Windows d’une nouvelle VM Windows Server 2016 créée cette fois par Visual Studio
6. Constater que cela ne fonctionne pas
7. Modifier le dockerfile
8. Re-déployer l’application dans un conteneur Windows
9. Constater que cela fonctionne

1. Création de la VM Linux dans Azure

Depuis le portail, sur la marketplace, choisissez la VM Docker on Ubuntu Server:

C’est en fait une VM Ubuntu classique, avec l’extension docker pré-installée : elle nous permet d’avoir un docker engine sur notre VM.

Cliquez sur “Créer”, puis renseignez le nom de la machine hôte (de préférence,  utilisez le rappel “linux” dans le nom pour ne pas confondre les VMs Windows et Linux lors du déploiement à partir de Visual Studio), l’utilisateur et le mot de passe.

Ajout des points de terminaison

Ajoutez un point de terminaison 2376 sur votre VM pour pouvoir vous connecter au Docker host de la manière suivante

Faites de même avec le port 80 pour obtenir

Ouvrir les ports c’est nécessaire mais cela ne suffit pas pour se connecter au docker host.

En effet, Docker est configuré pour fonctionner avec une clé de sécurité SSL. Bon ça va se compliquer un peu car il va falloir générer les certificats SSL. Cette étape est prise en charge par Visual Studio si vous créez la VM depuis l’assistant : c’est ce que l’on verra dans la 2ème partie du tuto où nous laisserons VS prendre tout en charge pour déployer l’application dans un conteneur Windows.

Création des certificats SSL

Le démon Docker sur le serveur est configuré pour utiliser la sécurité TLS. Le client Docker recherche la clé du client (key.pem) et le certificat (cert.pem) par défaut dans le dossier <%userprofile%>\.docker. Si ces éléments ne sont pas présents, il convient de les générer à l'aide d'OpenSSL.

C’est ce que nous allons faire à présent.

Installez OpenSSL depuis un des sites recommandés ici https://wiki.openssl.org/index.php/Binaries

Générez vos certificats ainsi:

echo 01 > ca.srl

openssl genrsa -des3 -out ca-key.pem
openssl req -new -x509 -days 3650 -key ca-key.pem -out ca.pem
openssl genrsa -des3 -out server-key.pem
openssl req -new -key server-key.pem -out server.csr
openssl x509 -req -days 365 -in server.csr -CA ca.pem -CAkey ca-key.pem -out server-cert.pem

echo "Creating client keys..."
openssl genrsa -des3 -out client-key.pem
openssl req -new -key client-key.pem -out client.csr
echo extendedKeyUsage = clientAuth > extfile.cnf
openssl x509 -req -days 365 -in client.csr -CA ca.pem -CAkey ca-key.pem -out client-cert.pem -extfile extfile.cnf

echo "Stripping passwords from keys..."
openssl rsa -in server-key.pem -out server-key.pem
openssl rsa -in client-key.pem -out key.pem

ou selon la doc https://docs.docker.com/engine/articles/https/ et copiez-les dans le répertoire <user>/.docker.

(Oui c’est pénible : si vous préférez sauter cette étape, commencez par la partie 3/3 du tuto où VS génère automatiquement les certificats dans le répertoire adéquat lorsqu’il crée la VM )

Si l’on était parti d’une VM Ubuntu simple, à laquelle on aurait ajouté l’extension docker, nous aurions pu spécifier les certificats dans la configuration de l’extension en précisant les 3 fichiers de certificats nécessaires. <user>/.docker. Les fichiers à utiliser sont ca.pem, server-cert.pem, server-key.pem.

Mais avec la VM incluant une extension déjà configurée, les fichiers sont pris dans le répertoire <user>/.docker.

Si vous voulez modifier les certificats a posteriori, voici une méthode pas très jolie, mais simple et pratique : sélectionnez votre VM et ajoutez une nouvelle fois l’extension Docker en précisant les nouveaux certificats. Validez.

L’installation réussit mais on trouve une erreur dans les détails de l’extension.

Redémarrez la VM : cette fois ça fonctionne.

Vous pouvez y accéder facilement grâce à la zone de recherche du bandeau et l’épingler sur l’écran d’accueil pour y accéder facilement.

Passons maintenant sur la machine client : celle sur laquelle vous avez  installé Visual Studio.

2. Installation de l’extension Docker pour Visual Studio

Installez tout d’abord Microsoft ASP.NET and Web Tools 2015 (Beta8) – Visual Studio 2015 ; choisissez les composants à installer selon les instructions ci-dessous:

Install Instructions

1. Close all instances of Visual Studio.
2. Install .NET Version Manager (Beta8) using DotNetVersionManager-x64.msi. For 32 bit machines use DotNetVersionManager-x86.msi.
3. Update Visual Studio 2015 (Enterprise, Professional or Community) with ASP.NET and Web Tools 2015 (Beta8) by installing WebToolsExtensionsVS14.msi. If you are using Visual Studio 2015 Express for Web, then install WebToolsExtensionsVWD14.msi instead.

Dans Visual Studio, via le menu “Tools>Extensions and Updates”, ajoutez l’extension Visual Studio Tools for Docker (ici en October Preview):

3. Création d’une application Console

Puis créez un nouveau projet de type Web/Console Application.

Ajoutez simplement les 2 lignes de code suivantes dans le Main du fichier Program.cs:

namespace DockerConsoleApp
{
    public class Program
    {
        public void Main(string[] args)
        {
            Console.WriteLine("I'm running in a container :D");
            Console.ReadLine();
        }
    }
}

Si vous l’exécutez localement sur la machine, vous obtiendrez

4. Déployer l’application dans un conteneur sur notre VM Linux

Faites un click droit sur le projet dans l’explorateur de fichiers et choisissez “Publish”:

Voici l’assistant de publication qui vous propose de publier votre application dans un conteneur docker.

Sélectionnez la cible Docker Containers

Choisissez la souscription Azure et le nom de la VM Linux avec Docker que vous venez de créer puis validez.

Remarquez l’url de votre agent Docker qui utilise le port 2376.

Cliquez sur le bouton “Validate Connection”: normalement, ça devrait bien se passer.

Je vous encourage à installer le client Docker de base via Chocolatey : cela vous permettra de communiquer avec votre Docker host sans Visual Studio et de vous familiariser avec les commandes Docker.

Si vous n’avez pas encore Chocolatey sur votre machine, vous pouvez suivre cette petite vidéo qui vous expliquera comment faire pour installer Chocolatey ainsi que le client Docker.

Vous pouvez tester la connexion à partir du client docker en copiant/collant la commande Preview dans les options avancées de la boite de dialogue.

Je vais utiliser la commande “info”, et vous pouvez utiliser les commandes docker depuis le Command Prompt.

Pour l’instant, je n’ai pas d’image docker et a forciori, pas de conteneur en cours d’exécution.

A présent, cliquez sur le bouton Publish

Plusieurs choses se passent à ce moment (vous pouvez voir le détail dans la fenêtre Output de VS, notamment:

• la création du fichier Dockerfile dans le projet Visual Studio
• la création de l’image correspondant à votre application, en partant du packaging décrit dans le dockerfile
• le transfert de votre app dans le docker host, via le docker engine
• la récupération des “couches du millefeuille” applicatif décrites dans le dockerfile et le point d’entrée du code utilisé pour l’exécution du conteneur
• le démarrage du conteneur

Normalement vous devriez vous retrouver avec ce genre de résultat, à la fin de l’output

VERBOSE:  ---> Running in 7bf52b2450c1
VERBOSE:  ---> 191d76de7c39
VERBOSE: Removing intermediate container 7bf52b2450c1
VERBOSE: Successfully built 191d76de7c39
VERBOSE(0,0): Warning : You are building a Docker image from Windows against a non-Windows Docker host. All files and directories added to build context will have '-rwxr-xr-x' permissions. It is recommended to double check and reset permissions for sensitive files and directories.
The Docker image "dockerconsoleapp" was created successfully.
VERBOSE: Starting Docker container: dockerconsoleapp
Executing command [docker --tlsverify -H tcp://stephetutodockerlinux.cloudapp.net:2376 run -t -d dockerconsoleapp]
VERBOSE: cc80b00c123b7978695931afcaefe05165876f07a95edb54662513ec9d8a3902
Docker container started with ID: cc80b00c123b7978695931afcaefe05165876f07a95edb54662513ec9d8a3902
To see standard output from your application, open a command line window and execute the following command: 
    docker --tlsverify -H tcp://stephetutodockerlinux.cloudapp.net:2376 logs --follow cc80b00c123b7978695931afcaefe05165876f07a95edb54662513ec9d8a3902
Publish completed successfully.
========== Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ==========
========== Publish: 1 succeeded, 0 failed, 0 skipped ==========

Le fichier Dockerfile

Le dockerfile est créé par Visual Studio en fonction de l’OS – Linux ou Windows - sur lequel est basé le conteneur qui va faire tourner l’app. Il permet à docker de savoir comment reconstituer le contexte : c’est à dire les couches d’images dont votre application a besoin pour s’exécuter. Vous allez comprendre en jetant un œil au dockerfile:

FROM microsoft/aspnet:1.0.0-beta8

ADD . /app

WORKDIR /app/approot

ENTRYPOINT ["./DockerConsoleApp"]

Sur une machine linux, on va partir de l’image Microsoft/aspnet avec la version 1.0.0-beta8, récupérée dans la registry officielle de Docker.

La registry regroupe les images qui y sont poussées par les éditeurs et qui sont ensuite utilisées et notées par les utilisateurs.

Cette image aspnet publiée par Microsoft est elle-même basée sur Mono, l’implémentation x-plat de .Net.

Si vous jetez un œil au dockerfile cette image vous trouverez les couches qui permettent cette fois de retrouver le bon contexte de packaging pour ASP.NET pour linux.

On continue comme ça jusqu’à l’OS (et sa version) : c’est l’illustration des couches du fameux millefeuille, qui permet de retrouver toujours un environnement de déploiement et d’exécution identique.

Dans notre dockerfile, il est précisé l’ajout du package de notre application, le répertoire courant ainsi que le point d’entrée pour l’exécution de l’application.

Le conteneur

Pour vérifier si votre conteneur a bien démarré, on va réexécuter la commande docker info: on y trouve bien 1 conteneur – c’est bon signe

Pour lister les images, on utilise la commande “images”

On retrouve bien l’image Microsoft/aspnet qui a été récupéree par docker dans la registry officielle Docker (celle-ci est fournie par Microsof) utilisée en sous-couche de notre image applicative dockerconsoleapp.

On trouve aussi l’image de notre application dockerconsoleapp qui est la dernière couche du millefeuille.

Pour lister les conteneurs, on utilise la commande “ps”"

Pour voir la sortie standard de notre application, il suffit de copier/coller la commande suggérée par VS dans l’Output:

docker --tlsverify -H tcp://stephetutodockerlinux.cloudapp.net:2376 logs --follow cc80b00c123b7978695931afcaefe05165876f07a95edb54662513ec9d8a3902

Youpi !!

Dans la dernière partie de l’article, nous déploierons la même application dans un conteneur Windows, créé directement depuis Visual Studio et non plus depuis le portail Azure comme nous l’avons fait ici. Si l’on souhaite utiliser la même solution Visual Studio pour déployer l’application sur 2 types de conteneurs différents, nous verrons qu’il y a quelques petites subtilités, en particulier le dockerfile puisque l’application devra tourner sur 2 OS différents.

Références