AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS-UpdateLinuxAmi

描述

使用 Linux 分发包和 Amazon 软件更新 Amazon 系统映像 (AMI)。

文档类型

Automation

所有者

Amazon

平台

Windows、Linux

参数

  • AutomationAssumeRole

    类型:字符串

    默认值:arn:aws:iam::{{global:ACCOUNT_ID}}:role/AutomationServiceRole

    说明:(必需)允许 Automation 代表您执行操作的角色的 ARN。

  • ExcludePackages

    类型:字符串

    默认值:无

    说明:(可选)在所有情况下从更新中排除的程序包的名称。默认值 ("none") 不排除任何程序包。

  • IamInstanceProfileName

    类型:字符串

    默认值:ManagedInstanceProfile

    说明:(必需)允许 Systems Manager 管理实例的实例配置文件。

  • IncludePackages

    类型:字符串

    默认值:all

    说明:(可选)仅更新这些指定的程序包。默认值 ("all") 将应用所有可用的更新。

  • InstanceType

    类型:字符串

    默认值:t2.micro

    说明:(可选)启动作为工作区主机的实例的类型。实例类型因区域而异。

  • PostUpdateScript

    类型:字符串

    默认值:无

    说明:(可选)在应用程序包更新后要运行的脚本的 URL。默认值 ("none") 不运行脚本。

  • PreUpdateScript

    类型:字符串

    默认值:无

    说明:(可选)在更新前应用要运行的脚本的 URL。默认值 ("none") 不运行脚本。

  • SourceAmiId

    类型:字符串

    说明:(必需)源 Amazon 系统映像 ID。

  • TargetAmiName

    类型:字符串

    默认值:UpdateLinuxAmi_from_{{SourceAmiId}}_on_{{global:DATE_TIME}}

    说明:(可选)将创建的新 AMI 的名称。默认为系统生成的字符串,其中包括源 AMI ID 以及创建时间和日期。

示例

启动 Automation

aws ssm start-automation-execution --document-name AWS-UpdateLinuxAmi --parameters parameters

检索执行输出

aws ssm get-automation-execution --automation-execution-id EXECUTIONID --output text --query 'AutomationExecution.Output'

文档步骤

aws:runInstances

aws:runCommand

aws:runCommand

aws:changeInstanceState

aws:createImage

aws:changeInstanceState

输出

createImage.ImageId