In this guide we will learn how to spin up GitLab in the AWS Marketplace:

Pre requisites for this lab are having an account in AWS and an accessible and working VPC.

We will learn the following steps:

  1. Stand up a self-managed instance of GitLab.
  2. Install Runner and Docker Engine.

Step-by-step Instructions

Step 1 - Stand up GitLab instance in AWS

aws-1

aws-2

aws-3

aws-4

aws-5

aws-6

aws-7

aws-8

aws-9

aws-10

The provisioning takes a few minutes. Please wait before you start the next step.

Copy the private or public IP to your browser , depending on your VPC configuration.

aws-10_5

aws-11

aws-13

Congratulations! you managed to start a GitLab instance and sign in to it.

aws-14

Step 2 - Install Runner and Docker Engine

Runner machines are the build agents that run the CI/CD jobs.

Requirements:

Connect to the machine with the AWS console - Connect

In order to setup the Runners and Docker engine, we need to connect to the GitLab machine we are running. This can be done via SSH from any command line, or directly via the AWS Console, depending on how your VPC is set. In our example we will use the AWS console - Connect feature to SSH into the machines.

WARNING: It is not a recommended best practice to install Runners on the same machine where the server is installed for security and performance reasons, but only for the sake of simplicity, in this blog we will install it on the same machine.

runner-1

runner-2

Install Docker engine

Setup Runners

Register the Runner

runner-5

runner-7.png

runner-7.png

Well done!! You installed and registered successfully GitLab Runner. Now you are ready to create a project and run your first CI/CD pipeline.

In my next blog, I will show you how to create a project, configure the CI/CD, change your application code, and run a CI/CD pipeline.

Try all GitLab features - free for 30 days

GitLab is more than just source code management or CI/CD. It is a full software development lifecycle & DevOps tool in a single application.

Try GitLab Free
Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license

Try the GitLab DevOps Platform for free for 30 days

Achieve higher productivity, faster and secure deployments

Start your free trial Maybe later