aws-classic-py-ecs-fargate

NGINX on AWS ECS Fargate using Python with a vpc built-in TypeScript

What Is This?

This example demonstrates the ability to deploy resources in Pulumi using one language (TypeScript) and then reference those resources from another Pulumi application using a different language (Python).

aws-classic-py-ecs-fargate deploys an AWS ECS Cluster using Python that references the VPC from aws-classic-ts-vpc-crosswalk that deploys an AWS VPC using TypeScript

It provisions a full Amazon Elastic Container Service (ECS) "Fargate" cluster and related infrastructure, running a load-balanced NGINX web server accessible over the internet on port 80. This example is inspired by Docker's Getting Started Tutorial.

Why would you do this?

An example showing that you can easily infrastructure written in a different language than the one you are used to. The vpc outputs from aws-classic-ts-vpc-crosswalk folder are used as inputs via StackReference

Prerequisites

• Install Pulumi
• Configure Pulumi to Use AWS (if your AWS CLI is configured, no further changes are required)

Mandatory AWS Pre-REQ: AWS Console Fix for Tags

This is necessary so that the tags work properly in ecs Tagging your Amazon ECS resources

As per AWS: You must opt in to the new Amazon Resource Name (ARN) and resource identifier (ID) formats.

This has to be done per region until AWS enables it as default across the board(April 1, 2021).

AWS Console -> Elastic Container Service -> Account Settings ->

BEFORE

Resource                My IAM user or role account settings
Container Instance      Undefined
Service                 Undefined
Task                    Undefined

AFTER

Resource                My IAM user or role account settings 
Container Instance      Enabled
Service                 Enabled
Task                    Enabled

Running the Example

1. Initialize a new stack called: ecs-fargate-dev via pulumi stack init.

   pulumi stack init ecs-fargate-dev

2. Create a Python virtualenv, activate it, and install dependencies:

   python3 -m venv venv
   source venv/bin/activate
   pip3 install -r requirements.txt

3. View the current config settings. This will be empty.

   pulumi config

   KEY                     VALUE

4. Populate the config.

   Here are aws endpoints

   The StackReference constructor takes as input a string of the form org/project/stack, and lets you access the outputs of that stack. This format is ONLY for the SaaS based backend of pulumi(not for self-hosted).

   Note: The key is mystackpath. The value for it will be your stackreference from the vpc:

   e.g.: team-qa/crosswalk-vpc/vpc-fargate-dev

   pulumi config set aws:region us-east-2 # must match vpc region
   pulumi config set config set mystackpath team-qa/crosswalk-vpc/vpc-fargate

5. View the current config settings

   pulumi config

   KEY                     VALUE
   aws:region           us-east-2
   mystackpath          team-qa/crosswalk-vpc/vpc-fargate

6. Launch

   pulumi up

   select y to continue

7. Open the View Live link to view the deployment details in the Pulumi Console. Note, you will have a URL that shows up that will look similar to the one below. The team-qa value will be replaced with your own org, for example if your org name is: team-prod:

   console view that matches above code as an example:

   https://app.pulumi.com/team-qa/fargate-with-crosswalk-vpc/ecs-fargate-dev/

   console view with YOUR ORG NAME:

   https://app.pulumi.com/team-prod/fargate-with-crosswalk-vpc/ecs-fargate-dev/

8. View the outputs

   pulumi stack output

   Current stack outputs (2):
   OUTPUT             VALUE
   ECS Cluster Tags   {"Name":"pulumi-fargate-ecs-cluster","application":"fargate","costcenter":"1234","crosswalk-vpc":"yes","demo":"yes","env":"dev","pulumi:Config":"Pulumi.ecs-fargate-dev.yaml","pulumi:project":"fargate-with-crosswalk-vpc","pulumi:stack":"ecs-fargate-dev","vpc_cidr":"10.0.0.0/24","vpc_name":"vpc-fargate-dev"}
   
   Load Balancer URL  pulumi-fargate-alb-7467631-1452059497.us-east-2.elb.amazonaws.com

9. Cleanup.

   pulumi destroy -y
   pulumi rm ecs-fargate-dev