Docker
Docker
Confirmer que Docker est installé correctement
REMARQUE : Appareils Apple M1 : au moment de la rédaction, certains problèmes existent sur les appareils Apple M1 et sur certains appareils ARM64/ARMv8. Veuillez consulter le forum PowerShell Universal avant de continuer.
Docker
Exécutez la commande suivante pour confirmer que Docker est installé :
docker versionExemple 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. Depuis juin 2023, la prise en charge de Docker Compose v1 est terminée.
Docker Compose v2 utilise la commande docker compose.
Si vous utilisez Docker Compose v1, veuillez ajuster les commandes en conséquence. Vous trouverez plus d'information sur Docker Compose ici.
Exécutez l'une des commandes suivantes pour confirmer que Docker Compose est installé :
Docker Compose v1 :
Docker Compose v2 :
Exemple de sortie :
Un Hello-World Docker
Pour vous assurer que Docker est en mesure d'extraire et d'exécuter des images de conteneur, exécutez la commande suivante :
Exemple de sortie :
Installation
Utiliser le 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 extrayant l'image, puis en exécutant un conteneur avec le port par défaut lié.
Exécuter une image de base
Présenter une image sur un port différent
Si le port 5000 n'est pas disponible sur votre hôte, utilisez un autre port.
p. ex. Présenter sur le port 80
Monter un volume
La commande docker run vous permet de monter un volume pour le 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 :
Monter un volume sur un conteneur sous Mac et Linux
La commande suivante monte le dossier /docker/volumes/PSU dans /root sur votre conteneur :
Arrêter un conteneur
La commande suivante arrête un conteneur en cours d'exécution nommé PSU :
Supprimer un conteneur
La commande suivante supprime un conteneur arrêté nommé PSU :
L'indicateur --force peut supprimer un conteneur en cours d'exécution :
Docker Compose
Docker Compose vous permet d'utiliser un fichier texte yaml pour normaliser votre génération et scripter le déploiement (ou la génération) de plusieurs conteneurs.
Le nom par défaut de tout fichier compose est docker-compose.yml. Il est recommandé de l'utiliser comme nom de fichier compose.
Créer un script Compose pour Windows
Le fichier compose suivant exécute un conteneur PowerShell Universal sous Windows :
Créer un script Compose pour Mac / Linux
Le fichier compose suivant exécute un conteneur PowerShell Universal sous Mac et Linux :
Démarrer des conteneurs à l'aide de scripts Compose
À l'aide d'un shell Terminal ou de PowerShell pour Windows. Utilisez la commande cd pour changer le répertoire de travail vers celui contenant votre script docker-compose.yml.
Exécutez la commande suivante :
Exemple de sortie :
Arrêter des conteneurs à l'aide de scripts Compose
À l'aide d'un shell Terminal ou de PowerShell pour Windows. Utilisez cd pour accéder au répertoire contenant votre script docker-compose.yml.
Exécutez la commande suivante
Exemple de sortie :
Utiliser des variables d'environnement et la persistance SQL
Vous pouvez ajouter des variables d'environnement dans vos scripts Compose. Voici un exemple de :
Définition d'un nom de nœud
Ajout de la persistance SQL
Ajout d'une chaîne de connexion SQL
Utiliser des variables d'environnement et la persistance PostgreSQL
Vous pouvez ajouter des variables d'environnement dans vos scripts Compose. Voici un exemple de :
Définition d'un nom de nœud
Ajout de la persistance PostgreSQL
Ajout d'une chaîne de connexion PostgreSQL
Créer un conteneur personnalisé
Si vous souhaitez ajouter d'autres fonctionnalités, modifier ou coder en dur des variables d'environnement dans votre conteneur, créez un Dockerfile
REMARQUE : Les Dockerfile respectent 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 comme 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 dépôt et la base de données Universal dans le volume, puis définit Universal.Server comme point d'entrée du conteneur.
Écrire un script Dockerfile pour Linux
Créer un conteneur
Depuis le chemin qui héberge votre Dockerfile, exécutez la commande suivante :
Windows
Lancez une génération avec la commande build :
Démarrez le conteneur docker avec la commande run et assurez-vous de spécifier le volume à monter :
SQL
Pour utiliser la persistance SQL, définissez le module d'extension et la chaîne de connexion comme suit :
PostgreSQL
Pour utiliser la persistance PostgreSQL, définissez le module d'extension et la chaîne de connexion comme suit :
Fuseaux horaires
Pour prendre correctement en charge les fuseaux horaires sous Linux lors de la planification des tâches, incluez le paquet tzdata dans votre dockerfile ainsi qu'une variable d'environnement qui spécifie le fuseau horaire du serveur.
Étiquettes
Nous publions les étiquettes suivantes sur Docker Hub :
latest - Version actuelle utilisant Ubuntu LTS
2026.x-<OS>-<PS> - Version de production avec la version d'OS et de PS spécifiée
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 versions d'OS et de PS spécifiées
Modules inclus
Les images de conteneur des modules incluent les modules suivants :
Az.Accounts
Az.Compute
Az.KeyVault
Az.Resources
Invoke-SqlCmd2
Résumé
Ce « Comment démarrer » de base vous permet de commencer à exécuter ou à créer des conteneurs PSU. Cette section de références répertorie toutes les sources des commandes :
Références
Exécuter des 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/
Créer des conteneurs
https://docs.docker.com/engine/reference/commandline/build/
Mis à jour
Ce contenu vous a-t-il été utile ?