Environment

What is an Environment?

Environment files specify which cloud, account, and region to configure infrastructure in. From this file, Opta will create all the base resources, including: kubernetes clusters, networks, IAM roles, ingress, service mesh, etc. Usually, you’ll have one environment file for staging, one for production, one for quality assurance (QA), etc.

You can also create one environment per engineer or pull request, which gives each member of your team an isolated development sandbox.

Definition

An environment is defined in a yaml file.

# Name of the environment
name: awsenv-ci
org_name: runx
providers:
  # example for AWS
  aws:
    region: us-east-1
    account_id: XXXX # Your 12 digit AWS account id
modules:
  # creates the network
  - type: base
  # additional modules, ex: k8s-cluster

State Storage

Unless you’re using Opta’s local option, the state will be stored in your cloud’s native bucket solution (e.g. S3, GCS, etc…) in the account/project you specified. This bucket lives outside of the underlying terraform state (because of chicken-egg), but is still “managed” by Opta and will be cleaned up on deletion. Opta creates one bucket per environment and stores the state plus metadata of the environment and all services created there as different objects inside said bucket. The name of the bucket created will be shown in the opta outputs as state_storage.

Next steps

• Learn about modules.