Skip to content

Latest commit

 

History

History
47 lines (31 loc) · 2.26 KB

shell-executor.md

File metadata and controls

47 lines (31 loc) · 2.26 KB

Using a GitLab Shell Executor to Run CI/CD Pipelines in Orka

This guide explains how to set up a GitLab Shell executor in a MacStadium Orka environment for your GitLab builds.

The Shell executor allows you to run builds locally on the machine where the GitLab Runner is installed.

Requirements

Set up an Orka VM

You can set up an Orka VM using the Orka CLI or REST API. For more information, see the Orka quick start guide.

Set up a GitLab Runner

To set up a GitLab Runner, you need to:

  1. Install the Runner. You can install a GitLab Runner one of three ways: manually, via a homebrew installation, or in a Docker container.
  2. Obtain a token. The token will be used in Step 3 to register the newly installed GitLab Runner.
  3. Register the Runner. This is the process that binds the Runner to GitLab.
    Note: When asked to enter the executor type, select shell.

Using the GitLab Shell executor

Once the setup of the GitLab Runner is finished, you can run your CI/CD pipelines in Orka.

Connectivity

The communication between the GitLab Runner and the GitLab server is instantiated from the Runner.

This means your Orka environment must have visibility to the GitLab server.

Visibility from the GitLab server to the Orka environment is not required.