Docker

Cette page fournit des informations d'installation et de configuration pour Docker.

Docker

Confirmation que Docker est installé correctement

NOTE : Appareils Apple M1 : au moment de la rédaction, certains problèmes existent sur les appareils Apple M1 ainsi que sur certains appareils ARM64/ARMv8. Veuillez consulter ce fil de forum avant de continuer.

Docker

Exécutez la commande suivante pour confirmer que Docker est installé :

docker version

Exemple de sortie :

Client: Docker Engine - Community
 Version:           23.0.1
 API version:       1.42
 Go version:        go1.19.5
 Git commit:        a5ee5b1
 Built:             Thu Feb  9 19:47:01 2023
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          23.0.1
  API version:      1.42 (minimum version 1.12)
  Go version:       go1.19.5
  Git commit:       bc3805a
  Built:            Thu Feb  9 19:47:01 2023
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.6.18
  GitCommit:        2456e983eb9e37e47538f59ea18f2043c9a73640
 runc:
  Version:          1.1.4
  GitCommit:        v1.1.4-0-g5fd4c4d
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

Docker Compose

Docker Compose v1 utilise la commande docker-compose. À partir de juin 2023, la prise en charge de Docker Compose v1 prend fin.

Docker Compose v2 utilise la commande docker compose.

Si vous utilisez Docker Compose v1, veuillez ajuster les commandes en conséquence. Plus d'informations sur Docker Compose sont disponibles ici.

Exécutez l'une des commandes suivantes pour confirmer que Docker Compose est installé :

Docker Compose v1 :

docker-compose version

Docker Compose v2 :

docker compose version

Exemple de sortie :

Docker Compose version v2.16.0

Un Docker Hello-World

Pour vous assurer que Docker est en mesure de récupérer et d'exécuter des images de conteneur, exécutez la commande suivante :

docker run hello-world

Exemple de sortie :

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2db29710123e: Pull complete 
Digest: sha256:ffb13da98453e0f04d33a6eee5bb8e46ee50d08ebe17735fc0779d0349e889e9
Status: Downloaded newer image for hello-world:latest

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

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

Installation

Utilisation du conteneur préconstruit

Pour exécuter PowerShell Universal, utilisez l'image de conteneur fournie. L'image Docker est disponible sur Docker Hub.

La version préconstruite prend en charge les fonctionnalités gratuites et payantes de PowerShell Universal.

Démarrez le conteneur en récupérant l'image, puis en exécutant un conteneur avec le port par défaut lié.

Exécution d'une image de base

docker pull devolutions/powershell-universal
docker run --name 'PSU' -it -p 5000:5000 devolutions/powershell-universal

Présenter une image sur un port différent

Si le port 5000 n'est pas disponible sur votre hôte, passez à un autre port.

Par exemple, présenter sur le port 80 :

docker pull devolutions/powershell-universal
docker run --name 'PSU' -it -p 80:5000 devolutions/powershell-universal

Monter un volume

La commande docker run vous permet de monter un volume pour un stockage persistant. Montez le volume dans le dossier /root.

Monter un volume sur un conteneur sous Windows

La commande suivante monte le dossier C:\docker\volumes\PSU dans /root sur votre conteneur :

docker pull devolutions/powershell-universal
docker run --name 'PSU' -it -p 5000:5000 -v C:\docker\volumes\PSU:/root devolutions/powershell-universal 

Monter un volume sur un conteneur sous Mac et Linux

La commande suivante monte le dossier /docker/volumes/PSU dans /root sur votre conteneur :

docker pull devolutions/powershell-universal
docker run --name 'PSU' -it -p 5000:5000 -v /docker/volumes/PSU:/root devolutions/powershell-universal 

Arrêt d'un conteneur

La commande suivante arrête un conteneur nommé PSU :

docker stop PSU

Suppression d'un conteneur

La commande suivante supprime un conteneur arrêté nommé PSU :

docker rm PSU

Le drapeau --force permet de supprimer un conteneur en cours d'exécution :

docker rm --force PSU

Docker Compose

Docker Compose vous permet d'utiliser un fichier texte yaml pour standardiser votre construction et scripter le déploiement (ou la construction) de plusieurs conteneurs.

Le nom par défaut de tout fichier compose est docker-compose.yml. Il est recommandé d'utiliser ce nom pour votre fichier compose.

Création d'un script Compose pour Windows

Le fichier compose suivant exécute un conteneur PowerShell Universal sous Windows :

version: "5.2.1"
services:
  PSU:
    container_name: PSU
    image: devolutions/powershell-universal:latest
    ports:
      - 5000:5000
    restart: unless-stopped
    environment:
      - TZ=Europe/London
    volumes:
      - C:\docker\volumes\PSU:/root

Création d'un script Compose pour Mac / Linux

Le fichier compose suivant exécute un conteneur PowerShell Universal sur Mac et Linux :

version: "5.2.1"
services:
  PSU:
    container_name: PSU
    image: devolutions/powershell-universal:latest
    ports:
      - 5000:5000
    restart: unless-stopped
    environment:
      - TZ=Europe/London
    volumes:
      - /docker/volumes/PSU:/root

Démarrage des conteneurs à l'aide de scripts Compose

À l'aide d'un terminal shell ou de PowerShell pour Windows, utilisez la commande cd pour accéder au répertoire contenant votre script docker-compose.yml.

Exécutez la commande suivante :

docker compose up -d

Exemple de sortie :

Creating network "PSU_default" with the default driver
Pulling PSU (devolutions/powershell-universal:latest)...
latest: Pulling from devolutions/powershell-universal
7608715873ec: Pull complete
4e66273c6cfb: Pull complete
2649c52300c2: Pull complete
a20175666bc7: Pull complete
65ce93bc0653: Pull complete
Digest: sha256:d7ff98e6197d21070aac325c2efbefa393a4952d2e8ba6b1327dc97824ec4d55
Status: Downloaded newer image for devolutions/powershell-universal:latest
Creating PSU ... done

Arrêt des conteneurs à l'aide de scripts Compose

À l'aide d'un terminal shell ou de PowerShell pour Windows, accédez au répertoire contenant votre script docker-compose.yml.

Exécutez la commande suivante :

docker compose down

Exemple de sortie :

[+] Running 2/2
 ⠿ Container PSU         Removed                                           0.5s
 ⠿ Network PSU_default   Removed                                           0.4s

Utilisation de variables d'environnement et de la persistance SQL

Vous pouvez ajouter des variables d'environnement dans vos scripts Compose. Voici un exemple illustrant :

• La définition d'un nom de nœud
• L'ajout de la persistance SQL
• L'ajout d'une chaîne de connexion SQL

version: "5.2.1"
services:
  PSU:
    container_name: PSU
    image: devolutions/powershell-universal:latest
    ports:
      - 5000:5000
    restart: unless-stopped
    environment:
      - TZ=Europe/London
      - Plugins__0=SQL
      - Data__ConnectionString=Data Source=sql1.domain.com;Initial Catalog=PSUTicketBridge;User Id=psu_ticketbridge_dbo;Password=Password123;TrustServerCertificate=True;Trusted_Connection=True;integrated security=false;
      - NodeName=mynodename
    volumes:
      - /docker/volumes/PSU:/root

Utilisation de variables d'environnement et de la persistance PostgreSQL

Vous pouvez ajouter des variables d'environnement dans vos scripts Compose. Voici un exemple illustrant :

• La définition d'un nom de nœud
• L'ajout de la persistance PostgreSQL
• L'ajout d'une chaîne de connexion PostgreSQL

version: "5.2.1"
services:
  PSU:
    container_name: PSU
    image: devolutions/powershell-universal:latest
    ports:
      - 5000:5000
    restart: unless-stopped
    environment:
      - TZ=Europe/London
      - Plugins__0=PostgreSQL
      - Data__ConnectionString=Host=PGhostname; Database=PGdatabase; User Id=PGusername; Password=PGpassword!;Port=5432
      - NodeName=mynodename
    volumes:
      - /docker/volumes/PSU:/root

Création d'un conteneur personnalisé

Si vous souhaitez ajouter des fonctionnalités, modifier ou coder en dur des variables d'environnement dans votre conteneur, créez un Dockerfile.

REMARQUE : Les Dockerfiles sont sensibles à la casse et doivent commencer par un 'D' majuscule.

Pour créer une image Docker capable de conserver les données Universal, créez un Dockerfile similaire à celui ci-dessous.

Ce Dockerfile expose le port 5000, crée un volume /data, définit des variables d'environnement de configuration pour stocker le référentiel Universal et la base de données dans le volume, puis définit Universal.Server comme point d'entrée du conteneur.

Écriture d'un script Dockerfile pour Linux

FROM devolutions/powershell-universal:latest
LABEL description="Universal - The ultimate platform for building web-based IT Tools" 

EXPOSE 5000
VOLUME ["/home/data"]
ENV Data__RepositoryPath /home/data/Repository
ENV Data__ConnectionString Data Source=/home/data/database.db
ENV UniversalDashboard__AssetsFolder /home/data/UniversalDashboard 
ENV Logging__Path /home/data/logs/log.txt
ENTRYPOINT ["./Universal/Universal.Server"]

Construction d'un conteneur

Depuis le chemin qui héberge votre Dockerfile, exécutez la commande suivante :

docker build . --tag=universal-persistent

Windows

FROM devolutions/powershell-universal:5.0.0-windowsservercore-1809
LABEL description="Universal - The ultimate platform for building web-based IT Tools" 

EXPOSE 5000
VOLUME ["C:/data"]
ENV Data__RepositoryPath C:/data/Repository
ENV Data__ConnectionString Data Source=C:/data/database.db
ENV UniversalDashboard__AssetsFolder C:/data/UniversalDashboard 
ENV Logging__Path C:/data/logs/log.txt
ENTRYPOINT ["C:/ProgramData/Universal/Universal.Server.exe"]

Lancez une construction avec la commande build :

docker build . --tag=universal-persistent

Démarrez le conteneur Docker avec la commande run et assurez-vous de spécifier le volume à monter :

docker run -it --name powershelluniversal --mount source=psudata,target=/home/data --rm -d  -p 5000:5000/tcp universal-persistent:latest

SQL

Pour utiliser la persistance SQL, définissez l'extension et la chaîne de connexion comme suit :

ENV Data__ConnectionString=Data Source=ServerName; Initial Catalog=DatabaseName; Integrated Security=SSPI;
ENV Plugins:0=SQL

PostgreSQL

Pour utiliser la persistance PostgreSQL, définissez l'extension et la chaîne de connexion comme suit :

ENV Data__ConnectionString=Host=PGhostname; Database=PGdatabase; User Id=PGusername; Password=PGpassword!;Port=5432
ENV Plugins:0=PostgreSQL

Fuseaux horaires

Pour prendre en charge correctement les fuseaux horaires sous Linux lors de la planification de tâches, incluez le paquet tzdata dans votre Dockerfile ainsi qu'une variable d'environnement qui spécifie le fuseau horaire du serveur.

ENV TZ Europe/Amsterdam
RUN apt-get install -y tzdata

Étiquettes

Nous publions les étiquettes suivantes sur Docker Hub :

• latest - Version actuelle utilisant Ubuntu LTS
• 2026.x-<OS>-<PS> - Version de production avec le système d'exploitation et la version PS spécifiés
• 2026.x-modules - Version de production actuelle sur Ubuntu LTS avec certains modules AZ installés
• 4.x-<OS>-<PS> - Version de production actuelle 4 avec les systèmes d'exploitation et versions PS spécifiés

Modules inclus

Les images de conteneur de modules incluent les modules suivants :

• Az.Accounts
• Az.Compute
• Az.KeyVault
• Az.Resources
• Invoke-SqlCmd2

Résumé

Ce guide de démarrage de base vous permet de commencer à exécuter ou à construire des conteneurs PSU. Cette section de références regroupe toutes les sources de commandes :

Références

Exécution de conteneurs

https://docs.docker.com/engine/reference/commandline/run/

https://docs.docker.com/engine/reference/commandline/stop/

https://docs.docker.com/engine/reference/commandline/rm/

https://docs.docker.com/compose/

Construction de conteneurs

https://docs.docker.com/engine/reference/commandline/build/