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.
# Instances gérées par MediaConnect Gateway
Une *instance* est une instance de calcul exécutée sur l'équipement de votre centre de données et gérée par MediaConnect Gateway. Cette instance est une implémentation locale du MediaConnect service et est contenue dans une passerelle.
Les instances utilisent des ponts pour communiquer entre votre centre de données et le AWS Cloud. Les instances sont créées en installant le logiciel sur un serveur sur site.
Cette section couvre les procédures de base pour travailler avec les passerelles.
**Topics**
+ [Enregistrement d'une instance de MediaConnect Gateway](gateway-components-instances-create.md)
+ [Annulation de l'enregistrement d'une instance de Gateway MediaConnect](gateway-components-instances-delete.md)
# Enregistrement d'une instance de MediaConnect Gateway
Vous pouvez enregistrer une instance en exécutant une commande Linux personnalisée sur l'appareil qui hébergera l'instance. Vous générez la commande en suivant le processus d'enregistrement de l'instance dans le AWS Management Console. L'enregistrement d'une instance à l'aide du n' AWS CLI est actuellement pas pris en charge.
**Contents**
+ [Conditions préalables](#gateway-components-instances-create-prerequisites)
+ [Procédure](#gateway-components-instances-create-procedure)
+ [Étapes suivantes](#gateway-components-instances-create-next-steps)
+ [Ressources supplémentaires](#gateway-components-instances-create-additional-resources)
## Conditions préalables
La procédure suivante suppose que vous avez déjà créé une passerelle.
## Procédure
**Pour enregistrer une instance de MediaConnect Gateway**
1. Ouvrez la MediaConnect console à l'adresse [https://console.aws.amazon.com/mediaconnect/](https://console.aws.amazon.com/mediaconnect/).
1. Dans le volet de navigation, sélectionnez **Gateways**.
1. Dans la section **Passerelles**, sélectionnez la passerelle sur laquelle vous souhaitez enregistrer l'instance.
1. Sur la page **Détails** de la passerelle, sélectionnez l'onglet **Instances**.
1. **Dans l'onglet Instances**, choisissez **Enregistrer une instance**.
1. Sur la page **Register les instances de Gateway**, effectuez les étapes suivantes :
1. Pour la **durée de validité de la clé d'activation**, entrez le nombre de jours pendant lesquels la clé d'activation restera active. Après ce nombre de jours, la clé ne fonctionnera plus lors de l'enregistrement d'une instance de passerelle.
1. Dans **le champ Nombre d'instances**, entrez le nombre d'instances que vous souhaitez enregistrer sur votre passerelle avec cette clé d'activation.
1. Pour **Instance role (Rôle d'instance)**, choisissez le rôle IAM à associer à vos instances externes.
1. Sélectionnez **Générer une commande d'enregistrement**.
1. Copiez la **commande Linux** qui s'affiche.
1. Exécutez la commande sur chaque instance que vous souhaitez enregistrer auprès de cette passerelle.
**Important**
La partie bash du script doit être exécutée en tant que root. Si la commande n'est pas exécutée en tant que racine, une erreur est renvoyée.
1. Après quelques minutes, l'instance s'enregistrera auprès de la passerelle. Toutes les instances enregistrées sur cette passerelle apparaîtront dans l'onglet **Instances**.
## Étapes suivantes
Après avoir enregistré une instance sur une MediaConnect passerelle, vous pouvez créer un pont sur cette instance. Pour obtenir des instructions, veuillez consulter [Création d'un pont MediaConnect Gateway](gateway-components-bridges-create.md).
## Ressources supplémentaires
+ [Annulation de l'enregistrement d'une instance de Gateway MediaConnect](gateway-components-instances-delete.md)
# Annulation de l'enregistrement d'une instance de Gateway MediaConnect
Vous pouvez annuler l'enregistrement d'une instance que vous ne souhaitez plus utiliser dans MediaConnect Gateway. En désenregistrant l'instance, elle ne prendra plus en charge les ponts et ne fera plus partie de votre passerelle.
**Contents**
+ [Conditions préalables](#gateway-components-instances-delete-prerequisites)
+ [Procédure](#gateway-components-instances-delete-procedure)
+ [Étapes suivantes](#gateway-components-instances-delete-next-steps)
+ [Réutilisation d'une instance de passerelle](#gateway-components-instances-reuse)
+ [Ressources supplémentaires](#gateway-components-instances-delete-additional-resources)
## Conditions préalables
La procédure suivante suppose que vous avez déjà enregistré au moins une instance sur votre passerelle.
## Procédure
**Pour désenregistrer une instance de passerelle**
1. Ouvrez la MediaConnect console à l'adresse [https://console.aws.amazon.com/mediaconnect/](https://console.aws.amazon.com/mediaconnect/).
1. Dans le volet de navigation, sélectionnez **Gateways**. Dans la section **Passerelles**, sélectionnez la passerelle qui contient l'instance que vous souhaitez désenregistrer.
1. Sur la page **Détails** de la passerelle, sélectionnez l'onglet **Instances**. Sélectionnez l'**ID d'instance** de l'instance que vous souhaitez désenregistrer.
1. Sélectionnez **Désenregistrer**.
1. **Confirmez le désenregistrement de l'instance en sélectionnant Désenregistrer l'instance.**
1. Répétez les étapes précédentes pour toutes les instances supplémentaires dont vous avez besoin pour annuler l'enregistrement.
## Étapes suivantes
### Réutilisation d'une instance de passerelle
Si vous souhaitez réutiliser l'instance pour Amazon ECS Anywhere ou en tant qu'autre instance de passerelle, vous devez suivre les étapes suivantes.
**Pour réutiliser une instance de passerelle (facultatif)**
1. Ouvrez la MediaConnect console à l'adresse [https://console.aws.amazon.com/mediaconnect/](https://console.aws.amazon.com/mediaconnect/).
1. Dans le volet de navigation, sélectionnez **Gateways**. Dans la section **Passerelles**, sélectionnez la passerelle qui contient l'instance que vous souhaitez réutiliser.
1. Sur la page **Détails** de la passerelle, sélectionnez l'onglet **Instances**. Localisez l'**ID d'instance** de l'instance que vous souhaitez réutiliser.
1. Assurez-vous que l'**état de l'instance** est **Désenregistré** pour l'instance que vous souhaitez réutiliser.
1. À partir d'un ordinateur disposant de cet accès, connectez-vous à l'instance via SSH.
1. Exécutez les commandes suivantes, dans l'ordre.
```
sudo docker stop $(sudo docker ps -f "name=MediaConnectGatewayAgent" -q); \
sudo docker stop ecs-agent; \
sudo systemctl stop ecs amazon-ssm-agent; \
sudo yum remove -y amazon-ecs-init amazon-ssm-agent; `# or apt or snap as needed` \
sudo rm /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm -rf; \
sudo docker rm -f ecs-agent ssm-agent; \
sudo docker container rm -f $(sudo docker ps -a -f "name=MediaConnectGatewayAgent" -q); \
sudo docker volume rm -f ecsdata docker run; \
sudo pkill -f -KILL network_bootstra[p]; \
sudo pkill -KILL mcproxy;
```
## Ressources supplémentaires
Pour plus d'informations sur la suppression d'une MediaConnect passerelle et de ses réseaux, consultez[Supprimer une MediaConnect passerelle](gateway-cleanup-console.md).