Creating an environment

Use the following instructions to create an environment that you can later associate with a workflow action.

Before you begin

You need the following:

• A CodeCatalyst space. For more information, see Set up and sign in to CodeCatalyst.

• A CodeCatalyst project. For more information, see Creating a project with a blueprint.

• An AWS account connection that includes the IAM roles your workflow action will need to access AWS. You can use a maximum of one account connection per environment. For more information, see Allowing access to AWS resources with connected AWS accounts.

  Note

  You can create an environment without an account connection; however, you will need to come back and add the connection later.

To create an environment

1. Open the CodeCatalyst console at https://codecatalyst.aws/.

2. Choose your project.

3. In the navigation pane, choose CI/CD, and then choose Environments.

4. In Environment name, enter a name, such as Production or Staging.

5. In Environment type, select one of the following:

   • Non-production – An environment where you can test your application to make sure it's working as intended before moving it into production.

   • Production – A 'live' environment that is publicly-available and hosts your finalized application.

     If you choose Production, a Production badge appears in the UI next to any actions that the environment is associated with. The badge helps you quickly see which actions are deploying to production. Other than the appearance of the badge, there are no differences between production and non-production environments.

6. (Optional) In Description, enter a description such as Production environment for the hello-world app.

7. In AWS account connection - optional, choose the AWS account connection you want to associate with this environment. Make sure the account connection includes the IAM role that you want to associate with the environment. For more information about creating this connection, see Allowing access to AWS resources with connected AWS accounts.

8. In Default IAM role, choose the IAM role you want to associate with this environment. Workflow actions that are assigned this environment will inherit this IAM role, and will be able to use it to connect to services and resources in your AWS account. If you need to assign this environment to multiple actions, and those actions need an IAM role that is different from the default one specified here, then you can specify a different role on the action's Configuration tab, using the Switch role option. For more information, see Assigning a different IAM role to an action.

9. (Optional) In VPC connection, choose a VPC connection you want to associate with this environment. For more information about creating this VPC connection, see Managing Amazon Virtual Private Clouds in the CodeCatalyst Administrator Guide.

10. Choose Create environment. CodeCatalyst creates an empty environment.

Next steps

• Now that you have created an environment, you are ready to associate it with a workflow action. For more information, see Associating an environment with a workflow action.