AWS-UpdateEKSCluster - AWS Systems Manager Automation runbook reference

AWS-UpdateEKSCluster

Description

The AWS-UpdateEKSCluster runbook helps you update your Amazon Elastic Kubernetes Service (Amazon EKS) cluster to the Kubernetes version that you want to use.

Run this Automation (console)

Document type

Automation

Owner

Amazon

Platforms

Linux, macOS, Windows

Parameters

  • AutomationAssumeRole

    Type: String

    Description: (Optional) The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that allows Systems Manager Automation to perform the actions on your behalf. If no role is specified, Systems Manager Automation uses the permissions of the user that starts this runbook.

  • ClusterName

    Type: String

    Description: (Required) The name of your Amazon EKS cluster.

  • Version

    Type: String

    Description: (Required) The Kubernetes version that you want to update your cluster to.

Required IAM permissions

The AutomationAssumeRole parameter requires the following actions to use the runbook successfully.

  • eks:DescribeUpdate

  • eks:UpdateClusterVersion

Document Steps

  • aws:executeAwsApi - Updates the Kubernetes version that is used by your Amazon EKS cluster.

  • aws:waitForAwsResourceProperty - Waits for the update status to be Successful.