Uso de manuales de procedimientos - AWS Systems Manager

Uso de manuales de procedimientos

nota

Los documentos de Automation ahora se conocen como manuales de procedimientos.

Un manual de procedimientos de Automation define las acciones que Systems Manager realiza en las instancias administradas y en otros recursos de AWS cuando se ejecuta una automatización. Automation es una capacidad de AWS Systems Manager. Un manual de procedimientos contiene uno o más pasos que se ejecutan en orden secuencial. Cada paso se construye en torno a una sola acción. La salida de un paso se puede utilizar como entrada en un paso posterior.

El proceso de ejecución de estas acciones y sus pasos se denomina automatización.

Los tipos de acción admitidos en los manuales de procedimientos le permiten automatizar una amplia variedad de operaciones en su entorno de AWS. Por ejemplo, con el tipo de acción executeScript, puede insertar un script de Python o PowerShell directamente en el manual de procedimientos. (Al crear un manual de procedimientos personalizado, puede agregar el script insertado o adjuntarlo desde un bucket de S3 o desde el equipo local). Puede automatizar la administración de sus recursos de AWS CloudFormation mediante el uso de los tipos de acción deleteStack y createStack. Además, mediante el tipo de acción executeAwsApi, un paso puede ejecutar cualquier operación de la API en cualquier servicio de AWS, incluida la creación o la eliminación de recursos de AWS, el inicio de otros procesos, la creación de notificaciones y muchas más operaciones.

Para obtener una lista de los 20 tipos de acción admitidos para Automation, consulte Referencia de acciones de Systems Manager Automation.

Automation AWS Systems Manager proporciona varios manuales de procedimientos con pasos predefinidos que se pueden utilizar para realizar tareas comunes, como reiniciar una o más instancias de Amazon Elastic Compute Cloud (Amazon EC2), o crear una Amazon Machine Image (AMI). También puede crear sus propios manuales de procedimientos y compartirlos con otras Cuentas de AWS, o volverlos públicos para todos los usuarios de Automation.

Los manuales de procedimientos se escriben con JavaScript Object Notation (JSON) o YAML. Sin embargo, con el Generador de documentos en la consola de Systems Manager Automation, puede crear un manual de procedimientos sin tener que utilizar YAML o JSON nativo.

importante

Si ejecuta un flujo de trabajo de automatización que invoca otros servicios mediante un rol de servicio de AWS Identity and Access Management (IAM), tenga en cuenta que el rol de servicio debe configurarse con el permiso necesario para invocar dichos servicios. Este requisito se aplica a todos los manuales de procedimientos de Automation de AWS (manuales de AWS-*), como los manuales de procedimientos AWS-ConfigureS3BucketLogging, AWS-CreateDynamoDBBackup y AWS-RestartEC2Instance, por nombrar algunos. Este requisito también se aplica a cualquier manual de procedimientos de Automation personalizado que cree para invocar otros servicios de AWS mediante acciones que llaman a otros servicios. Por ejemplo, si utiliza las acciones aws:executeAwsApi, aws:createStack o aws:copyImage, configure el rol de servicio con el permiso necesario para invocar dichos servicios. Puede conceder permisos a otros servicios de AWS mediante la incorporación de una política insertada de IAM al rol. Para obtener más información, consulte (Opcional) Agregar una política insertada de Automation para invocar otros servicios de AWS .

Para obtener información acerca de las acciones que puede especificar en un manual de procedimientos, consulte Referencia de acciones de Systems Manager Automation.

Para obtener información acerca de los manuales de procedimientos administrados por AWS que ejecutan scripts, consulte Manuales de procedimientos administrados por AWS que ejecutan scripts.

Para obtener información acerca del uso de AWS Toolkit for Visual Studio Code para crear manuales de procedimientos, consulte Uso de documentos de Systems Manager Automation en la Guía del usuario de AWS Toolkit for Visual Studio Code.

Para obtener información acerca del uso del Generador de documentos para crear un manual de procedimientos personalizado, consulte Creación de manuales de procedimientos con el Generador de documentos.

Para obtener información acerca de la creación de manuales de procedimientos personalizados que ejecutan scripts, consulte los temas siguientes: