Run the CI Pipeline Locally¶

This guide explains how to run the Conflux CI pipeline on your local machine before pushing to GitLab.

Prerequisites¶

• Docker running locally
• gitlab-ci-local installed (npm install -g gitlab-ci-local or via Homebrew)

Steps¶

1. Make sure the Docker containers are running:

   docker compose up -d
   

2. From the project root, run:

   gitlab-ci-local
   

   The local CI configuration in .gitlab-ci-local/ mirrors the GitLab pipeline stages: quality → test → build.

3. Review the output. Failures in the quality or test stage will also fail the GitLab pipeline.

Running a Single Stage¶

gitlab-ci-local --stage quality
gitlab-ci-local --stage test

Notes¶

• The CI uses the image registry.gitlab.rapidmail.me/platform-integrations/conflux-docker-images/php-cli:8.5-dev-latest. Docker must be able to pull from that registry — ensure you are authenticated via docker login.
• For the full pipeline reference (stages, image, secrets), see the CI Pipeline reference.