Application

Given this configuration, you should achieve the following outcome after completing this page:

Configuration
Environment	pirates-dev
AppName	too-tikki
Outcome
ECR	pirates-dev-too-tikki
URL	https://too-tikki.pirates-dev.oslo.systems/

Step 1: Create configuration file

Create a new configuration file for the application and enable the components you need.

This configuration enables as few options as possible to set up a hello world application running on nginx that will have an internet-facing address.

The remaining options are disabled to keep the setup as simple as possible.

repo-iac/environments/dev/vars/vars-app-too-tikki.yml

StackName: "app-too-tikki"
app-data.StackName: "app-too-tikki-data"

AppName: "too-tikki"
AppEcsExec: false
AppReadOnlyRootFileSystem: false

ExampleImage:
  Enable: true
ServiceConnect:
  Enable: false
AlbHostRouting:
  Enable: true
  Internal: false
DatabaseConnectivity:
  Enable: true
OpenTelemetrySidecar:
  Enable: false
VpcEndpoints:
  Enable: false
Xray:
  Enable: false
DailyShutdown:
  Enable: false
IamForCicd:
  Enable: false
  AppGitHubRepo: pirates-apps
  IacGitHubRepo: pirates-iac
  AssumableCdRole: false

Step 2: Fetch the application template

Run the following command in the repo-iac/environments/dev/ directory:

repo-iac/environments/dev/

boilerplate \
  --template-url "git@github.com:oslokommune/golden-path-boilerplate.git//boilerplate/terraform/app/?ref=main" \
  --var-file vars/vars-app-too-tikki.yml \
  --var-file vars/vars-common.yml \
  --output-folder app-too-tikki \
  --non-interactive

Step 3: Initialize and apply the stacks

Applications are separated into two stacks when creating them.

The first stack is the data stack, which contains ECR and data-related resources, this must be applied first.

The second stack is the application stack, which contains the load balancing set up, ECS service, security groups and more for your application.

repo-iac/environments/dev

cd app-too-tikki-data/
terraform init
terraform apply

repo-iac/environments/dev

cd app-too-tikki/
terraform init
terraform apply

Step 4: Verify

Verify in the AWS CLI

To verify that ECR is correctly set up, run the following command:

aws ecr describe-repositories | jq '.repositories[].repositoryName'

The output list should contain the name of the ECR repository.

Verify in the AWS console

Login to the AWS console and navigate to ECR. Select Repositories in the left-hand menu.

The list should contain the name of the ECR repository.

Verify in the browser

Go to https://too-tikki.pirates-dev.oslo.systems/ and you should see the default Nginx page. Change URL according to your environment and application name.

Commit your files

At this stage it is a good idea to commit your files.