> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/fr/getting-started/docker.md). # 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](https://forums.ironmansoftware.com/t/docker-image-not-working/8781/15) 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](https://docs.docker.com/compose/). 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](https://hub.docker.com/r/ironmansoftware/universal). 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 : ```yml 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 : ```yml 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 ```yaml 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 ```yaml 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 ```docker 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 ```docker 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-\-\ - 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-\-\ - 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 ### Construction de conteneurs --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/fr/getting-started/docker.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.