Provisioning on AWS
Quick Installation
Porter provisions infrastructure in your own AWS account through the AssumeRole
operation.
Simply put, Porter can assume the role that you create in your own AWS account as long as you declare that you trust Porter to do so.
This eliminates the need to rely on static AWS credentials and makes it easier to revoke access for security purposes.
- Once you create and select AWS as your cloud provider, you will be prompted to provide your AWS Account ID. You can find your Account ID at the top right corner of your AWS console. Input your Account ID and click on Grant Permissions.
- You will be directed to your AWS console to create a CloudFormation stack. This stack will create the role Porter will assume to manage your infrastructure. Scroll to the bottom of the screen. Check the “I acknowledge…” box and click on Create Stack. It may take a few minutes for the role to be fully created.
- After creating the role, navigate back to the Porter dashboard and click Continue. You will be prompted to select the AWS region that you want to provision your infrastructure in. Porter supports all AWS regions.
- Once you click Provision, Porter will start spinning up the requisite infrastructure in your account. This may take up to 30 minutes.
Once you click Provision Resources, Porter will install all the requisite resources in your AWS account using the IAM credentials you have created. This may take up to 30 minutes.
Deleting Provisioned Resources
To delete resources that have been provisioned by Porter, click on the Infrastructure tab on the sidebar of the dashboard. There you can find the Delete Cluster button.
Once the cluster has been deleted, navigate to CloudFormation Stacks in your AWS console to delete the role that was created during initial provisioning. This will revoke Porter’s access to your account.
Select the stack named PorterRole
and click Delete.
For a guide on how to delete the dangling resources, see Deleting Dangling Resources.