Skip to main content

Bootloader

The bootloader for CI Tools is used in mostly components and is automatically loaded. It is responsible for loading the internal Bash library and its functions available for the components. The bootloader is also responsible for loading the correct version of the library based on the version specified in the pipeline.

In order the bootloader execute the following steps:

  • Download and store the library in the current shell environment from your local GitLab.
  • Initialise the library and execute library.sh

Usage

To load the bootloader simply execute the command:

include:
- component: $CI_SERVER_FQDN/xrow-public/ci-tools/common@stable

my-job:
script: |
source <( echo "${CI_BOOTLOADER}" | base64 -d ) ${CI_TOOLS_VERSION};

The version can be received later on via the environment variable CI_TOOLS_VERSION which is automatically set by the common component.

Troubleshooting permissions

If you encounter issues with cloning the repository, ensure that the user has access to the repository.

In case the ci-tools repository is internal, external users do not have access to the internal repository.

You have the following options to resolve the issue:

  • Uncheck the external user checkbox in the users profile.
  • Provide a CI_BOOTLOADER_TOKEN variable is set with a valid token.