Pré-Requis

💻 Environnement Matériel

1. Ordinateur sous Windows :

   • Processeur : Minimum 4 cœurs (recommandé pour gérer plusieurs conteneurs et VMs).

   • RAM : Minimum 8 Go (16 Go recommandé pour des performances optimales).

   • Espace disque : 20 Go libres pour Docker, les conteneurs et les images.

2. VMware Workstation Pro :

   • Requis uniquement pour exécuter des VMs créées automatiquement avec Docker Machine.

---

📦 Logiciels Requis

🐳 Docker Desktop

Docker Desktop est indispensable pour exécuter des conteneurs Docker sur Windows et inclut Docker Compose pour orchestrer vos services.

Installation :

1

Téléchargez Docker Desktop depuis docker.com.

2

Lancez le programme d'installation.

3

Pendant la configuration, assurez-vous que les options suivantes sont sélectionnées :

• Use WSL 2 instead of Hyper-V (recommended) : Cette option utilise le sous-système Windows pour Linux (WSL 2), qui est plus performant et compatible.

• Add shortcut to desktop (Optionnel) : Pour un accès rapide à Docker Desktop.

4

Poursuivez l'installation en cliquant sur OK.

5

Une fois l'installation terminée, Docker Desktop se lancera automatiquement. Suivez les instructions pour finaliser la configuration (comme l'activation de WSL 2 si ce n’est pas encore fait).

6

Vérifiez l’installation avec :

docker --version
docker-compose --version

Sortie attendue :

Docker version 27.3.1, build ce12230
Docker Compose version v2.30.3-desktop.1

🐙 Git

Git est requis pour cloner le dépôt DockerCoins depuis GitHub ou GitLab.

Installation :

1

Téléchargez Git depuis git-scm.com.

2

Installez-le avec les options par défaut.

3

Vérifiez l’installation :

git --version

Sortie attendue :

git version 2.47.1.windows.1

⚙️ Docker Machine

Docker Machine permet de créer automatiquement des machines virtuelles (VMs) via VMware ou d'autres pilotes, tout en installant et configurant Docker dessus. Il est essentiel pour configurer un cluster Docker Swarm.

Installation :

1

Installation via une commande (recommandée)

2

Exécutez la commande suivante dans le terminal Git Bash pour télécharger et installer Docker Machine automatiquement :

if [[ ! -d "$HOME/bin" ]]; then mkdir -p "$HOME/bin"; fi && \
curl -L https://github.com/docker/machine/releases/download/v0.16.2/docker-machine-Windows-x86_64.exe > "$HOME/bin/docker-machine.exe" && \
chmod +x "$HOME/bin/docker-machine.exe"

• Cette commande :

  • Vérifie que le dossier bin existe dans votre répertoire utilisateur ($HOME/bin) et le crée si nécessaire.

  • Télécharge l'exécutable docker-machine.exe dans ce dossier.

  • Attribue les permissions nécessaires pour exécuter le fichier.

3

Vérifiez l’installation :

docker-machine --version

Sortie attendue :

docker-machine.exe version 0.16.2, build bd45ab13

Unexpected error with integration github-files: Integration is not installed on this space

Unexpected error with integration github-files: Integration is not installed on this space

---

🔗 Comptes Nécessaires

• Docker Hub :

  • Requis pour télécharger des images Docker officielles.

  • Inscrivez-vous sur Docker Hub.

• GitLab :

  • Un compte GitLab est nécessaire pour stocker et gérer votre projet DockerCoins.

  • Créez un compte sur GitLab si ce n'est pas encore fait.

  • Configurez un dépôt nommé cpnv-es et une branche LIN2 pour y pousser votre projet.

---

📥 Cloner et personnaliser le projet

🐙 Cloner le projet DockerCoins depuis GitHub

1

Dans votre terminal, exécutez la commande suivante pour cloner le dépôt DockerCoins :

git clone https://github.com/7ric/Dockercoins.git

2

Accédez au répertoire cloné :

cd Dockercoins

---

🔧 Configurer votre dépôt GitLab

1

Ajoutez l'URL de votre dépôt GitLab comme un nouveau remote :

git remote add gitlab https://gitlab.com/Ruimmp/cpnv-es.git

2

Vérifiez que le remote a été ajouté :

git remote -v

Vous devriez voir :

gitlab  https://gitlab.com/Ruimmp/cpnv-es.git (fetch)
gitlab  https://gitlab.com/Ruimmp/cpnv-es.git (push)
origin  https://github.com/7ric/Dockercoins.git (fetch)
origin  https://github.com/7ric/Dockercoins.git (push)

---

🌳 Créer et pousser la branche LIN2

1

Créez une branche locale LIN2 :

git checkout -b LIN2

2

Commitez tous les fichiers pour les préparer au push :

git add .
git commit -m "Initial commit for Dockercoins in LIN2"

3

Poussez la branche LIN2 vers GitLab :

git push gitlab LIN2

4

Vérifiez sur GitLab que les fichiers sont bien présents dans le dépôt cpnv-es dans la branche LIN2.

---

📤 Mise en ligne des images sur Docker Hub

1

Téléchargez les images existantes :

docker pull redis:5
docker pull humboldtux/dockercoins_rng:0.1
docker pull humboldtux/dockercoins_hasher:0.1
docker pull humboldtux/dockercoins_worker:0.1
docker pull humboldtux/dockercoins_worker:0.2
docker pull humboldtux/dockercoins_webui:0.1

2

Re-taguez les images avec votre identifiant Docker Hub :

docker tag redis:5 ruimonteirocpnv/dockercoins_redis:5.0
docker tag humboldtux/dockercoins_rng:0.1 ruimonteirocpnv/dockercoins_rng:1.0
docker tag humboldtux/dockercoins_hasher:0.1 ruimonteirocpnv/dockercoins_hasher:1.0
docker tag humboldtux/dockercoins_worker:0.1 ruimonteirocpnv/dockercoins_worker:1.0
docker tag humboldtux/dockercoins_worker:0.2 ruimonteirocpnv/dockercoins_worker:2.0
docker tag humboldtux/dockercoins_webui:0.1 ruimonteirocpnv/dockercoins_webui:1.0

3

Poussez les images sur Docker Hub :

docker push ruimonteirocpnv/dockercoins_redis:5.0
docker push ruimonteirocpnv/dockercoins_rng:1.0
docker push ruimonteirocpnv/dockercoins_hasher:1.0
docker push ruimonteirocpnv/dockercoins_worker:1.0
docker push ruimonteirocpnv/dockercoins_worker:2.0
docker push ruimonteirocpnv/dockercoins_webui:1.0