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 documents d'automatisation de Systems Manager
AWS Systems Manager vous donne la visibilité et le contrôle de votre infrastructure sur AWS. Systems Manager fournit une interface utilisateur unifiée qui vous permet de visualiser les données opérationnelles de plusieurs AWS services et d'automatiser les tâches opérationnelles sur l'ensemble de vos AWS ressources.
Un [document de Systems Manager ](https://docs.aws.amazon.com//systems-manager/latest/userguide/sysman-systems-manager-docs.html)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 que vous utilisez pour effectuer des tâches de maintenance et de déploiement courantes, telles que 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 for Visual Studio Code.
**Topics**
+ [Hypothèses et prérequis](#systems-manager-assumptions)
+ [Autorisations IAM pour les documents d'automatisation de Systems Manager](#systems-manager-permissions)
+ [Création d'un nouveau document Systems Manager Automation](#systems-manager-create)
+ [Ouverture d'un document Systems Manager Automation existant](#systems-manager-open)
+ [Modification d'un document d'automatisation de Systems Manager](#systems-manager-edit)
+ [Publication d'un document d'automatisation de Systems Manager](#systems-manager-publish)
+ [Supprimer un document Systems Manager Automation](#systems-manager-delete)
+ [Exécution d'un document d'automatisation de Systems Manager](#systems-manager-run)
+ [Dépannage des documents d'automatisation de Systems Manager dans Toolkit for VS Code](systems-manager-troubleshoot.md)
## Hypothèses et prérequis
Avant de commencer, assurez-vous que :
+ Vous avez installé Visual Studio Code et la dernière version du AWS Toolkit for Visual Studio Code. Pour de plus amples informations, veuillez consulter [Installation du AWS Toolkit for Visual Studio Code](setup-toolkit.md).
+ Vous connaissez Systems Manager. Pour plus d’informations, consultez le [Guide de l’utilisateur *AWS Systems Manager *](https://docs.aws.amazon.com//systems-manager/latest/userguide/what-is-systems-manager.html).
+ Vous connaissez les cas d'utilisation de Systems Manager Automation. Pour plus d'informations, consultez [Automatisation de Systems Manager AWS](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-automation.html) dans le *Guide de l'utilisateur AWS Systems Manager *.
## Autorisations IAM pour les documents d'automatisation de Systems Manager
Dans le Toolkit for VS Code, vous devez disposer d'un profil d'identification contenant les autorisations Gestion des identités et des accès AWS (IAM) nécessaires pour créer, modifier, publier et supprimer des documents Systems Manager Automation. Le document de politique suivant définit les autorisations IAM nécessaires pouvant être utilisées dans une politique principale :
------
#### [ JSON ]
****
```
{
"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 des informations sur la création de politiques IAM, consultez [Création de politiques](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_create.html) dans le *Guide de l'utilisateur IAM*. Pour plus d'informations sur la configuration de votre profil d'identification, consultez[AWS Informations d'identification IAM](setup-credentials.md).
## Création d'un nouveau document Systems Manager Automation
Vous pouvez créer un nouveau document d'automatisation dans `JSON` ou à `YAML` l'aide de Visual Studio Code. Lorsque vous créez un nouveau document d'automatisation, il est présenté dans un fichier sans titre. Vous pouvez nommer votre fichier et l'enregistrer dans VS Code, mais le nom du fichier n'est pas visible pour AWS.
**Pour créer un nouveau document d'automatisation**
1. Ouvrez VS Code.
1. Dans le menu **Affichage**, choisissez **Palette de commandes** pour ouvrir la palette de commandes.
1. Dans la palette de commandes, entrez **AWS Toolkit Create a new Systems Manager Document Locally**.
1. Choisissez l'un des modèles de démarrage pour un exemple Hello World.
1. Choisissez `JSON` ou `YAML`.
Un nouveau document d'automatisation est créé.
**Note**
Votre nouveau document d'automatisation dans VS Code n'apparaît pas automatiquement dans AWS. Vous devez le publier sur AWS avant de pouvoir l'exécuter.
## Ouverture d'un document Systems Manager Automation existant
Vous pouvez utiliser l' AWS explorateur pour rechercher les documents existants de Systems Manager Automation. Lorsque vous ouvrez un document d'automatisation existant, il apparaît sous forme de fichier sans titre dans VS Code.
**Pour ouvrir votre document d'automatisation**
1. Ouvrez VS Code.
1. Dans le menu de navigation de gauche, choisissez **AWS**d'ouvrir l' AWS explorateur.
1. Dans l' AWS Explorateur, pour **Systems Manager**, choisissez l'icône de téléchargement sur le document que vous souhaitez ouvrir, puis choisissez la version du document. Le fichier s'ouvre au format correspondant à cette version. Sinon, choisissez **Télécharger au format JSON** ou **Télécharger au format YAML.**
**Note**
L'enregistrement local d'un document d'automatisation en tant que fichier dans VS Code ne le fait pas apparaître dans AWS. Il doit être publié AWS avant d'être exécuté.
## Modification d'un document d'automatisation de Systems Manager
Si vous possédez des documents Automation, ils apparaissent dans la catégorie **Owned by Me** des documents Systems Manager de l' AWS explorateur. Vous pouvez posséder des documents d'automatisation qui existent déjà dans AWS, et vous pouvez posséder des documents nouveaux ou mis à jour sur lesquels vous avez déjà publié AWS depuis VS Code.
Lorsque vous ouvrez un document d'automatisation pour le modifier dans VS Code, vous pouvez en faire plus que dans le AWS Management Console. Par exemple :
+ Il existe une validation du schéma sur `JSON` les deux `YAML` formats.
+ Des extraits de code sont disponibles dans l'éditeur de documents pour vous permettre de créer n'importe quel type d'étape d'automatisation.
+ Il existe un support de saisie automatique pour diverses options dans `JSON` et`YAML`.
### Utilisation des versions
Les documents Systems Manager Automation utilisent des versions pour la gestion des modifications. Vous pouvez choisir la version par défaut pour un document d'automatisation dans VS Code.
**Pour définir une version par défaut**
+ Dans l' AWS explorateur, accédez au document dont vous souhaitez définir la version par défaut, ouvrez le menu contextuel (clic droit) du document, puis choisissez **Définir la version par défaut**.
**Note**
Si le document choisi ne comporte qu'une version, vous ne pourrez pas modifier la version par défaut.
## Publication d'un document d'automatisation de Systems Manager
Après avoir modifié votre document d'automatisation dans VS Code, vous pouvez le publier sur AWS.
**Pour publier votre document d'automatisation**
1. Ouvrez le document d'automatisation que vous souhaitez publier en suivant la procédure décrite dans[Ouverture d'un document Systems Manager Automation existant](#systems-manager-open).
1. Apportez les modifications que vous souhaitez publier. Pour de plus amples informations, veuillez consulter [Modification d'un document d'automatisation de Systems Manager](#systems-manager-edit).
1. Dans le coin supérieur droit du fichier ouvert, cliquez sur l'icône de téléchargement.
1. Dans la boîte de dialogue du flux de publication, choisissez la AWS région dans laquelle vous souhaitez publier le document d'automatisation.
1. Si vous publiez un nouveau document, choisissez **Création rapide**. Sinon, choisissez **Quick Update** pour mettre à jour un document d'automatisation existant dans cette AWS région.
1. Entrez le nom de ce document d'automatisation.
Lorsque vous publiez une mise à jour d'un document Automation existant vers AWS, une nouvelle version est ajoutée au document.
## Supprimer un document Systems Manager Automation
Vous pouvez supprimer des documents d'automatisation dans VS Code. La suppression d'un document d'automatisation supprime le document et toutes ses versions.
**Important**
La suppression est une action destructrice qui ne peut être annulée.
La suppression d'un document d'automatisation déjà exécuté ne supprime pas les AWS ressources créées ou modifiées lors de son démarrage.
**Pour supprimer votre document d'automatisation**
1. Ouvrez VS Code.
1. Dans le menu de navigation de gauche, choisissez **AWS**d'ouvrir l' AWS explorateur.
1. Dans l' AWS Explorateur, pour **Systems Manager**, ouvrez le menu contextuel (clic droit) du document que vous souhaitez supprimer, puis choisissez **Supprimer le document**.
## Exécution d'un document d'automatisation de Systems Manager
Une fois que votre document Automation est publié sur AWS, vous pouvez l'exécuter pour effectuer des tâches en votre nom dans votre AWS compte. Pour exécuter votre document d'automatisation, vous utilisez le AWS Management Console, le Systems Manager APIs AWS CLI, ou le Outils AWS pour PowerShell. Pour obtenir des instructions sur la façon d'exécuter un document d'automatisation, voir [Exécution d'une automatisation simple](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) dans le *Guide de AWS Systems Manager l'utilisateur*.
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 [références du AWS SDK](https://aws.amazon.com/getting-started/tools-sdks/).
**Note**
L'exécution d'un document d'automatisation peut créer de nouvelles ressources AWS et entraîner des coûts de facturation. Nous vous recommandons vivement de comprendre ce que votre document d'automatisation créera dans votre compte avant de le démarrer.