View a markdown version of this page

AWS-PatchAsgInstance - AWS Systems Manager Référence du manuel d'automatisation

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.

AWS-PatchAsgInstance

Description

Appliquez des correctifs aux instances Amazon Elastic Compute Cloud (Amazon EC2) dans un groupe Auto Scaling.

Exécuter cette automatisation (console)

Important

Ce runbook applique une AutoPatchInstanceInASG balise à l'instance cible lors de l'exécution. Cette balise empêche le runbook de s'exécuter deux fois simultanément sur la même instance. Il ne s'agit pas d'un indicateur de conformité des correctifs. Si l'étape d'application des correctifs échoue, la valeur de la balise peut toujours être définie sur Completed même si l'état d'exécution du runbook indique l'état d'exécution. Failed

Pour vérifier la conformité des correctifs sur l'instance, utilisez DescribeInstancePatchStatesou à la ListComplianceItemsplace.

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

LinuxmacOS, Windows

Paramètres

  • AutomationAssumeRole

    Type : Chaîne

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.

  • InstanceId

    Type : Chaîne

    Description : (Obligatoire) ID de l'instance à corriger. Ne spécifiez pas d'ID d'instance configuré pour s'exécuter pendant une fenêtre de maintenance.

  • LambdaRoleArn

    Type : Chaîne

    Description : (Facultatif) L'ARN du rôle qui permet au Lambda créé par Automation d'effectuer les actions en votre nom. S'il n'est pas spécifié, un rôle transitoire sera créé pour exécuter la fonction Lambda.

  • WaitForInstance

    Type : Chaîne

    Par défaut : PT2 M

    Description : (Facultatif) Durée pendant laquelle l'automatisation doit être mise en veille pour permettre à l'instance de revenir en service.

  • WaitForReboot

    Type : Chaîne

    Par défaut : PT5 M

    Description : (Facultatif) Durée pendant laquelle l'automatisation doit être mise en veille pour permettre à une instance corrigée de redémarrer.

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:GetCommandInvocation

  • ssm:GetParameter

  • ssm:SendCommand

  • cloudformation:CreateStack

  • cloudformation:DeleteStack

  • cloudformation:DescribeStacks

  • ec2:CreateTags

  • ec2:DescribeInstances

  • ec2:RunInstances

  • iam:AttachRolePolicy

  • iam:CreateRole

  • iam:DeleteRole

  • iam:DeleteRolePolicy

  • iam:DetachRolePolicy

  • iam:GetRole

  • iam:PassRole

  • iam:PutRolePolicy

  • lambda:CreateFunction

  • lambda:DeleteFunction

  • lambda:GetFunction

  • lambda:InvokeFunction