Installation du serveur (Docker)

Cette documentation a été traduite à l’aide de l’intelligence artificielle et peut contenir des erreurs ou des imprécisions. En cas de doute, consultez la version allemande ou anglaise.

Ce chapitre explique comment installer un serveur OPSI avec Docker. Pour des informations détaillées sur les autres méthodes d’installation, consultez le chapitre Installation et configuration.

OPSI en tant que conteneur Docker

Depuis 2022, une image Docker est disponible pour mettre en place un serveur de configuration OPSI ou un serveur de dépôt OPSI. Cette solution utilise Docker Compose, un outil d’orchestration permettant de définir, d’interconnecter et d’exécuter plusieurs conteneurs sur un hôte Docker. Elle nécessite Docker Compose version 1.17.0 ou ultérieure et Docker Engine version 17.09.0 ou ultérieure.

Dans cette configuration, la communication avec le dépôt OPSI utilise exclusivement le protocole WebDAV ; cette variante ne prend pas en charge Samba.

Installation de Docker

Installez Docker ou Docker Desktop sur Linux, Windows ou macOS :

Sous Linux, vous pouvez également utiliser directement Docker Engine. Il suffit d’installer les paquets correspondants pour votre distribution Linux.

Pour vérifier que l’installation a réussi, exécutez la commande suivante dans le terminal :

docker run --rm hello-world
Par défaut, la commande docker nécessite les privilèges root ; l’utilisation de nos scripts auxiliaires nécessite donc également ces privilèges. Vous pouvez préfixer les commandes présentées dans ce chapitre par sudo ou ajouter un compte utilisateur au groupe docker. Pour plus d’informations, consultez le chapitre Linux post-installation steps for Docker Engine du manuel Docker.

Vous devriez obtenir une sortie semblable à celle-ci :

Hello from Docker!
This message shows that your installation appears to be working correctly.
[...]

Démarrage rapide

Un script auxiliaire facilite la mise en place et la gestion d’un environnement Docker OPSI.

Les spécialistes de Docker peuvent se passer du script auxiliaire et consulter directement toutes les informations dans notre dépôt GitHub opsi-docker.

Windows

Sous Windows, procédez comme suit :

  1. Créez un dossier opsi-server.

  2. Téléchargez le script opsi-server.ps1 et enregistrez-le dans le dossier opsi-server.

  3. Ouvrez PowerShell avec les privilèges d’administrateur.

  4. Exécutez la commande suivante dans la fenêtre du terminal : PowerShell.exe -ExecutionPolicy Bypass

  5. Accédez au dossier opsi-server à l’aide de la commande cd.

  6. Exécutez le script en saisissant .\opsi-server.ps1 start.

Linux et macOS

Sous Linux et macOS, procédez comme suit :

Pour la mise en place sous Linux, procédez comme suit :

  1. Créez un dossier opsi-server.

  2. Téléchargez le script opsi-server.sh et placez-le dans le dossier opsi-server.

  3. Ouvrez un terminal avec les privilèges root.

  4. Accédez au dossier opsi-server à l’aide de cd.

  5. Rendez le script exécutable : chmod +x opsi-server.sh

  6. Exécutez le script avec la commande ./opsi-server.sh start.

Cette procédure télécharge automatiquement les images Docker nécessaires et démarre les conteneurs.

  • Utilisez .\opsi-server.ps1 status ou ./opsi-server.sh status pour vérifier l’état des conteneurs.

  • Consultez les journaux des conteneurs avec .\opsi-server.ps1 logs ou ./opsi-server.sh logs.

  • Mettez les conteneurs à jour vers les dernières versions avec .\opsi-server.ps1 upgrade ou ./opsi-server.sh upgrade.

Un fichier docker-compose.yml se trouve désormais dans le dossier opsi-server. Ouvrez ce fichier dans un éditeur de texte et recherchez la variable d’environnement OPSI_ADMIN_PASSWORD. Vous aurez besoin du mot de passe indiqué pour vous connecter au serveur OPSI en tant qu’utilisateur adminuser lors des étapes suivantes.
Pour des raisons de sécurité, nous recommandons vivement de modifier ce mot de passe.

Si vous modifiez le fichier docker-compose.yml, redémarrez les conteneurs pour appliquer les changements. Pour cela, saisissez .\opsi-server.ps1 recreate ou ./opsi-server.sh recreate.

Pour en savoir plus sur Docker, les scripts d’aide et le fichier docker-compose.yml, consultez le chapitre OPSI dans un conteneur Docker. Vous pouvez ensuite télécharger et lancer l’interface utilisateur opsi-configed.