Skip to content

Latest commit

 

History

History
101 lines (68 loc) · 3.32 KB

README.md

File metadata and controls

101 lines (68 loc) · 3.32 KB
Raw

Building aggregation service artifacts for Amazon Web Services

Prerequisites

Set up AWS client

Make sure you install and set up the latest AWS client.

Set up Terraform

Change into the <repository_root>/build-scripts/aws/terraform folder.

The setup scripts require terraform version 1.2.3. You can download Terraform version 1.2.3 from https://releases.hashicorp.com/terraform/1.2.3/ or at your own risk, you can install and use Terraform version manager instead.

If you have the Terraform version manager tfenv installed, run the following in your <repository_root>/build-scripts/aws/terraform to set Terraform to version 1.2.3.

tfenv install 1.2.3;
tfenv use 1.2.3

We recommend you store the Terraform state in a cloud bucket. Create a S3 bucket via the console/cli, which we'll reference as tf_state_bucket_name. Please consider enabling versioning for this bucket.

Configure CodeBuild Setup

Copy main.tf_sample and codebuild.auto.tfvars_sample and adjust values. Run in <repository_root>/build-scripts/aws/terraform

cp main.tf_sample main.tf
cp codebuild.auto.tfvars_sample codebuild.auto.tfvars

Open main.tf to configure your terraform state backend storage. Open codebuild.auto.tfvars to set build region, artifact_output location and github access credentials. All available variables to configure can be found in codebuild_variables.tf

Run terrform init to setup terraform.

To apply changes run terraform apply and follow the prompt

Plan: 8 to add, 0 to change, 0 to destroy.
...

Building the build container

The build container is requried for the aggregation service artifacts build.

To trigger the build run:

aws codebuild start-build --project-name bazel-build-container --region <your_aws_region>

The build can take several minutes. You can check the status at https://<region>.console.aws.amazon.com/codesuite/codebuild/projects.

Building artifacts

To build the aggregation service artifacts the above build container is required. Make sure the build for the build container ran successful before starting the build for the aggregation service artifacts.

To trigger the build run:

aws codebuild start-build --project-name aggregation-service-artifacts-build --region <your_aws_region>

The build can take several minutes. You can check the status at https://<region>.console.aws.amazon.com/codesuite/codebuild/projects.

Download artifacts

To download the artifacts you can use the aws s3 command. Download the artifacts to <repository_root>/terraform/aws/jars. Run the following in <repository_root>/terraform/aws

mkdir -p jars
aws s3 cp s3://<build_artifacts_output_bucket>/aggregation-service/$(cat ../../VERSION)/ jars/ --recursive

Fetch Aggregation Service Terraform

Switch to <repository_root>/terraform/aws.

Run bash fetch_terraform.sh.

After downloading the artifacts and running above script continue with Set up your deployment environment