Avis de fin de support : le 20 mai 2026, AWS le support de AWS SimSpace Weaver. Après le 20 mai 2026, vous ne pourrez plus accéder à la SimSpace Weaver console ni aux SimSpace Weaver ressources. Pour plus d'informations, voir [AWS SimSpace Weaver fin du support](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html). Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Conteneurs personnalisés AWS SimSpace Weaver les applications s'exécutent dans des environnements conteneurisés Amazon Linux 2 (AL2). Dans le AWS Cloud, SimSpace Weaver exécute vos simulations dans des conteneurs Docker créés à partir d'une `amazonlinux:2` image fournie par Amazon Elastic Container Registry (Amazon ECR). Vous pouvez créer une image Docker personnalisée, la stocker dans Amazon ECR et utiliser cette image pour votre simulation au lieu de l'image Docker par défaut que nous fournissons. Vous pouvez utiliser un conteneur personnalisé pour gérer vos dépendances logicielles et inclure des composants logiciels supplémentaires qui ne figurent pas dans l'image Docker standard. Par exemple, vous pouvez ajouter au conteneur les bibliothèques logicielles accessibles au public utilisées par votre application et ne placer votre code personnalisé que dans le fichier zip de l'application. **Important** Nous prenons uniquement en charge les images AL2 Docker hébergées dans les référentiels Amazon ECR, que ce soit dans la galerie publique Amazon ECR ou dans votre registre Amazon ECR privé. Nous ne prenons pas en charge les images Docker hébergées en dehors d'Amazon ECR. Pour plus d'informations sur Amazon ECR, consultez la *[documentation Amazon Elastic Container Registry](https://docs.aws.amazon.com/ecr)*. **Topics** + [ # Création d'un conteneur personnalisé ](working-with_custom-containers_create.md) + [ # Modifier un projet pour utiliser un conteneur personnalisé ](working-with_custom-containers_modify-project.md) + [ # Questions fréquemment posées sur les conteneurs personnalisés ](working-with_custom-containers_faq.md) + [ # Résolution des problèmes liés aux conteneurs personnalisés ](working-with_custom-containers_troubleshooting.md) # Création d'un conteneur personnalisé Ces instructions supposent que vous savez comment utiliser Docker et Amazon Elastic Container Registry (Amazon ECR). Pour plus d'informations sur la sécurité dans Amazon ECR, veuillez consulter le *[Guide de l'utilisateur Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide)*. **Conditions préalables** + L'identité IAM (utilisation ou rôle) que vous utilisez pour effectuer ces actions dispose des autorisations appropriées pour utiliser Amazon ECR + Docker est installé sur votre système local **Pour créer un conteneur personnalisé** 1. Créez votre `Dockerfile`. `Dockerfile`Pour exécuter des AWS SimSpace Weaver applications, commencez par l'Amazon Linux 2image dans Amazon ECR. ``` # parent image required to run AWS SimSpace Weaver apps FROM public.ecr.aws/amazonlinux/amazonlinux:2 ``` 1. Construisez votre`Dockerfile`. 1. Téléchargez l'image de votre conteneur sur Amazon ECR. + [Utilisez le AWS Management Console.](https://docs.aws.amazon.com/AmazonECR/latest/userguide/getting-started-console.html) + [Utilisez le AWS Command Line Interface.](https://docs.aws.amazon.com/AmazonECR/latest/userguide/getting-started-cli.html) **Note** Si un `AccessDeniedException` message d'erreur s'affiche lorsque vous essayez de télécharger votre image de conteneur sur Amazon ECR, il est possible que votre identité IAM (utilisateur ou rôle) ne dispose pas des autorisations nécessaires pour utiliser Amazon ECR. Vous pouvez associer la politique `AmazonEC2ContainerRegistryPowerUser` AWS gérée à votre identité IAM et réessayer. Pour plus d'informations sur la façon d'associer une politique, consultez la section [Ajout et suppression d'autorisations d'identité IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le *Guide de l'Gestion des identités et des accès AWS utilisateur*. # Modifier un projet pour utiliser un conteneur personnalisé Ces instructions supposent que vous savez déjà comment utiliser vos processus de stockage AWS SimSpace Weaver et de développement d'applications et que vous souhaitez les rendre AWS Cloud plus efficaces. **Conditions préalables** + Vous avez un conteneur personnalisé dans Amazon Elastic Container Registry (Amazon ECR). Pour plus d'informations sur la création d'un conteneur personnalisé, consultez[Création d'un conteneur personnalisé](working-with_custom-containers_create.md). **Pour modifier votre projet afin d'utiliser un conteneur personnalisé** 1. Ajoutez des autorisations au rôle d'application de simulation de votre projet pour utiliser Amazon ECR. 1. Si vous ne disposez pas encore d'une stratégie IAM avec les autorisations suivantes, créez-la. Nous suggérons le nom de la politique`simspaceweaver-ecr`. Pour plus d'informations sur la création d'une stratégie IAM, consultez la section [Création de politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) dans le Guide de l'*Gestion des identités et des accès AWS utilisateur*. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "Statement", "Effect": "Allow", "Action": [ "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer", "ecr:GetAuthorizationToken" ], "Resource": "*" } ] } ``` 1. Trouvez le nom du rôle de l'application de simulation de votre projet : 1. Dans un éditeur de texte, ouvrez le CloudFormation modèle : ``` sdk-folder\PackagingTools\sample-stack-template.yaml ``` 1. Trouvez la `RoleName` propriété ci-dessous`WeaverAppRole`. La valeur est le nom du rôle de l'application de simulation de votre projet. **Example** ``` AWSTemplateFormatVersion: "2010-09-09" Resources: WeaverAppRole: Type: 'AWS::IAM::Role' Properties: RoleName: 'weaver-MySimulation-app-role' AssumeRolePolicyDocument: Version: "2012-10-17" Statement: - Effect: Allow Principal: Service: - 'simspaceweaver.amazonaws.com' ``` 1. Associez la `simspaceweaver-ecr` politique au rôle d'application de simulation du projet. Pour plus d'informations sur la façon d'associer une politique, consultez la section [Ajout et suppression d'autorisations d'identité IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le *Guide de l'Gestion des identités et des accès AWS utilisateur*. 1. Accédez à la pile d'échantillons `sdk-folder` et exécutez-la pour mettre à jour la SimSpace Weaver pile d'échantillons : ``` python setup.py --cloudformation ``` 1. Spécifiez les images de vos conteneurs dans le schéma de simulation du projet. + Vous pouvez ajouter la `default_image` propriété facultative ci-dessous `simulation_properties` pour spécifier une image de conteneur personnalisée par défaut pour tous les domaines. + Ajoutez la `image` propriété dans le `app_config` pour le domaine dans lequel vous souhaitez utiliser une image de conteneur personnalisée. Spécifiez l'URI du référentiel Amazon ECR comme valeur. Vous pouvez spécifier une image différente pour chaque domaine. + Si `image` ce n'est pas spécifié pour un domaine mais si `default_image` c'est le cas, les applications de ce domaine utilisent l'image par défaut. + Si `image` ce n'est pas spécifié pour un domaine et `default_image` ne l'est pas, les applications de ce domaine s'exécutent dans un SimSpace Weaver conteneur standard. **Example Extrait de schéma incluant des paramètres de conteneur personnalisés** ``` sdk_version: "1.17.0" simulation_properties: log_destination_service: "logs" log_destination_resource_name: "MySimulationLogs" default_entity_index_key_type: "Vector3" default_image: "111122223333.dkr.ecr.us-west-2.amazonaws.com/my-ecr-repository:latest" # image to use if no image specified for a domain domains: MyCustomDomain: launch_apps_via_start_app_call: {} app_config: package: "s3://weaver-myproject-111122223333-us-west-2/MyViewApp.zip" launch_command: ["MyViewApp"] required_resource_units: compute: 1 endpoint_config: ingress_ports: - 7000 image: "111122223333.dkr.ecr.us-west-2.amazonaws.com/my-ecr-repository:latest" # custom container image to use for this domain MySpatialDomain: launch_apps_by_partitioning_strategy: partitioning_strategy: "MyGridPartitioning" grid_partition: x: 2 y: 2 app_config: package: "s3://weaver-myproject-111122223333-us-west-2/MySpatialApp.zip" launch_command: ["MySpatialApp"] required_resource_units: compute: 1 image: "111122223333.dkr.ecr.us-west-2.amazonaws.com/my-ecr-repository:latest" # custom container image to use for this domain ``` 1. Créez et téléchargez votre projet comme d'habitude. # Questions fréquemment posées sur les conteneurs personnalisés ## Q1. Que dois-je faire si je souhaite modifier le contenu de mon contenant ? + **Pour une simulation en cours d'exécution** : vous ne pouvez pas modifier le conteneur d'une simulation en cours d'exécution. Vous devez créer un nouveau conteneur et démarrer une nouvelle simulation utilisant ce conteneur. + **Pour une nouvelle simulation** : créez un nouveau conteneur, chargez-le sur Amazon Elastic Container Registry (Amazon ECR) et lancez une nouvelle simulation utilisant ce conteneur. ## Q2. Comment puis-je modifier l'image du conteneur pour ma simulation ? + **Pour une simulation en cours d'exécution** : vous ne pouvez pas modifier le conteneur d'une simulation en cours d'exécution. Vous devez démarrer une nouvelle simulation utilisant le nouveau conteneur. + **Pour une nouvelle simulation** : spécifiez la nouvelle image du conteneur dans le schéma de simulation de votre projet. Pour de plus amples informations, veuillez consulter [Modifier un projet pour utiliser un conteneur personnalisé](working-with_custom-containers_modify-project.md). # Résolution des problèmes liés aux conteneurs personnalisés **Topics** + [ # AccessDeniedException lors du chargement de votre image sur Amazon Elastic Container Registry (Amazon ECR) ](working-with_custom-containers_troubleshooting_access-denied.md) + [ # Une simulation utilisant un conteneur personnalisé ne démarre pas ](working-with_custom-containers_troubleshooting_no-start.md) # AccessDeniedException lors du chargement de votre image sur Amazon Elastic Container Registry (Amazon ECR) Si un `AccessDeniedException` message d'erreur s'affiche lorsque vous essayez de télécharger votre image de conteneur sur Amazon ECR, il est possible que votre identité IAM (utilisateur ou rôle) ne dispose pas des autorisations nécessaires pour utiliser Amazon ECR. Vous pouvez associer la politique `AmazonEC2ContainerRegistryPowerUser` AWS gérée à votre identité IAM et réessayer. Pour plus d'informations sur la façon d'associer une politique, consultez la section [Ajout et suppression d'autorisations d'identité IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le *Guide de l'Gestion des identités et des accès AWS utilisateur*. # Une simulation utilisant un conteneur personnalisé ne démarre pas **Conseils pour le dépannage** + Si la journalisation est activée pour votre simulation, consultez vos journaux d'erreurs. + Testez votre simulation sans conteneur personnalisé. + Testez votre simulation localement. Pour de plus amples informations, veuillez consulter [Développement local en SimSpace Weaver](working-with_local-development.md).