Associating an environment with a
workflow action
When you associate an environment with a supported workflow action, the environment's AWS account, default IAM role, and
optional Amazon VPC become assigned to the action. The action can then connect and deploy to the
AWS account using the IAM role, and also connect to the optional Amazon VPC.
Use the following instructions to associate an environment with an action.
Step 1: Associate the
environment with a workflow action
Use the following procedure to associate an environment with a workflow action.
- Visual
-
To associate an
environment with a workflow action using the visual editorOpen the CodeCatalyst console at https://codecatalyst.aws/.
-
Choose your project.
-
In the navigation pane, choose CI/CD, and then choose Workflows.
-
Choose the name of your workflow. You can filter by the source repository or
branch name where the workflow is defined, or filter by workflow name.
-
Choose Edit.
-
Choose Visual.
-
In the workflow diagram, choose an action that is supported with environments.
For more information, see Which actions support having their
deployment information displayed in CodeCatalyst?.
-
Choose the Configuration tab, and specify information in
the Environment field, as follows.
Environment
Specify the CodeCatalyst environment to use with the action. The action connects to
the AWS account and optional Amazon VPC specified in the chosen environment. The action uses the
default IAM role specified in the environment to connect to the AWS account, and uses the
IAM role specified in the Amazon VPC connection to
connect to the Amazon VPC.
For more information about environments, see Deploying into AWS accounts and VPCs with CodeCatalyst
environments and Creating an environment.
-
(Optional) Change the IAM role associated with the action. You might want to
change the role if it contains the wrong set of permissions for the action.
To change the role:
-
In the What's in my-environment
? box, and choose the vertical ellipsis icon (
).
-
Choose one of the following:
-
Switch role. Choose this option to change the IAM
role used by this action, and only this action. Other actions continue to
use the default IAM role specified in their associated environment. For
more information, see Assigning a different IAM role to an
action.
-
Edit environment. Choose this option to change the
default IAM role listed in your environment. When you choose this
option, your action—and any other action associated with the same
environment—begins using the new default IAM role.
Use caution when updating the default IAM role. Changing the role
might lead to action failures if the permissions in the role are not
sufficient for all actions that share the environment.
-
(Optional) Choose Validate to validate the workflow's
YAML code before committing.
-
Choose Commit, enter a commit message, and choose
Commit again.
- YAML
-
To associate an environment with a workflow action using the YAML
editor
Open the CodeCatalyst console at https://codecatalyst.aws/.
-
Choose your project.
-
In the navigation pane, choose CI/CD, and then choose Workflows.
-
Choose the name of your workflow. You can filter by the source repository or
branch name where the workflow is defined, or filter by workflow name.
-
Choose Edit.
-
Choose YAML.
-
In the workflow action that you want to associate with an environment, add
code similar to the following:
action-name
:
Environment:
Name: environment-name
For more information, see the Action types topic. This topic has links into the
documentation for each action, including its YAML reference.
-
(Optional) If you want the action to use a different role from the default
IAM role that's listed in the environment, add a Connections:
section that includes the role you want to use. For more information, see Assigning a different IAM role to an
action.
-
(Optional) Choose Validate to validate the workflow's
YAML code before committing.
-
Choose Commit, enter a commit message, and choose
Commit again.
Step 2: Add
deployment information to CodeCatalyst
After associating an environment with a workflow action, you can populate the
Deployment activity and Deployment target pages
in the CodeCatalyst console with deployment information. Use the following instructions to
populate these pages.
To add deployment information to CodeCatalyst
-
If a workflow run did not start automatically when you committed your changes in
Step 1: Associate the
environment with a workflow action, manually start a
run as follows:
-
In the navigation pane, choose CI/CD, and then choose Workflows.
-
Choose the name of the workflow where you want to start a run. You can filter by
the source repository or branch name where the workflow is defined, or filter by
workflow name.
-
Choose Run.
The workflow run starts a new deployment, which causes CodeCatalyst to add deployment
information to CodeCatalyst.
-
Verify that deployment activity was added to the CodeCatalyst console:
-
In the navigation pane, choose CI/CD, and then choose
Environments.
-
Choose your environment (for example, Production
).
-
Choose the Deployment activity tab, and verify that a
deployment appears with a Status of
SUCCEEDED. This indicates that a workflow run successfully
deployed your application resources.
-
Choose the Deployment targets tab, and verify that your
application resources appear.