This module creates a lambda that will sync GitHub action binary to a S3 bucket, the lambda will be triggered via a CloudWatch event. The distribution is cached to avoid the latency of downloading the distribution during the setup. After deployment the lambda will be triggered via an S3 object created at deployment time.
Usage examples are available in the root module. By default the root module will assume local zip files containing the lambda distribution are available. See the download lambda module for more information.
The Lambda function is written in TypeScript and requires Node 12.x and yarn. Sources are located in [./lambdas/runners-binaries-syncer].
cd lambdas/runners
yarn install
Test are implemented with Jest, calls to AWS and GitHub are mocked.
yarn run test
To compile all TypeScript/JavaScript sources in a single file ncc is used.
yarn run dist
No requirements.
Name | Version |
---|---|
aws | n/a |
Name | Description | Type | Default | Required |
---|---|---|---|---|
aws_region | AWS region. | string |
n/a | yes |
distribution_bucket_name | Bucket for storing the action runner distribution. | string |
n/a | yes |
environment | A name that identifies the environment, used as prefix and for tagging. | string |
n/a | yes |
lambda_schedule_expression | Scheduler expression for action runner binary syncer. | string |
"cron(27 * * * ? *)" |
no |
lambda_timeout | Time out of the lambda in seconds. | number |
300 |
no |
lambda_zip | File location of the lambda zip file. | string |
null |
no |
logging_retention_in_days | Specifies the number of days you want to retain log events for the lambda log group. Possible values are: 0, 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, and 3653. | number |
7 |
no |
role_path | The path that will be added to the role, if not set the environment name will be used. | string |
null |
no |
role_permissions_boundary | Permissions boundary that will be added to the created role for the lambda. | string |
null |
no |
runner_allow_prerelease_binaries | Allow the runners to update to prerelease binaries. | bool |
false |
no |
runner_architecture | The platform architecture for the runner instance (x64, arm64), defaults to 'x64' | string |
"x64" |
no |
tags | Map of tags that will be added to created resources. By default resources will be tagged with name and environment. | map(string) |
{} |
no |
Name | Description |
---|---|
bucket | n/a |
lambda | n/a |
lambda_role | n/a |
runner_distribution_object_key | n/a |
This module is part of the Philips Forest.
___ _
/ __\__ _ __ ___ ___| |_
/ _\/ _ \| '__/ _ \/ __| __|
/ / | (_) | | | __/\__ \ |_
\/ \___/|_| \___||___/\__|
Infrastructure
Talk to the forestkeepers in the forest
-channel on Slack.