8min

Setup Segmind cluster on AWS

To setup Segmind cluster on your AWS account, you first need to create an IAM user to give Segmind programatic access to create and manage the cluster. It is detailed out step by step below.

First time setup

1. Create an IAM role.

Navigate to IAM Management Console. Click "Add User". Create a user with name segmind. Enable only "Access key - Programmatic access". Click "Next: Permissions" to continue.

New AWS IAM user creation screen
New AWS IAM user creation screen

2. Create two policy JSONs

On "Add user" page, select "Attach existing policies directly" and click on "Create policy" under it.

Adding a new policy
Adding a new policy
Adding policy JSON
Adding policy JSON

Cluster create (and update) policy

This policy gives segmind access to create new resources on your behalf. All the resources are tagged, so they can be accessed and managed via another policy (runtime policy). You can name this policy "segmind-create".

JS
|

Runtime policy

This policy restrics the access to resources created by Segmind. That is more restrictive and minimizes changes because of unintended actions. You can name this policy "segmind-runtime".

JS
|

Make sure you remove/detach the "create" policy once the setup is done. This minimizes changes because of unintended actions and keeps your account safe.

3. Use the access and secret key to create the cluster

Copy-paste the access and secret key and choose the right configuration for your team to create the cluster and other resources.

Segmind cluster creation
Segmind cluster creation

Your cluster should be created within 15-20 minutes. You can check the status of the creation on the clusters tab. The status will change to "Available" once it is ready for use. If the creation fails, the status changes to "failed". There might be multiple reasons why creation might fail, including service quota issues and other rate limits. Please contact us if your cluster creation fails to know more about the reason.

Updating a cluster

To update the cluster, ie. add/remove node groups, change min/max nodes, etc, please attach the "segmind-create" JSON policy via AWS console and hit on update button from Segmind's cluster page to initiate an update.



Updated 03 Apr 2022
Did this page help?
Yes
No