Creating and setting up an App Studio instance for the first time
Sign up for an AWS account
An AWS account is required to set up App Studio. Only one AWS account is required to use App Studio—builders and administrators don't need an AWS account to use App Studio because access is managed with AWS IAM Identity Center.
To create an AWS account
Open https://portal.aws.amazon.com/billing/signup
. Follow the online instructions.
Part of the sign-up procedure involves receiving a phone call and entering a verification code on the phone keypad.
When you sign up for an AWS account, an AWS account root user is created. The root user has access to all AWS services and resources in the account. As a security best practice, assign administrative access to a user, and use only the root user to perform tasks that require root user access.
Create an administrative user for managing AWS resources
When you first create an AWS account, you begin with a default set of credentials with complete access to all AWS resources in your account. This identity is called the AWS account root user. For creating AWS roles and resources to be used with App Studio, we strongly recommend that you do not use the AWS account root user. Instead, we recommend that you create and use an administrative user.
Use the following topics to create an administrative user for managing AWS roles and resources for use with App Studio.
For a single, standalone AWS account, see Create your first IAM user in the IAM User Guide. You can provide any user name, but it must have the
AdministratorAccesspermissions policy.For multiple AWS accounts managed through AWS Organizations, see Set up AWS account access for an IAM Identity Center administrative user in the AWS IAM Identity Center User Guide.
Create an App Studio instance in the AWS Management Console
To use App Studio, you must create an instance from the App Studio landing page in the AWS Management Console. There are two methods that can be used to create an App Studio instance:
Easy create: With this simplified method, you set up only one user to access and use App Studio as part of setting up. You should use this method if you're evaluating App Studio for your organization or team, or if you only plan to use App Studio yourself. You can add more users or groups to App Studio after setup. Note that if you have an organization instance of IAM Identity Center, you can't use this method.
Standard create: With this method, you add users or groups and assign them roles in App Studio as part of setting up. You should use this method if you want to add more than one user to App Studio when setting up.
Note
You can only create one instance of App Studio, across all AWS Regions. If you have an existing instance, you must delete it before creating another one. For more information, see Deleting an App Studio instance.
To create an App Studio instance in the AWS Management Console with easy create
-
Open the App Studio console at https://console.aws.amazon.com/appstudio/
. Navigate to the AWS Region in which you want to create an App Studio instance.
-
Choose Get started.
Choose Easy create and choose Next.
The next steps to set up App Studio are determined by whether or not you have an IAM Identity Center account instance. To find more information about IAM Identity Center instances, including the different types and how to find which type you have, see Manage organization and account instances of IAM Identity Center in the AWS IAM Identity Center User Guide.
-
If you have an account instance of IAM Identity Center:
-
In Account permissions, review the required permissions for enabling App Studio. If your account doesn't have the required permissions, you won't be able to enable App Studio. You must either get the required permissions added to your account, or switch to an account that has them.
In Add a user, search for and select the email address of the user in your IAM Identity Center account instance that will access App Studio. This user will have the Admin role in the App Studio instance. If you do not see the user you want to provide access to App Studio, you may need to add them to your IAM Identity Center instance.
-
-
If you do not have an account instance of IAM Identity Center:
Note
Setting up App Studio automatically creates an IAM Identity Center account instance with the user you configure during the set up process. After the setup is complete, you can add or manage users and groups in the IAM Identity Center console at https://console.aws.amazon.com/singlesignon/
. -
In Account permissions, review the required permissions for enabling App Studio. If your account does not have the required permissions, you will not be able to enable App Studio. You must either get the required permissions added to your account, or switch to an account that has them.
In Add a user, provide an Email address, First name, Last name, and Username for the user accessing App Studio. This user will have the Admin role in the App Studio instance.
-
-
In Create Amazon CodeCatalyst space, provide a name for the CodeCatalyst space that App Studio will use to store source code and other information.
In Service access and roles, review the service roles and service-linked role that are created automatically when you set up App Studio to provide the service with necessary permissions. Choose View permissions to see the exact permissions granted for service roles, or View policy to see the permissions policy attached to the service-linked role.
In Acknowledgement, acknowledge the statements by choosing their checkboxes.
Choose Set up to create your instance.
Note
To add more users or groups to your App Studio instance after setup, you must add them to your IAM Identity Center instance.
