In this article we will see how to install gitlab-runner on Redhat Linux 6
What is Gitlab Runner? Below is the definition of Gitlab-runner as provided in Gitlab documentation:
"GitLab Runner is the open source project that is used to run your jobs and send the results back to GitLab. It is used in conjunction with Gitlab CI/CD, the open-source continuous integration service included with GitLab that coordinates the jobs"
As you can see in below screenshot that there are currently no runners registered with your Gitlab. In order to see all registered runners:
Goto your Gitlab console -> Your Project -> Settings -> CI / CD
Expand the Runners section and you will see a screen similar to below. Any registered runners will be visible in this section. You can't see any runners, as currently there are no runners registered.
Now let us see the steps to install Gitlab runner, register it with Gitlab and run your first pipeline:
Install Runner:
- Run the wget command to download gitlab-runner.
wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
- Provide execute permission to the runner and create a directory which will be used by the runner to clone the repository. This directory is also known as build directory.
chmod +x /usr/local/bin/gitlab-runner
mkdir /home/gitlab-runner-builds
- Execute the below command to install and start the gitlab-runner. Provide the working directory which was created in the previous step and a user name, which will be used to run the runner. I am using the root user, but it is recommended to create a separate user for the runner.
gitlab-runner install --working-directory /home/gitlab-runner-builds --user root
gitlab-runner start
Runner Registration
- Execute the below command to register the runner with your Gitlab server:
gitlab-runner register
You will need to provide below parameters:
gitlab-ci coordinator url: http or https url of your gitlab console
gitlab-ci token:
This can be found in the Gitlab console -> <Project Name> -> Settings -> CI/CD -> Runners
Descitption: Name that you want to give to your runner.
Tags: This is in key-value pair format. It is an optional parameter.
Executor: GitLab Runner implements a number of executors that can be used to run your builds in different scenarios. In this example, I am using shell executor.
Once your runner is installed you should be able to see the runner under Gitlab console:
Before executing our pipeline, let us understand about a special file "gitlab-ci.yml". Below is an extract from Gitlab documentation:
GitLab CI/CD pipelines are configured using a YAML file called .gitlab-ci.yml
within each project.
The .gitlab-ci.yml
file defines the structure and order of the pipelines and determines:
- What to execute using GitLab Runner.
- What decisions to make when specific conditions are encountered. For example, when a process succeeds or fails.
Execute your first Pipeline:
- Goto your Gitlab console -> Project -> Repository -> Files -> New File
- Click on "Select a template type" -> .gitlab-ci.yml
- Under Template types, select a template which works with your runner. As I have used a shell runner, so I have selected the "Bash" template.
- Click commit.
As soon as you commit your template, it will execute your pipeline and all stages will be executed.
Comments
Post a Comment