For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 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. 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 ?