View a markdown version of this page

Exécuter l'outil EC2Rescue sur les instances inaccessibles - AWS Systems Manager

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.

Exécuter l'outil EC2Rescue sur les instances inaccessibles

EC2Rescue peut vous aider à diagnostiquer et à résoudre les problèmes qui peuvent survenir sur les instances Amazon Elastic Compute Cloud (Amazon EC2) pour Linux et Windows Server. Vous pouvez exécuter l'outil manuellement, comme décrit dans Utilisation d'EC2Rescue pour Linux Server et Utilisation d'EC2Rescue pour Windows Server. Vous pouvez aussi exécuter l'outil automatiquement en utilisant Systems Manager Automation et le runbook AWSSupport-ExecuteEC2Rescue. Automation est un outil d’ AWS Systems Manager. Le AWSSupport-ExecuteEC2Rescue runbook est conçu pour effectuer une combinaison d'actions de Systems Manager et CloudFormation actions qui automatisent les étapes normalement requises pour utiliser EC2Rescue.

Vous pouvez utiliser le runbook AWSSupport-ExecuteEC2Rescue pour dépanner et potentiellement corriger différents types de problèmes liés aux systèmes d'exploitation (SE). Les instances avec des volumes racines chiffrés ne sont pas prises en charge. Pour obtenir une liste complète, consultez les rubriques suivantes :

Windows : consultez Action de résolution dans Utilisation d'EC2Rescue pour Windows Server avec la ligne de commande.

Linux et macOS : certains modules EC2Rescue pour Linux détectent et tentent de corriger des problèmes. Pour de plus amples informations, consultez la documentation aws-ec2rescue-linux pour chaque module sur GitHub.

Comment ça marche

Le dépannage d'une instance avec Automation et le runbook AWSSupport-ExecuteEC2Rescue fonctionne le la façon suivante :

  • Vous spécifiez l'ID de l'instance inaccessible et lancez le runbook.

  • Le système crée un VPC temporaire en déployant l'EC2Rescue CloudFormation empiler.

  • Le système identifie un sous-réseau pour votre VPC temporaire dans la même zone de disponibilité que votre instance d'origine.

  • Le système lance un programme temporaire, SSM-enabled instance d'assistance.

  • Le système arrête l'instance originale et crée une sauvegarde. Ensuite, il rattache le volume racine original à l'instance d'assistant.

  • Le système utilise l'action Run Command pour exécuter EC2Rescue sur l'instance d'assistant. EC2Rescue identifie et essaye de corriger les problèmes sur le volume racine original attaché. Lorsque vous avez terminé, EC2Rescue rattache le volume racine à l'instance d'origine.

  • Le système redémarre votre instance originale et met fin à l'instance temporaire. Le système met également fin au VPC temporaire et supprime l'EC2Rescue CloudFormation pile créée au début de l'automatisation.

Avant de commencer

Avant d'exécuter l'automatisation suivante, veillez à exécuter les actions suivantes :

  • Copiez l'ID de l'instance de l'instance inaccessible. Spécifiez cet identifiant dans la procédure.

  • Vous pouvez également recueillir l'ID d'un sous-réseau dans la même zone de disponibilité que votre instance inaccessible. L'instance EC2Rescue sera créée dans ce sous-réseau. Si vous ne spécifiez pas de sous-réseau, Automation crée un nouveau VPC temporaire dans votre Compte AWS. Vérifiez que votre Compte AWS dispose d'au moins un VPC. Par défaut, vous pouvez créer cinq VPC par région. Si vous avez déjà créé cinq VPC dans la région, l'automatisation échoue sans apporter les modifications à votre instance. Pour de plus amples informations sur les quotas Amazon VPC, consultez VPC et sous-réseaux dans le Guide de l'utilisateur Amazon VPC.

  • Vous pouvez éventuellement créer et spécifier un Gestion des identités et des accès AWS rôle (IAM) pour Automation. Si vous ne spécifiez pas ce rôle, Automation s'exécute dans le contexte de l'utilisateur qui a exécuté l'automatisation.

Attribution d'autorisations AWSSupport-EC2Rescue pour exécuter des actions sur vos instances

EC2Rescue a besoin d'autorisation pour réaliser une série d'action sur vos instances pendant l'automatisation. Ces actions invoquent l'IAM, Amazon EC2 et CloudFormation services pour tenter de résoudre les problèmes liés à vos instances en toute sécurité. Si vous avez Administrator-level autorisations dans votre Compte AWS and/or VPC, vous pourrez peut-être exécuter l'automatisation sans configurer les autorisations, comme décrit dans cette section. Si vous n'avez pas Administrator-level autorisations, vous ou un administrateur devez configurer les autorisations comme décrit dans Attribution des autorisations en utilisant les politiques IAM.

Attribution des autorisations en utilisant les politiques IAM

Vous pouvez attacher la politique IAM suivante à votre utilisateur, groupe ou rôle IAM en tant que politique en ligne, ou vous pouvez créer une nouvelle politique IAM gérée et la relier à votre utilisateur, groupe ou rôle. Pour plus d'informations au sujet de l'ajout d'une politique en ligne à votre compte utilisateur, groupe ou rôle, consultez la page Utilisation de politiques en ligne. Pour plus d'informations sur la création d'une nouvelle politique gérée, consultez la page Utilisation de politiques gérées.

Note

Joignez le AmazonSSMAutomationRole stratégie gérée à côté de la stratégie suivante, que vous ajoutiez la stratégie suivante en ligne ou en tant que nouvelle stratégie gérée. L'automatisation dépend des autorisations qui AmazonSSMAutomationRole accorde, mais pas la politique suivante, y compris les autorisations d'API Systems Manager, ec2:RunInstances, et le CloudFormation autorisations utilisées pour créer et supprimer la pile temporaire EC2Rescue.

Note

Cette politique suppose que vous spécifiez un profil d'instance existant dans HelperInstanceProfileName paramètre lorsque vous exécutez l'automatisation. Le rôle IAM au sein de ce profil d'instance est une identité distincte de celle à laquelle vous associez la politique suivante. Il doit faire confiance ec2.amazonaws.com et ayez AmazonSSMManagedInstanceCore politique attachée, afin que l'instance d'assistance EC2Rescue puisse s'enregistrer auprès de Systems Manager et recevoir des commandes. Ne pas joindre AmazonSSMAutomationRole à celui-ci, car l'instance d'assistance n'appelle pas ces API. Si vous définissez LogDestination, ce rôle a également besoin s3:ListBucket sur le seau, et s3:PutObject avec s3:AbortMultipartUpload sur le AWSSupport-ExecuteEC2Rescue préfixe à l'intérieur. Si tu pars HelperInstanceProfileName vide, l'automatisation crée un rôle IAM d'assistance et un profil d'instance en votre nom, ce qui nécessite des autorisations pour créer et configurer des ressources IAM que cette politique n'accorde pas.

Politique IAM pour AWSSupport-EC2Rescue

Remplacer account ID, EC2RescueHelperRole, et EC2RescueAutomationRole avec vos propres informations.

JSON
{ "Version":"2012-10-17", "Statement": [ { "Sid": "ReadApprovedHelperProfile", "Effect": "Allow", "Action": "iam:GetInstanceProfile", "Resource": "arn:aws:iam::111122223333:instance-profile/EC2RescueHelperRole" }, { "Sid": "PassHelperRoleToEc2", "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::111122223333:role/EC2RescueHelperRole", "Condition": { "StringEquals": { "iam:PassedToService": "ec2.amazonaws.com" } } }, { "Sid": "PassExecutionRoleToNestedAutomation", "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::111122223333:role/EC2RescueAutomationRole", "Condition": { "StringEquals": { "iam:PassedToService": "ssm.amazonaws.com" } } }, { "Sid": "ReadRescueStackResources", "Effect": "Allow", "Action": "cloudformation:DescribeStackResource", "Resource": "arn:aws:cloudformation:*:111122223333:stack/AWSSupport-EC2Rescue-*/*" }, { "Sid": "MoveRootVolumeAndRebootHelper", "Effect": "Allow", "Action": [ "ec2:AttachVolume", "ec2:DetachVolume", "ec2:ModifyInstanceAttribute", "ec2:RebootInstances" ], "Resource": [ "arn:aws:ec2:*:111122223333:instance/*", "arn:aws:ec2:*:111122223333:volume/*" ] }, { "Sid": "ManageHelperLaunchTemplate", "Effect": "Allow", "Action": [ "ec2:CreateLaunchTemplate", "ec2:DeleteLaunchTemplate" ], "Resource": "arn:aws:ec2:*:111122223333:launch-template/*" }, { "Sid": "ManageTemporaryNetwork", "Effect": "Allow", "Action": [ "ec2:CreateVpc", "ec2:ModifyVpcAttribute", "ec2:DeleteVpc", "ec2:CreateInternetGateway", "ec2:AttachInternetGateway", "ec2:DetachInternetGateway", "ec2:DeleteInternetGateway", "ec2:CreateSubnet", "ec2:ModifySubnetAttribute", "ec2:DeleteSubnet", "ec2:CreateRouteTable", "ec2:CreateRoute", "ec2:DeleteRoute", "ec2:AssociateRouteTable", "ec2:DisassociateRouteTable", "ec2:DeleteRouteTable" ], "Resource": [ "arn:aws:ec2:*:111122223333:vpc/*", "arn:aws:ec2:*:111122223333:subnet/*", "arn:aws:ec2:*:111122223333:internet-gateway/*", "arn:aws:ec2:*:111122223333:route-table/*" ] }, { "Sid": "ReadInstanceAndNetworkState", "Effect": "Allow", "Action": [ "autoscaling:DescribeAutoScalingInstances", "ec2:Describe*" ], "Resource": "*" } ] }

Exécution d'Automation

Important

L'automatisation suivante arrête l'instance inaccessible. L'arrêt de l'instance peut entraîner la perte de données sur des volumes de stockage d'instance attachés (le cas échéant). L'arrêt de l'instance peut aussi causer le changement de l'adresse IP publique, si aucune adresse IP Elastic n'est associée.

Pour exécuter l'automatisation AWSSupport-ExecuteEC2Rescue
  1. Ouvrez le AWS Systems Manager console à https://console.aws.amazon.com/systems-manager/.

  2. Dans le panneau de navigation de gauche, sélectionnez Automation (Automatisation).

  3. Sélectionnez Execute automation (Exécuter l'automatisation).

  4. Dans la section Document d'automatisation, sélectionnez M'appartenant ou appartenant à Amazon dans la liste.

  5. Dans la liste des runbooks, sélectionnez le bouton de la carte pour AWSSupport-ExecuteEC2Rescue, puis sélectionnez Next (Suivant).

  6. Sur la page Exécuter le document d'automatisation, sélectionnez Exécution simple.

  7. Dans la section Détails du document, vérifiez que l'option Version du document est définie sur la version par défaut la plus importante. Par exemple, $DEFAULT ou 3 (par défaut).

  8. Dans la section Paramètres d'entrée, spécifiez les paramètres suivants :

    1. Pour UnreachableInstanceId, spécifiez l'ID de l'instance inaccessible.

    2. (Facultatif) Pour EC2RescueInstanceType, spécifiez un type d'instance pour l'instance EC2Rescue. Le type d'instance par défaut est t2.medium.

    3. Pour AutomationAssumeRole, choisissez l'ARN du rôle IAM auquel vous avez accordé les autorisations décrites dans Attribution des autorisations en utilisant les politiques IAM. Si vous laissez ce champ vide, l'automatisation s'exécute avec les autorisations de votre propre utilisateur ou rôle, qui doivent ensuite inclure ces mêmes autorisations.

    4. Pour HelperInstanceProfileName, entrez le nom du profil d'instance que vous avez préparé pour l'instance d'assistance EC2Rescue.

    5. (Facultatif) Pour LogDestination, spécifiez un compartiment S3 si vous souhaitez collecter des journaux au niveau du système d'exploitation lors du dépannage de votre instance. Les journaux sont chargés automatiquement dans le compartiment spécifié.

    6. Pour SubnetId, spécifiez un sous-réseau dans un VPC existant situé dans la même zone de disponibilité que l'instance inaccessible. Par défaut, Systems Manager crée un VPC, mais vous pouvez spécifier un sous-réseau dans un VPC existant si vous le souhaitez.

      Note

      Si vous ne voyez pas l'option permettant de spécifier un compartiment ou un ID de sous-réseau, vérifiez que vous utilisez la version Default (Par défaut) la plus récente du runbook.

  9. (Facultatif) Dans Balises zone, appliquez une ou plusieurs touches de tag name/value des paires pour aider à identifier l'automatisation, par exemple Key=Purpose,Value=EC2Rescue.

  10. Sélectionnez Execute (Exécuter).

Le runbook crée une AMI de sauvegarde dans le cadre de l'automatisation. Toutes les autres ressources créées par l'automatisation sont automatiquement supprimées, mais cette AMI reste dans votre compte. L'AMI est nommée selon la convention suivante :

AMI de sauvegarde : AWSSupport-EC2Rescue:UnreachableInstanceId

Vous pouvez localiser cette AMI dans la console Amazon EC2 en recherchant l'ID d'exécution d'Automation.