AWS Cloud9 n'est plus disponible pour les nouveaux clients. Les clients existants de AWS Cloud9 peuvent continuer à utiliser le service normalement. En savoir plus »

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.

Travaillez avec les documents d'automatisation de Systems Manager

Avec AWS Systems Manager, vous avez la visibilité et le contrôle de votre infrastructure sur AWS. Systems Manager fournit une interface utilisateur unifiée que vous pouvez utiliser pour visualiser les données opérationnelles de plusieurs sources services AWS et automatiser les tâches opérationnelles sur l'ensemble de vos AWS ressources.

Un document de Systems Manager définit les actions que Systems Manager effectue sur vos instances gérées. Un document d'automatisation est un type de document Systems Manager permettant d'effectuer des tâches de maintenance et de déploiement courantes. Cela inclut la création ou la mise à jour d'une Amazon Machine Image (AMI). Cette rubrique explique comment créer, modifier, publier et supprimer des documents d'automatisation avec AWS Toolkit.

Hypothèses et prérequis

Avant de commencer, assurez-vous que vous remplissez les conditions suivantes :

IAMautorisations pour les documents Systems Manager Automation

Pour créer, modifier, publier et supprimer des documents d'automatisation de Systems Manager, vous devez disposer d'un profil d'identification contenant les autorisations nécessaires AWS Identity and Access Management (IAM). Le document de politique suivant définit les IAM autorisations nécessaires qui peuvent être utilisées dans une politique principale.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:ListDocuments",
                "ssm:ListDocumentVersions",
                "ssm:DescribeDocument",
                "ssm:GetDocument",
                "ssm:CreateDocument",
                "ssm:UpdateDocument",
                "ssm:UpdateDocumentDefaultVersion",
                "ssm:DeleteDocument"
            ],
            "Resource": "*"
        }
    ]
}

Pour plus d'informations sur la mise à jour d'une IAM politique, voir Création de IAM politiques dans le Guide de IAM l'utilisateur.

Création d'un nouveau document d'automatisation de Systems Manager

Vous pouvez créer un document d'automatisation dans JSON ou YAML en utilisant la boîte à outils AWS . Lorsque vous créez un document d'automatisation, il est présenté dans un fichier sans titre. Vous pouvez nommer votre fichier et l'enregistrer. Toutefois, le fichier n'est chargé AWS que lorsque vous le publiez.

Publication d'un document d'automatisation de Systems Manager

Après avoir créé ou modifié votre document d'automatisation dans AWS Toolkit, vous pouvez le publier dans AWS.

Modification d'un document d'automatisation existant de Systems Manager

Vous pouvez utiliser l' AWS Explorateur pour rechercher les documents d'automatisation de Systems Manager existants. Lorsque vous ouvrez un document existant, il apparaît sous forme de fichier sans titre dans un AWS Cloud9 éditeur. Il existe trois types de documents d'automatisation que vous téléchargez :

Les seuls types de documents que vous pouvez mettre à jour AWS sont ceux qui m'appartiennent. Vous pouvez également télécharger des documents d'automatisation qui sont partagés ou détenus par Amazon, et les modifier dans AWS Cloud9. Toutefois, lorsque vous publiez sur AWS, vous devez soit créer un nouveau document, soit mettre à jour un document existant dont vous êtes le propriétaire. Vous ne pouvez pas créer de nouvelles versions de documents qui ont un autre propriétaire ou qui appartiennent à Amazon.

Pour de plus amples informations, veuillez consulter Documents AWS Systems Manager dans le Guide de l'utilisateur AWS Systems Manager .

Une fois les modifications terminées, vous pouvez utiliser la commande AWS: Publier un nouveau document de Systems Manager pour créer un nouveau document dans le AWS Cloud ou mettre à jour un document existant dont vous êtes propriétaire.

Utilisation des versions

Les documents d'automatisation de Systems Manager utilisent les versions pour la gestion des changements. Avec AWS Toolkit, vous pouvez définir la version par défaut du document, qui est la version utilisée lorsque vous exécutez le document.

Suppression d'un document d'automatisation de Systems Manager

Vous pouvez supprimer les documents d'automatisation que vous possédez dans AWS Toolkit. La suppression d'un document d'automatisation supprime le document et toutes ses versions.

Exécution d'un document d'automatisation de Systems Manager

Une fois votre document d'automatisation publié sur AWS, vous pouvez l'exécuter pour effectuer des tâches en votre nom dans votre Compte AWS. Pour exécuter votre document d'automatisation, vous utilisez le AWS Management Console, le Systems Manager APIs AWS CLI, ou le AWS Tools for PowerShell. Pour plus d'informations sur la façon d'exécuter un document d'automatisation, consultez Exécution d'une automatisation simple dans le Guide de l'utilisateur AWS Systems Manager .

Sinon, si vous souhaitez utiliser l'un des outils AWS SDKs avec le Systems Manager APIs pour exécuter votre document d'automatisation, consultez les AWS SDKréférences.