Installing GitLab Runner on a Linux Server: A Step-by-Step Guide

Introduction: GitLab Runner is an essential component for automating your CI/CD (Continuous Integration/Continuous Deployment) workflows with GitLab. In this guide, we’ll walk you through the process of installing GitLab Runner on a Linux server. By the end, you’ll have a fully functional GitLab Runner ready to execute your CI/CD jobs.

Prerequisites:

Before you begin, ensure that you have the following:

1. A Linux server (e.g., Ubuntu, CentOS, Debian) with SSH access.
2. A GitLab account and a project where you want to set up CI/CD.

Step 1: Register the Runner:

First, log in to your GitLab account and navigate to your project.

1. Go to Settings > CI / CD in your project.
2. Expand the “Runners” section and copy the registration token.

Step 2: Install GitLab Runner:

Now, let’s install GitLab Runner on your Linux server.

For Ubuntu/Debian:

# Install required dependencies
sudo apt-get update
sudo apt-get install -y curl

# Download and install GitLab Runner
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash
sudo apt-get install gitlab-runner

For CentOS:

# Install required dependencies
sudo yum install -y curl

# Download and install GitLab Runner
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo bash
sudo yum install gitlab-runner

Step 3: Configure and Start GitLab Runner:

1. Register the runner using the token obtained in Step 1

sudo gitlab-runner register

Follow the prompts, entering the GitLab instance URL, the registration token, and any other necessary details.

2. Start the GitLab Runner service.

sudo gitlab-runner start

Step 4: Verify the Installation:

Check the status of the GitLab Runner to ensure it’s running correctly.

sudo gitlab-runner status

If everything is set up correctly, you should see the status as “active.”

Conclusion:

Congratulations! You have successfully installed GitLab Runner on your Linux server. This runner is now ready to execute CI/CD jobs for your GitLab project. Customize your CI/CD pipeline in the project settings, and watch GitLab Runner automate your build and deployment processes.