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.

Utilisation des runbooks Systems Manager Automation dans Incident Manager

Vous pouvez utiliser les runbooks d'AWS Systems ManagerAutomation, une fonctionnalité deAWS Systems Manager, pour automatiser les tâches d'application et d'infrastructure courantes dans votre AWS Cloud environnement.

Chaque runbook définit un workflow de runbook, qui est composé des actions que Systems Manager effectue sur vos nœuds gérés ou d'autres types de AWS ressources. Vous pouvez utiliser des runbooks pour automatiser la maintenance, le déploiement et la correction de vos AWS ressources.

Dans Incident Manager, un runbook gère la réponse aux incidents et leur atténuation, et vous spécifiez un runbook à utiliser dans le cadre d'un plan de réponse.

Dans vos plans de réponse, vous pouvez choisir parmi des dizaines de runbooks préconfigurés pour les tâches fréquemment automatisées, ou vous pouvez créer des runbooks personnalisés. Lorsque vous spécifiez un runbook dans la définition d'un plan de réponse, le système peut démarrer automatiquement le runbook lorsqu'un incident commence.

Pour plus d'informations sur l'automatisation de Systems Manager, les runbooks et l'utilisation des runbooks avec Incident Manager, consultez les rubriques suivantes :

Autorisations IAM requises pour démarrer et exécuter les flux de travail du runbook

Incident Manager nécessite des autorisations pour exécuter des runbooks dans le cadre de votre réponse aux incidents. Pour fournir ces autorisations, vous utilisez des rôles AWS Identity and Access Management (IAM), le rôle de service Runbook et l'Automation. AssumeRole

Le rôle de service Runbook est un rôle de service obligatoire. Ce rôle fournit à Incident Manager les autorisations dont il a besoin pour accéder au flux de travail du runbook et le démarrer.

L'automatisation AssumeRole fournit les autorisations nécessaires pour exécuter les commandes individuelles spécifiées dans le runbook.

Pour plus d'informations sur l'automatisationAssumeRole, consultez la section « Configuration d'un accès à un rôle de service (rôle d'acteur) pour les automatisations » dans le Guide de l'AWS Systems Managerutilisateur.

Vous pouvez créer vous-même l'un ou l'autre type de rôle manuellement dans la console IAM.- Vous pouvez également laisser Incident Manager créer l'un ou l'autre pour vous lorsque vous créez ou mettez à jour un plan de réponse.

Autorisations relatives aux rôles dans le service Runbook

Les autorisations relatives aux rôles dans le service Runbook sont fournies par le biais d'une politique similaire à la suivante.

La première instruction permet à Incident Manager de démarrer l'StartAutomationExecutionopération Systems Manager. Cette opération s'exécute ensuite sur les ressources représentées par les trois formats Amazon Resource Name (ARN).

La deuxième instruction permet au rôle de service Runbook d'assumer un rôle dans un autre compte lorsque ce runbook s'exécute sur le compte concerné. Pour plus d'informations, consultez la section Exécution d'automatisations sur plusieurs comptes Régions AWS et dans le Guide de l'AWS Systems Managerutilisateur.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ssm:StartAutomationExecution",
      "Resource": [
        "arn:aws:ssm:*:{{DocumentAccountId}}:automation-definition/{{DocumentName}}:*",
        "arn:aws:ssm:*:{{DocumentAccountId}}:document/{{DocumentName}}:*",
        "arn:aws:ssm:*::automation-definition/{{DocumentName}}:*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": "sts:AssumeRole",
      "Resource": "arn:aws:iam::*:role/AWS-SystemsManager-AutomationExecutionRole",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "ssm.amazonaws.com"
        }
      }
    }
  ]
}

AssumeRoleAutorisations d'automatisation

Lorsque vous créez ou mettez à jour un plan de réponse, vous pouvez choisir parmi plusieurs politiques AWS gérées à associer au plan créé par AssumeRole Incident Manager. Ces politiques fournissent des autorisations pour exécuter un certain nombre d'opérations courantes utilisées dans les scénarios du runbook d'Incident Manager. Vous pouvez choisir une ou plusieurs de ces politiques gérées pour accorder des autorisations à votre AssumeRole politique. Le tableau suivant décrit les politiques que vous pouvez choisir lorsque vous créez et à AssumeRole partir de la console Incident Manager.

Vous pouvez utiliser ces politiques gérées pour accorder des autorisations pour de nombreux scénarios courants de réponse aux incidents. Toutefois, les autorisations requises pour les tâches spécifiques dont vous avez besoin peuvent varier. Dans ces cas, vous devez fournir des autorisations de politique supplémentaires pour votreAssumeRole. Pour plus d'informations, consultez la référence du runbook AWS Systems Manager Automation.

Utilisation des paramètres du runbook

Lorsque vous ajoutez un runbook à un plan de réponse, vous pouvez spécifier les paramètres que le runbook doit utiliser lors de l'exécution. Les plans de réponse prennent en charge les paramètres avec des valeurs statiques et dynamiques. Pour les valeurs statiques, vous saisissez la valeur lorsque vous définissez le paramètre dans le plan de réponse. Pour les valeurs dynamiques, le système détermine la valeur de paramètre correcte en collectant des informations provenant de l'incident. Incident Manager prend en charge les paramètres dynamiques suivants :

À propos des ressources associées

Incident Manager peut renseigner les valeurs des paramètres du runbook avec les ARN des AWS ressources spécifiées dans les CloudWatch alarmes, les EventBridge événements et les incidents créés manuellement. Cette section décrit les différents types de ressources pour lesquels Incident Manager peut capturer des ARN lors du remplissage de ce paramètre.

Alarmes CloudWatch

Lorsqu'un incident est créé à partir CloudWatch d'une action d'alarme, Incident Manager extrait automatiquement les types de ressources suivants à partir des mesures associées. Il renseigne ensuite les paramètres choisis avec les ressources impliquées suivantes :

Règles EventBridge

Lorsque le système crée un incident à partir d'un EventBridge événement, Incident Manager renseigne les paramètres choisis avec la Resources propriété de l'événement. Pour plus d'informations, consultez les EventBridgeévénements Amazon dans le Guide de EventBridge l'utilisateur Amazon.

Incidents créés manuellement

Lorsque vous créez un incident à l'aide de l'action d'StartIncidentAPI, Incident Manager renseigne les paramètres choisis en utilisant les informations de l'appel d'API. Plus précisément, il renseigne les paramètres à l'aide d'éléments du type INVOLVED_RESOURCE transmis dans le relatedItems paramètre.

Définir un runbook

Lorsque vous créez un runbook, vous pouvez suivre les étapes décrites ici ou suivre le guide plus détaillé fourni dans la section Utilisation des runbooks du Guide de l'utilisateur de Systems Manager. Si vous créez un runbook multi-comptes et multirégions, consultez la section Exécution d'automatisations dans plusieurs comptes Régions AWS et dans le Guide de l'utilisateur de Systems Manager.

Pour activer la fonctionnalité multicompte, partagez le runbook de votre compte de gestion avec tous les comptes d'applications qui utilisent le runbook lors d'un incident.

Modèle de runbook d'Incident Manager

Incident Manager fournit le modèle de runbook suivant pour aider votre équipe à commencer à créer des runbooks dans Systems Manager Automation. Vous pouvez utiliser ce modèle tel quel ou le modifier pour inclure des détails spécifiques à votre application et à vos ressources.

AWSIncidents-CriticalIncidentRunbookTemplate

AWSIncidents-CriticalIncidentRunbookTemplateIl s'agit d'un modèle qui fournit le cycle de vie des incidents d'Incident Manager en étapes manuelles. Ces étapes sont suffisamment génériques pour être utilisées dans la plupart des applications, mais suffisamment détaillées pour que les intervenants puissent commencer à résoudre les incidents.