Deploy IronSecureDoc to AWS with C# Container Instance

Étape 1 : Connectez-vous à votre compte AWS

Connectez-vous au portail AWS.

Si vous ne possédez pas de compte AWS, veuillez en créer un .

Étape 2 : Créer un cloud privé virtuel

Vous pouvez utiliser Amazon Virtual Private Cloud (Amazon VPC) pour déployer des ressources AWS dans un réseau virtuel que vous avez défini. Nous vous recommandons vivement de lancer vos instances de conteneurs dans un VPC.

Si vous disposez d'un VPC par défaut, vous pouvez ignorer cette section et passer à l'étape suivante : " Créer un groupe de sécurité ". Pour savoir si vous disposez d'un VPC par défaut, consultez la section " Plateformes prises en charge " de la console Amazon EC2 dans le Guide de l'utilisateur Amazon EC2. Sinon, vous pouvez créer un VPC non par défaut dans votre compte en suivant les étapes ci-dessous.

Pour plus d'informations sur la création d'un VPC, consultez la section " Créer un VPC " du Guide de l'utilisateur Amazon VPC et utilisez le tableau suivant pour déterminer les options à sélectionner.

Pour plus d'informations sur Amazon VPC, consultez Qu'est-ce qu'Amazon VPC ? dans le Guide de l'utilisateur Amazon VPC.

Étape 3 : Créer un groupe de sécurité

Les groupes de sécurité font office de pare-feu pour les instances de conteneurs associées, contrôlant le trafic entrant et sortant au niveau de l'instance de conteneur. Vous pouvez ajouter des règles à un groupe de sécurité qui vous permettent de vous connecter à votre instance de conteneur depuis votre adresse IP en utilisant SSH. Vous pouvez également ajouter des règles autorisant les accès HTTP et HTTPS entrants et sortants depuis n'importe où. Ajoutez les règles nécessaires à l'ouverture des ports requis par vos tâches. Les instances de conteneurs nécessitent un accès réseau externe pour communiquer avec le point de terminaison du service Amazon ECS.

Pour plus d'informations sur la création d'un groupe de sécurité, consultez la section " Créer un groupe de sécurité " du Guide de l'utilisateur Amazon EC2 et utilisez le tableau suivant pour déterminer les options à sélectionner.

Étape 4 : Créer un cluster ECS

Sur la page d'accueil du portail AWS, recherchez " ECS " dans le champ de recherche et sélectionnez " Elastic Container Service ". Ou ouvrez la console à l' adresse https://console.aws.amazon.com/ecs/v2 .

Sélectionnez " Créer un cluster ".

Saisissez le " Nom du cluster ". Dans la section Infrastructure, sélectionnez uniquement " AWS Fargate (sans serveur) ".

Laissez les autres valeurs par défaut, puis sélectionnez Créer .

Étape 5 : Créer une définition de tâche

Une fois le cluster créé, sélectionnez Définitions des tâches.

Sélectionnez " Créer une nouvelle définition de tâche ", puis sélectionnez " Créer une nouvelle définition de tâche ".

Dans la section de configuration de la définition de tâche , saisissez la valeur de la famille de définition de tâche .

Dans la section " Configuration requise pour l'infrastructure " , saisissez les valeurs suivantes pour le type de lancement , le processeur , la mémoire , le rôle de la tâche et le rôle d'exécution de la tâche .

• Type de lancement : Uniquement AWS Fargate
• Processeur : 1 vCPU
• Mémoire : 2 GB
• Rôle dans la tâche : ecsTaskExecutionRole
• Rôle d'exécution de la tâche : ecsTaskExecutionRole

Dans la section Conteneur - 1 , saisissez les valeurs suivantes pour Nom , URI de l'image , Port du conteneur , Nom du port et Variables d'environnement .

• Nom : mycontainer
• URI de l'image : utilisez ironsoftwareofficial/ironsecuredoc pour la version la plus récente ou spécifiez-la par étiquette ironsoftwareofficial/ironsecuredoc:2024.7.1
• Port de conteneur : 8080
• Nom du port : 8080
• Ajouter des variables d'environnement :
  • ENVIRONMENT: Production
  • HTTP_PORTS: 8080
  • IronSecureDoc_LicenseKey: YOUR-LICENSE-KEY

Pour IronSecureDoc_LicenseKey, il n'est pas recommandé d'ajouter directement dans les variables d'environnement pour des raisons de sécurité. Il est recommandé de récupérer le fichier d'environnement à partir d'un compartiment Amazon S3 chiffré, voir Transmettre des données sensibles à un conteneur Amazon ECS .

Laissez les autres valeurs par défaut, puis sélectionnez Créer .

Étape 6 : Créer un service

Retournez à la page Clusters > Sélectionnez votre cluster (IronSecureDoc).

Sélectionnez l'onglet " Service " > puis sélectionnez " Créer ".

Dans la section Environnement , saisissez les valeurs suivantes pour les options de calcul et le type de lancement .

• Options de calcul : Sélectionnez Launch type
• Type de lancement : Sélectionner FARGATE

Dans la section Configuration du déploiement , saisissez les valeurs suivantes pour Type d'application , Famille , Révision , Nom du service et Tâches souhaitées .

• Type d'application : Sélectionner Service
• Définition de la tâche :
  • Famille : Sélectionnez la définition de tâche créée ironsecuredoc
  • Révision : Sélectionner la révision de la définition de tâche 1 (LATEST)
• Nom du service : myservice
• Tâches souhaitées : 1

Veuillez noter que pour la mise en réseau, vous devrez peut-être créer un VPC et un groupe de sécurité s'ils n'existent pas déjà.

Laissez les autres valeurs par défaut, puis sélectionnez Créer .

Lorsque le déploiement démarre, une notification apparaît pour indiquer que le déploiement est en cours. Une autre notification s'affiche une fois le service déployé.

Consultez votre service > puis ouvrez la tâche.

Dans la configuration des tâches, vous pouvez utiliser l'adresse IP publique pour exécuter une commande curl afin de vérifier si l'API fonctionne correctement, ce qui devrait renvoyer pong.

curl http://18.118.166.206:8080/v1/document-services/ping

curl http://18.118.166.206:8080/v1/document-services/ping

Félicitations ! En configurant seulement quelques paramètres, vous avez déployé une application accessible au public dans Amazon Elastic Container Service.