https://github.com/thejohnfreeman/ami-gitlab-runner

An Amazon Machine Image for autoscaling GitLab Runners using Docker Machine.
https://github.com/thejohnfreeman/ami-gitlab-runner

Last synced: 23 days ago
JSON representation

An Amazon Machine Image for autoscaling GitLab Runners using Docker Machine.

• Host: GitHub
• URL: https://github.com/thejohnfreeman/ami-gitlab-runner
• Owner: thejohnfreeman
• License: isc
• Created: 2019-03-26T18:37:33.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2021-08-21T23:14:09.000Z (over 3 years ago)
• Last Synced: 2024-10-24T06:51:06.687Z (2 months ago)
• Language: Makefile
• Size: 13.7 KB
• Stars: 8
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ami-gitlab-runner

To run an [autoscaling GitLab Runner with Docker Machine on

AWS](https://docs.gitlab.com/runner/configuration/runner_autoscale_aws),

you must first [install a few

dependencies](https://docs.gitlab.com/runner/configuration/runner_autoscale_aws/#prepare-the-bastion-instance):

- [Docker](https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-using-the-repository)

- [Docker Machine](https://docs.docker.com/machine/install-machine/#install-machine-directly)

- [GitLab Runner](https://docs.gitlab.com/runner/install/linux-repository.html)

This project exists to provide a set of Amazon Machine Images (AMIs), one for

each (region, platform) combination, which already have these dependencies

installed. Then creating a bastion is as simple launching an instance with the

right image.

Once you register a GitLab Runner with the `docker+machine` executor, it will

need an AMI for the instances that Docker Machine launches. The

[default](https://docs.docker.com/machine/drivers/aws/#default-amis) is Ubuntu

16.04. Docker Machine will install Docker on those instances after they

launch, [unless they already have Docker

installed](https://docs.docker.com/machine/reference/provision/), in which

case you'll save some time. Thus, it makes sense to use one of these

images for the

[`amazonec2-ami`](https://docs.docker.com/machine/drivers/aws/#options) option

in your GitLab Runner's

[`MachineOptions`](https://docs.gitlab.com/runner/configuration/advanced-configuration.html#the-runnersmachine-section)

(corresponding to the `amazonec2-region` you choose).

| Region | Platform | AMI |

|--------|----------|-----|

| `us-east-2` | Linux | `ami-0b316c366679a59d7` |

```shell

$ aws ec2 describe-images --image-ids ami-0b316c366679a59d7

```

## Architecture

Each directory, [`linux`](./linux) and [`windows`](./windows), has

a [Packer](https://www.packer.io/) template for that platform and a Makefile

for building the image. Each pulls a version number from the

[`version` file](./version) in this directory.

## TODO

- Build AMIs for more regions.

- Build and publish AMIs within a continuous deployment pipeline.