This repository contains code that makes it easy for AWS customers to upgrade to the latest EBS gp3 volumes. By migrating to gp3, customer can save up to 20% lower price-point per GB than existing gp2 volumes.
The easiest way to get started is to deploy this app from the Serverless Application Repository. Once deployed, check the CloudFormation console to find the list of resources that have been deployed to your account. At a minimum you will find a Lambda function, DynamoDB table, SNS Topic, IAM role and IAM policy created. Do not invoke the Lambda function until you've read this entire README.
As part of deploying this stack, you will need to provide a valid email address that will be used to send the results summary of the upgrade from gp2 to gp3. You will receive a confirmation email from AWS Notifications (no-reply@sns.amazonaws.com) once the stack has been deployed. You will need to click the link in the email to confirm your email subscription. You will not be able to receive the output results from the Lambda until you confirm your email subscription.
IMPORTANT: Please note that upon execution, this Lambda powered utility by default will upgrade ALL gp2 EBS volumes in your account to gp3. If you need to back out, there is no easy button in this version of the application. If you need to revert back from gp3 to gp2 this will have to be done manually. You can modify your volume(s) using the Console/CLI/SDK. In some cases, the modify volume operation may fail and you may need to wait for 6 hours before you can modify your volume(s) back to gp2. For more details please see the limitations here.
There will be no changes made to any of your other EBS volume types like io1, io2, sc1, st1, etc. If you have any gp2 EBS volumes that you don't want upgraded, you will need to tag each EBS volume with the key upgrade_to_gp3 and set the value to no or false. This will make the Lambda code skip those volumes and they will be untouched.
You will need to execute your Lambda function at least two times. You can invoke the Lambda function by clicking the invoke button from the AWS console or by directly calling the Lambda invoke API. The first time you invoke the Lambda, it will go off and upgrade all gp2 volumes that do not have the tag upgrade_to_gp3 set to no or false.
Depending on how many gp2 volumes are present in your AWS account and target region, the Lambda may take anywhere from a few seconds to a couple of minutes to complete. Please note that even though the Lambda function may complete in a couple of minutes, depending on how large your gp2 volumes are, the upgrade will be running in the background and may take a couple of hours to complete. There is no limit to the number of times you can invoke your Lambda function. Please wait at least 60 seconds before each Lambda function invocation. As mentioned earlier, the first execution will kick off the upgrade from gp2 to gp3. The subsequent runs after the first run will do a status check on the state of your gp2/gp3 volumes and will send out an email (via SNS) with a summary of the results.
The easiest way to deploy this stack is from the AWS Serverless Application Repository.
Alternatively, you can also use the SAM CLI along with the provided template.yaml file to deploy at scale across multiple AWS accounts and in different AWS regions. You can use the below example syntax to integrate your deployment into your CI/CD process and deploy this utility at scale in your enterprise environment.
sam deploy --region <AWS region name> --template-file </path/to/template.yaml> --stack-name <your stack name> --capabilities CAPABILITY_IAM --s3-bucket <your S3 bucket name> --parameter-overrides "TargetEmail=name@example.com"Below is a high level set of steps you will need to follow to deploy at scale:
- Create or identify an existing S3 bucket in each AWS region you will be deploying to. The S3 bucket is required to hold the Lambda code and the CloudFormation template.
- Clone this repository to your local development environment
- Make necessary updates to the
template.yamlfile. In the AWS::Lambda::Function section, put in the appropriate values for S3Bucket and S3Key. The S3Key will be the name of the zip file you will be creating in the next step - Create a zip file with the contents of this repository which will become your Lambda deployment package.
- Upload the zip file to your S3 bucket
- Execute the sam deploy command with the appropriate parameters.
We are actively iterating on this program to add more features and functionality. We'd love to get your input and hear from you. Please create any GitHub issues for additional features you'd like to see.
This library is licensed under the MIT-0 License. See the LICENSE file.