Help Center

Do you need help with something or spotted a bug? You're at the right place

How to create an AWS role with Stackmate CLI

Creating an AWS IAM role can be a tricky process and applying or updating the…

Written by falexandrou
Last updated 2 months ago

Creating an AWS IAM role can be a tricky process and applying or updating the permissions required is no walk in the park. Stackmate is all about simplicity and that’s why we created this open-source NPM package that will help you do so.

You can find the NPM package here: https://www.npmjs.com/package/stackmate and also, the source here: https://github.com/stackmate-io/stackmate-cli

To create an AWS IAM role which you can use with stackmate, follow these simple instructions on your computer:

  • Run npm install -g stackmate, to install stackmate as a global NPM package
  • Run stackmate role to start the process where it will scan for existing AWS credentials on your home directory. If it finds AWS profiles we can use, it will prompt you to select a profile. Of course, none of the AWS credentials are copied to Stackmate
  • If you have some AWS profiles will get a prompt that looks like this:

If not, or you choose not to use an existing AWS profile, you will get a prompt where you are required to enter your AWS credentials that will create the IAM role for you. Keep in mind, that we’re not storing or copying the account credentials, we just use them to create the IAM role for you. The prompt will look like this:

  • Once the AWS access has been settled, you can name the Role & Policy and the client will create those on your AWS account. Please note, if you provide the name of a role that already exists, the process will only update the permissions for given role.
  • The process is now done and you’ll get prompted whether you want to open the browser in the settings page with the credentials pre-filled, so that you can use them for your project

Alternatively, you can go to your settings page, scroll to Integrations and click the “Add” button on the AWS integration to open the dialog yourself.

The role will then become available on your AWS console with the appropriate permissions required.

Similar Articles
What happens if I cancel my account?

We’re sorry to hear you’re considering of canceling your account. Canceling your account will only…

Why do I need an AWS role?

In order for Stackmate.io to be able to deploy cloud resources on AWS, we need…

Submit a support request
Arrow-up