GitLab Runner Fleeting plugin for AWS EC2 instances (BETA)

Status update (2023-08-14)

• BETA release target date now at 16.5

Release notes

The GitLab Runner AWS EC2 Fleeting Plugin (Instance Executor) in Beta is now ready for customers interested in testing the new GitLab Runner Autoscaling solution on Amazon Web Services EC2 instances.

Overview

This is the capstone issue that delivers an AWS EC2 plug-in for autoscaling Runners on AWS virtual machines.

Supported OS & compute architectures

• Linux on x86-64

Example configuration

concurrent = 10

[[runners]]
  name = "instance autoscaler example"
  url = "https://gitlab.com"
  token = "<token>"
  shell = "sh"

  executor = "instance"

  # Autoscaler config
  [runners.autoscaler]
    plugin = "fleeting-plugin-aws"

    capacity_per_instance = 1
    max_use_count = 1
    max_instances = 10

    [runners.autoscaler.plugin_config] # plugin specific configuration (see plugin documentation)
      name             = "my-linux-asg"                # AWS Autoscaling Group name
      profile          = "default"                     # optional, default is 'default'
      config_file      = "/home/user/.aws/config"      # optional, default is '~/.aws/config'
      credentials_file = "/home/user/.aws/credentials" # optional, default is '~/.aws/credentials'

    [runners.autoscaler.connector_config]
      username          = "ec2-user"
      use_external_addr = true

    [[runners.autoscaler.policy]]
      idle_count = 5
      idle_time = "20m0s"

Disclaimer

This page may contain information related to upcoming products, features and functionality. It is important to note that the information presented is for informational purposes only, so please do not rely on the information for purchasing or planning purposes. Just like with all projects, the items mentioned on the page are subject to change or delay, and the development, release, and timing of any products, features, or functionality remain at the sole discretion of GitLab Inc.