Variables d'environnement Docker Compose (Tutoriel pour développeurs)

Introduction

Déployer des applications à travers différents environnements entraîne souvent des problèmes de compatibilité. Une application peut fonctionner parfaitement sur la machine d'un développeur mais rencontrer des problèmes lors des tests ou en production en raison de différences dans les systèmes d'exploitation, les dépendances ou les configurations. Docker résout ce problème en emballant les applications dans des unités autonomes qui incluent tout le nécessaire pour exécuter l'application, garantissant ainsi qu'elle fonctionne de manière cohérente partout, de la phase de développement à la production.

Docker Compose apporte des avantages puissants aux applications conteneurisées, notamment avec son utilisation des variables d'environnement pour simplifier la configuration à travers différents environnements. En permettant de gérer les paramètres clés en dehors du code, Docker Compose facilite et sécurise le déploiement d'applications complexes. En nous appuyant sur ces avantages, cet article montrera également comment vous pouvez utiliser IronSecureDocpour un traitement sécurisé des documents, tirant parti de la flexibilité de Docker Compose pour gérer efficacement les configurations de chiffrement et de rédaction.

Qu'est-ce que Docker ?

Dockerest un système open-source conçu pour faciliter le développement, le déploiement et l'exécution d'applications dans un système grâce à la conteneurisation. Les conteneurs sont des unités portables ultra-légères qui contiennent à la fois une application et ses dépendances, de sorte qu'elles fonctionnent uniformément partout, de la machine du développeur aux serveurs de production. Les conteneurs partagent le noyau du système d'exploitation de l'hôte par rapport aux machines virtuelles traditionnelles et sont donc beaucoup plus rapides et plus efficaces.

Cela signifierait un modèle virtualisé sous forme d'images Docker pour créer et maintenir cet ensemble de conteneurs. En outre, la plateforme contient Docker Hub, qui est en quelque sorte un dépôt d'images de conteneurs. La beauté de cette technologie réside dans sa facilité d'utilisation en ce qui concerne la scalabilité, la portabilité et l'efficacité, ce qui est une des raisons pour lesquelles elle a gagné une telle popularité parmi de nombreux flux de travail DevOps et de développement basé sur le cloud.

Quelles sont les variables d'environnement dans Docker-Compose ?

Dans Docker, une variable d'environnement sous la forme d'une paire clé-valeur est utilisée pour configurer les paramètres de l'application conteneurisée. De telles variables peuvent être utiles pour contrôler le comportement de l'application elle-même sans modifier son code, car elles permettent de configurer facilement des informations telles que les identifiants de base de données et les clés API ou les modes d'environnement.(par exemple : développement, production)peut être modifié.

Dans Docker, un attribut d'environnement peut être défini à l'intérieur du Dockerfile, à l'intérieur du fichier docker-compose.yml, ou passé lors de l'exécution en utilisant la commande docker run. Avec l'utilisation de variables d'environnement, Docker permet un déploiement d'applications cohérent et flexible à travers différents environnements et gère plus efficacement les données sensibles telles que les mots de passe et les jetons API.

Comment créer des variables d'environnement dans Docker ?

Nous pouvons définir des variables d'environnement dans Docker de plusieurs manières. Ils peuvent être définis avec un fichier Docker Compose, le fichier docker-compose.yml, dans un fichier d'environnement, ou même au moment de l'exécution, lorsque vous exécutez la commande docker run. N'oubliez pas que garder les variables d'environnement séparées du fichier de configuration principal permet une organisation plus facile des variables.! Voici une liste des différentes méthodes que vous pouvez appliquer pour définir vos variables.

Définir les variables d'environnement dans le fichier Docker

Nous pouvons définir des variables d'environnement directement dans le fichier Docker, en utilisant l'instruction ENV. Cela peut être utile si vous souhaitez inclure des valeurs par défaut pour les variables dans votre image Docker.

# Dockerfile
ENV APP_ENV=devepolment
ENV DATABASE_URL=postgres://user:password@db:1234/mydev

# Dockerfile
ENV APP_ENV=devepolment
ENV DATABASE_URL=postgres://user:password@db:1234/mydev

#Dockerfile
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'ENV APP_ENV=devepolment ENV DATABASE_URL=postgres: 'user:password@db:1234/mydev

La configuration des variables d'environnement avec les valeurs définies dans le fichier Docker entraînera automatiquement l'exécution du conteneur.

Définir les variables d'environnement dans Docker-Compose.yml

Nous pouvons définir des variables d'environnement pour chaque service à l'intérieur d'un fichier docker-compose.yml à l'aide du mot-clé environment. C'est pratique lorsque vous utilisez Docker Compose pour gérer plusieurs services.

version: '3.8'
services:
  myapp:
    image: myapp:latest
    environment:
      - APP_ENV=development
      - DATABASE_URL=postgres://user:password@db:1234/mydev

version: '3.8'
services:
  myapp:
    image: myapp:latest
    environment:
      - APP_ENV=development
      - DATABASE_URL=postgres://user:password@db:1234/mydev

version:
'INSTANT VB TODO TASK: The following line uses invalid syntax:
''3.8' services: myapp: image: myapp:latest environment: - APP_ENV=development - DATABASE_URL=postgres: 'user:password@db:1234/mydev

Définir les variables d'environnement à l'exécution

Nous pouvons spécifier des variables d'environnement lors de l'exécution d'un conteneur en utilisant l'option -e avec la commande docker run. Ceci est utile pour les valeurs transitoires et dynamiques, que vous n'ajouteriez probablement pas au fichier Docker.

docker run -e APP_ENV=development -e DATABASE_URL=postgres://user:password@db:1234/mydev:latest

docker run -e APP_ENV=development -e DATABASE_URL=postgres://user:password@db:1234/mydev:latest

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'docker run -e APP_ENV=development -e DATABASE_URL=postgres: 'user:password@db:1234/mydev:latest

Utilisation de fichiers d'environnement (.env)

Nous pouvons stocker des variables d'environnement dans un fichier comme `.env` et les charger dans vos conteneurs Docker. Dans Docker Compose, nous y ferons référence avec la directive env file.

APP_ENV=production
DATABASE_URL=postgres://user:password@db:1234/mydev

APP_ENV=production
DATABASE_URL=postgres://user:password@db:1234/mydev

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'APP_ENV=production DATABASE_URL=postgres: 'user:password@db:1234/mydev

Nous pouvons gérer plusieurs fichiers, avec des variables d'environnement en dehors des fichiers de configuration grâce à l'aide de fichiers env.

Qu'est-ce qu'IronSecureDoc ?

IronSecureDocpour Docker permet aux développeurs d'ajouter facilement une capacité de traitement sécurisé des documents à leurs applications conteneurisées. Après avoir enfin appris Docker, vous pouvez encapsuler votre application ASP.NET Core avec IronSecureDoc dans un environnement homogène qui facilite le déploiement et la mise à l'échelle. Pour ce faire, vous allez créer un Dockerfile qui orchestre la construction de votre application ASP.NET Core en utilisant la bibliothèque IronSecureDoc et éventuellement d'autres scripts d'installation ou configurations nécessaires pour faire fonctionner le tout.

De plus, il inclut un fichier docker-compose.yml déclarant les dépendances de service, les variables d'environnement et les ports mappés à utiliser. Cela rend les tâches de sécurité documentaire beaucoup plus accessibles, permettant à votre application de fonctionner de manière efficace et efficiente dans un environnement différent de celui utilisé lors du développement ou de la production. Installation et configuration d'IronSecureDoc Comme dans le cas de Docker, une installation et une configuration appropriées d'IronSecureDoc seront nécessaires pour exploiter pleinement ses capacités : chiffrement de documents, rédaction, etc.

Caractéristiques principales d'IronSecureDoc

IronSecureDoc propose une gamme de fonctionnalités puissantes pour la sécurité des PDF et la gestion des documents :

• Cryptage : Offre un cryptage en 128 ou 256 bits avec une sécurité basée sur un mot de passe pour protéger la confidentialité des documents.
• Rédaction : Supprime les informations sensibles, telles que les identifiants personnels, pour répondre aux normes et régulations de confidentialité.
• Signature numérique : Prend en charge la signature numérique et la notarisation avec des certificats .pfx ou .p12 pour garantir l'authenticité des documents.
• API REST : Une API flexible permet une intégration transparente avec d'autres logiciels et flux de travail.

• Intégration Docker : Le support natif pour Docker simplifie le déploiement et la mise à l'échelle pour les applications cloud ou sur site.

  Ces fonctionnalités font d'IronSecureDoc un excellent choix pour les secteurs gérant des documents sensibles, tels que le juridique, la santé et la finance.

Installation et exécution d'IronSecureDoc

Étape 1

Pour installer IronSecureDoc, exécutez la commande ci-dessous dans une fenêtre de terminal ou dans l'Invite de commandes pour obtenir l'image Docker IronSecureDoc depuis le dépôt.

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'docker pull ironsoftwareofficial/ironsecuredoc

Étape 2

Une fois que l'image IronSecureDoc a été extraite. nous pouvons utiliser la commande docker-compose ci-dessous pour exécuter l'image dans le conteneur Docker.

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

Nous utilisons le conteneur Docker pour exécuter le dépôt officiel de Iron Software. La ligne de commande ci-dessus est décomposée en plusieurs parties qui sont expliquées ci-dessous.

Explication de commande

• docker container run - Cette commande utilise l'image donnée pour construire et lancer un nouveau conteneur Docker.
• --rm - nettoie automatiquement le conteneur immédiatement après son arrêt. Il supprime tous les conteneurs inutilisés à la fin de tout processus.
• -p 8080:8080 - Permettez-lui de publier le port 8080 du conteneur, afin que vous puissiez y accéder sur votre machine via http://localhost:8080.
• -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> - Définissez une variable d'environnement dans le conteneur en cours d'exécution nommée IronSecureDoc_LicenseKey qui vous permet d'activer et d'utiliser les fonctionnalités sous licence de IronSecureDoc. Remplacez <IRONSECUREDOC_LICENSE_KEY> par votre clé réelle.
• -e ENVIRONMENT=Development - La variable d'environnement est définie sur Development. Cela signifie que le conteneur doit être exécuté en mode développement. Normalement, ce conteneur est utilisé pour les cas de test ou de débogage ; autrement, cela diffère des configurations non productives.
• -e HTTP_PORTS=8080 - Cette variable d'environnement est utilisée pour spécifier que le conteneur doit exposer et écouter le port 8080 pour le trafic HTTP. Cela garantit l'accès au service à l'intérieur du conteneur en passant par ce port particulier.
• ironsoftwareofficial/ironsecuredoc:latest - Ceci est simplement une image Docker. Le docker propre créera la version la plus récente de l'image disponible dans le registre de Docker pour IronSecureDoc.

Conteneur IronSecuredoc

L'API REST d'IronSecureDoc permet aux utilisateurs de caviarder, certifier et chiffrer des documents après son lancement dans Docker. cette fonctionnalité est également mentionnée ailleurs. Voici un lien vers lePoints de terminaison APIet documentation avec Swagger UI, une fois que vous avez lancé IronSecureDoc dans un conteneur Docker : http://localhost:8080/swagger/index.html.

À partir de l'exemple ci-dessus, nous pouvons envoyer une requête POST à l'API IronSecureDoc pour soumettre un document pour chiffrement :

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'curl -X 'POST' \ 'http: -H 'accept: */ *' \ -H 'Content-Type: multipart/form-data' \ -F 'pdf_file=@test.pdf;type=application/pdf'

En faisant cela, IronSecureDoc obtiendra le document et le chiffrera correctement.

Conclusion

En résumé, les variables d'environnement de Docker Compose permettent de configurer les applications de manière très flexible et efficace, car les détails de configuration sont automatiquement séparés du code de l'application. Par conséquent, gérer différents environnements tels que le développement, les tests et la production est plus simple, car seules les variables telles que les clés API, les identifiants de base de données et les paramètres d'une application doivent être modifiés, au lieu de son code.

L'utilisation de Docker Compose pour implémenter IronSecureDoc utilise des variables d'environnement pour gérer de manière sécurisée les informations de licence, par exemple, IronSecureDoc_LicenseKey, et également pour spécifier les ports HTTP ou le mode d'environnement préféré en tant que développement ou production à l'aide de variables d'environnement. Utiliser des variables d'environnement pour la configuration simplifie le déploiement d'IronSecureDoc avec des configurations moins encombrées et difficiles à adapter tout en augmentant la sécurité.

Les fonctionnalités avancées deviennent accessibles grâce à un validelicensed'IronSecureDoc. L'application de l'outil dépend strictement de certaines conditions d'utilisation. Bien que vous puissiez également utiliser d'autres bibliothèques haute performance quiIronSoftwareoffre de rendre le processus de développement plus facile et plus rapide, en fournissant des fonctionnalités robustes pour travailler avec des PDF, la reconnaissance de texte et les codes-barres pour toute application concevable.