AWS Toolkit for Microsoft Azure DevOps User Guide AWS Toolkit for Microsoft Azure DevOps: User Guide Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. AWS Toolkit for Microsoft Azure DevOps User Guide Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon. AWS Toolkit for Microsoft Azure DevOps User Guide Table of Contents Introduction ...................................................................................................................................... 1 What's in This Guide ................................................................................................................... 2 Setting up ......................................................................................................................................... 3 Sign up for AWS ........................................................................................................................ 3 Create an IAM user ..................................................................................................................... 3 Getting started .................................................................................................................................. 5 Set up an Azure DevOps account ................................................................................................. 5 Install the AWS Toolkit for Azure DevOps extension ....................................................................... 5 Establish AWS credentials for the AWS Toolkit for Azure DevOps ...................................................... 5 Supply task credentials ............................................................................................................... 5 Supply task credentials using a service connection ................................................................. 6 Supply credentials through named variables in your build ....................................................... 6 Supply standard AWS environment variables in the build agent process ..................................... 7 Supply credentials with Amazon EC2 build agents .................................................................. 7 Using the tools .................................................................................................................................. 8 Archiving build artifacts to AWS .................................................................................................. 8 Prerequisites ...................................................................................................................... 8 Archiving build artifacts with the AWS S3 Upload task ............................................................ 8 Deploying an ASP.NET web app to AWS ...................................................................................... 14 Prerequisites ...................................................................................................................... 8 Deploying an ASP.NET application using the AWS Elastic Beanstalk Deploy Application task ........ 14 Task reference .................................................................................................................................. 21 AWS CLI .................................................................................................................................. 22 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 AWS Tools for Windows PowerShell Script ................................................................................... 23 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 AWS Shell Script ...................................................................................................................... 25 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 AWS CloudFormation Create/Update Stack .................................................................................. 27 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 AWS CloudFormation Delete Stack ............................................................................................. 33 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 AWS CloudFormation Execute Change Set ................................................................................... 34 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 AWS CodeDeploy Application Deployment ................................................................................... 36 Synopsis .......................................................................................................................... 22 iii AWS Toolkit for Microsoft Azure DevOps User Guide Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 Amazon ECR Push .................................................................................................................... 39 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................. 23 AWS Elastic Beanstalk Create Version ......................................................................................... 41 Synopsis .......................................................................................................................... 22 Description ...................................................................................................................... 22 Parameters ...................................................................................................................... 22 Task Permissions .............................................................................................................