Installing Archetype (fr)

Pour utiliser Archetype, il faut installer trois logiciels : Docker, Kitematic (facultatif mais recommandé) et Archetype. Les logiciels comprennent plus de 1Go de données ensemble : donc il faut avoir assez d’espace de stockage et un bon réseau pour les télécharger. L’installation prends un peu de temps mais il ne faut le faire qu’une fois.

Pour les utilisateurs de Windows: veuillez noter que la virtualisation doit être activée pour utiliser Docker. Les instructions pour vérifier si votre ordinateur en est équipé, et comment le réparer si ce n'est pas le cas, sont disponibles à l'adresse suivante: https://www.trishtech.com/2017/08/check-if-virtualization-is-enabled-in-windows-10/

Les instructions en anglais sont à l'adresse https://hub.docker.com/r/kingsdigitallab/archetype/ > ‘How to install Docker and Kitematic’ et ‘How do I install Archetype for Docker?’. Voici les instructions en français, et aussi des captures d’écran en piece jointe :

1. Téléchargez et installez ‘Docker Community Edition (Stable)’ (Docker CE Stable):    * Mac: https://store.docker.com/editions/community/docker-ce-desktop-mac   * Windows: https://store.docker.com/editions/community/docker-ce-desktop-windows   * Linux Ubuntu: https://store.docker.com/editions/community/docker-ce-server-ubuntu   * Autres systèmes: https://store.docker.com/search?offering=community&type=edition 

2. Téléchargez et installez ‘Kitematic’: https://github.com/docker/kitematic/releases

   Nous utilisons Kitematic pour télécharger, installer, contrôler Archetype lui-même:

3. Lancez Kitematic. Il vous demande de créer un compte mais c’est facultatif : vous pouvez le sauter. NB Pour Linux, il faut lancer Kitematic en mode ‘superuser’ (avec sudo).

4. Dans Kitematic, cliquer sur ‘Docker CLI’ (en bas à gauche)

5. Vous devriez voir une fenêtre de terminal où vous pouvez taper dedans. Copier et coller le suivant, selon votre système :

   Windows :

   docker pull kingsdigitallab/archetype:latest; docker run -d --name archetype -p 9080:80 kingsdigitallab/archetype:latest; echo ”INSTALLED”;

   Mac/Linux :

   docker pull kingsdigitallab/archetype:latest; docker run -d --name archetype -v \~/Documents/Kitematic/archetype/home/digipal/digipal\_project:/home/digipal/digipal\_project:cached -p 9080:80 kingsdigitallab/archetype:latest; echo "INSTALLED”;

   Archetype sera téléchargé, installé et lancé tout seul. Attendez de voir le mot ‘INSTALLED’ dans le terminal. Il prend assez de temps : soyez patient !

6. Vous pourriez fermer le terminal (tapez CTRL-D ou ‘exit’).

7. Dans Kitematic, vous devriez voir ‘Archetype (archetype:latest)’ à gauche au-dessous de ‘Containers’. Cliquez-le. Dans la boite noire ‘Container logs’ en Archetype vous devriez voir ‘WEBSITE IS RUNNING’. Sinon attendez encore.

   Si vous utilisez Windows et vous recevez un message d'erreur concernant Hyper V, VT-x, AMD-V ou similaire, vous n'avez probablement pas activé la virtualisation sur votre ordinateur. Les instructions pour vérifier si votre machine en est équipée, et comment la réparer si ce n'est pas le cas, sont disponibles sur https://www.trishtech.com/2017/08/check-if-virtualization-is-enabled-in-windows-10/

8. Ouvrir l’URL http://localhost:9080 dans votre navigateur. Vous devriez voir le site Archetype. Sinon, vous pourriez cliquer sur l’icône en Kitematic avec la forme d'un carré avec une flèche a droit de ‘Web Preview’. 

La prochaine fois que vous voudriez utiliser Archetype, il ne faudra que lancer Kitematic, cliquer sur l’icône ‘Start’, et attendez le message ‘WEBSITE IS RUNNING’.