Skip to content

Setup

What Will You Do

In this part, you will use the Platform Team persona (i.e. Infra Admin role in Rafay) to import and configure the environment template for the Amazon ECS infrastructure.

Important

This is a one-time setup. Once completed, it can be shared/used by 100s/1000s of developers in your Org.


Step 1: Import Template

In this step, you will use the Loader Utility to import the Environment Manager templates needed for this environment.

  • Follow the instructions here to use the loader utility
  • When using the loader utility, be sure to uncomment the following template - ../terraform/aws/101-caas-ecs in the templates section of the values.yaml file

Once Complete, you will see the new environment card in your organization under Environments -> Environments


Step 2: Configure Environment Contexts

In this step, you will configure the environment contexts in the controller with your AWS and Rafay account details. These account details will be used by Environment Manager to interact with your accounts.

Configure AWS Context

You will need to update IAM Policies in your AWS account so that Rafay Environment Manager can provision required AWS resources in your account.

  • Log into the controller and select your project
  • Navigate to Environments -> Config Contexts
  • Click on the existing AWS config context name
  • Select Environment Variables
  • Populate the access key and secret key values
  • Ensure that you select the sensitive checkbox for both fields

Populate Context

Important

The Rafay agent automatically writes back the environment variables to Git. The resources (esp. secrets) you identify as sensitive. will be automatically encrypted using a secret sealer before being synced to your Git repo.


Step 3: Configure Template Variables

In this step, you will review the resource templates and environment templates to ensure that all variables are updated for your environment.

  • Navigate to Environments -> Resource Templates
  • Click on the resource templates that were created
  • Click the view icon of the template version
  • Verify all Input Variables

If any Input variables need to be modified, create a new version of the template with the modified variables. If a new version is created, be sure to update the Environment Template with any updated resource template versions.

  • Navigate to Environments -> Environment Templates
  • Click on the environment template that was created
  • Click the view icon of the template version
  • Verify all Input Variables

If any input variables need to be modified, create a new version of the template with the modified variables.


Step 4: Share Environment Template

In this step, you will share the environment template with your developer projects to enable self service for the developers to deploy these environments.

  • Log into the controller and select your project
  • Navigate to Environments -> Environment Templates
  • Click on the manage sharing icon next to the environment template
  • Select Specific Projects
  • Select the projects to share the template with
  • Click Save

Recap

At this point, you have everything setup and configured to manage the infrastructure environment through Environment Manager.