Documentation

Maintenance du VPS

Connexion au VPS

Pour vous connectez au serveur deux solution s'offrent à vous:

• La connexion "standard"
• La connexion par clé SSH

La connexion standard

Ce type de connexion est la plus simple mais la plus lente sur le long terme car votre mot de passe vous serra constamment demander. De plus cette méthode est aussi moins sécurisé que la connexion par clé SSH car des pirates pourrait volé ou deviné votre mot de passe.

1. Ouvrir un terminal
2. Entrez la commande : ssh <votre nom d'utilisteur>@<l'addresse IP du serveur>
   Par exemple: student50@176.96.231.199
3. Entrez votre mot de passe quand celui-ci vous serra demandez.

La connexion par clé SSH

Ce type de connexion est un peu plus complexe à installé mais vous permettra de vous connectez plus facilement au VPS.

Création de clés SSH avec ssh-keygen

1. Ouvrir un terminal sur votre ordinateur
2. Entrez la commande suivante: ssh-keygen -f <nom et chemin de la clé> -t ed25519
   -f permet de choisir où générer la clé et -t permet de choisir l'algorithme de création ici ed25519 (ecdsa ou rsa sont aussi possible)
3. Mettez un mot de passe si vous souhaitez plus de sécurité sinon faite enter
4. Maintenant envoyé la clé publique sur le server grâce à: `ssh-copy-id -i <chemin vers la clé> <votre nom d'utilisteur>@<l'addresse IP du serveur>
5. Entrez votre mot de passe

Si vous souhaitez désactiver la connexion par mot de passe vous pouvez aller dans le fichier.ssh/config du server et ajouter la ligne PasswordAuthentification yes.

Connexion avec la clé SSH

1. Ouvrir un terminal
2. Entrez la commande : ssh <votre nom d'utilisteur>@<l'addresse IP du serveur>
   Par exemple: student50@176.96.231.199

Mise à jour du VPS

Pour mettre à jour le VPS entrer la commande:
apt-get update && upgrade

Installation de Docker[https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository]

1. Ajouter la clé GPG (clé de signature) de Docker:

 sudo mkdir -p /etc/apt/keyrings
 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

2. Ajoutez le répertoire de Docker:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. Installer Docker en utilisant la commande:
   sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
   docker-ce: est le cœur de Docker
   docker-ce-cli: est le cli de docker
   containerd.io: permet de gérer les containeurs
   docker-compose-plugin: permet d'utiliser docker compose

Docker se mettra automatiquement à jour lorsque vous mettrez à jour le VPS

Gestions des utilisateurs

Pour créer un nouvel utilisateur utilisez la commande:
sudo adduser <nom du nouvel utilisateur>
Cet utilisateur n'aura aucun privilèges et ne pourra pas apporter de modifications au VPS. Pour changer cela utiliser la commande:
sudo usermod -aG sudo <nom du nouvel utilisateur>

Organisation des fichiers

Le repo github est divisé en six dossiers principaux: Mail, DNS, WEB, Prototype, VoIP et services interne. Ensuite dans chacun de ces dossiers se trouve un dossiers par Service implanté. Dans les dossiers de service ne se trouvent que les fichiers qui seront modifiés pour correspondre au besoin du client. De plus ces fichiers doivent être hiérarchisé de la même manière qu'ils se trouvent lors de l'installation du service.

Guide de déploiement

1. Commencer par copier le contenu de ce github sur le vps grâce à:
   git clone https://github.com/JarodEphec/projet-admin-II.git
2. Rendez-vous ensuite dans le répertoire du service souhaiter (ex: cd projet-admin-II/Mail pour installer le mail)
3. Créer l'image du container grâce à: docker build -t NOM_QUE_VOUS_SOUHAITER .
4. Lancer ensuite le service grâce à la commande docker run que vous trouverez sur le wiki dans la partie configuration du service correspondant.

Organisation du groupe

Les différentes tâches ont été réparti équitablement entre les différents membres du groupe au début du projet. Chacun est responsable de sa partie mais un groupe Discord est disponible si une personne à besoin de l'aide du groupe.
Chaque personne responsable d'une configuration d'un service est aussi responsable de sa documentation pour facilité la rédaction de cette dernière.
Une personne faisant la configuration peut si elle le souhaite faire une réunion avec celle s'occupant de l'analyse pour partir sur de bonnes bases (pareil pour la personne s'occupant de la configuration avec celle s'occupant de la configuration).