add example

Author: npalm

examples/multi-runner/main.tf

@@ -1,14 +1,38 @@
-data "aws_ssm_parameter" "al2023_arm" {
+# The module provides several ways to chose the AMI ID for the runners. The recommended way is to use the SSM parameter ARN.
+# The default is (still) a build in filter that creates internally an SSM parameter for the AMI ID.
+#
+# Here we show two other options
+# 1. Use the SSM parameter ARN directly via a public available SSM parameter
+# 2. Use the SSM parameter ARN via a private SSM parameter injected to the module
+# 3. Other runners like ubuntu, windows, etc. are using the build in one parameter.
+
+data "aws_ssm_parameter" "al2023_x64" {
   name = "/aws/service/ami-amazon-linux-latest/al2023-ami-kernel-6.1-x86_64"
 }
 
+data "aws_ssm_parameter" "al2023_arm64" {
+  name = "/aws/service/ami-amazon-linux-latest/al2023-ami-kernel-6.1-arm64"
+}
+
+resource "aws_ssm_parameter" "al2023_arm64" {
+  name      = local.al2023_arm64_name
+  type      = "String"
+  data_type = "aws:ec2:image"
+  value     = data.aws_ssm_parameter.al2023_arm64.value
+}
+
+data "aws_caller_identity" "current" {}
+
 locals {
   environment = var.environment != null ? var.environment : "multi-runner"
   aws_region  = var.aws_region
 
-  # create map only with amazon linux 2023 x64 ami id
-  ssm_ami_ids = {
-    "linux-x64" = data.aws_ssm_parameter.al2023_arm.arn
+  # create map only with amazon linux 2023 x64 and arm64 to overwrite the default
+  al2023_arm64_name = "/examples/multi-runner/aws-github-runners/ami/amazon-linux-2023-arm64"
+  ssm_ami_arns = {
+    "linux-x64" = data.aws_ssm_parameter.al2023_x64.arn
+    # construct the arn to avoid terraform count errors
+    "linux-arm64" = "arn:aws:ssm:${var.aws_region}:${data.aws_caller_identity.current.account_id}:parameter${local.al2023_arm64_name}"
   }
 
   # Load runner configurations from Yaml files
@@ -17,6 +41,7 @@ locals {
 
     trimsuffix(c, ".yaml") => yamldecode(file("${path.module}/templates/runner-configs/${c}"))
   }
+
   multi_runner_config = {
     for k, v in local.multi_runner_config_files :
 
@@ -28,7 +53,7 @@ locals {
           {
             subnet_ids               = lookup(v.runner_config, "subnet_ids", null) != null ? [module.base.vpc.private_subnets[0]] : null
             vpc_id                   = lookup(v.runner_config, "vpc_id", null) != null ? module.base.vpc.vpc_id : null
-            ami_id_ssm_parameter_arn = lookup(local.ssm_ami_ids, k, null) != null ? local.ssm_ami_ids[k] : null
+            ami_id_ssm_parameter_arn = lookup(local.ssm_ami_arns, k, null) != null ? local.ssm_ami_arns[k] : null
           }
         )
       }

examples/multi-runner/templates/runner-configs/linux-arm64.yaml

@@ -15,6 +15,7 @@ runner_config:
   instance_types:
     - t4g.large
     - c6g.large
+  ami_id_ssm_parameter_arn: ${ami_id_ssm_parameter_arn}
   runners_maximum_count: 1
   delay_webhook_event: 0
   scale_down_schedule_expression: cron(* * * * ? *)