Build & Deploy#

This is a pipeline for testing and deploying new changes that have been made to anything that is directly related to the Docker part of the project.

Environment#

Name	Necessity	Origin
BPROTO_CI_DEPLOY_USER	Mandatory
BPROTO_CI_DEPLOY_TOKEN	Mandatory
BPROTO_CI_IMAGES_REGISTRY	Mandatory
CI_COMMIT_REF_NAME	Mandatory	GitLab
CI_DEFAULT_BRANCH	Mandatory	GitLab

Triggers#

All jobs from Docker “sub-pipeline” stages are triggered and only if changes have been made to docker files. Right now such files are detected by below patterns:

conan/*
cmake/Conan.cmake,
docker/*.Dockerfile,
scripts/conan/
scripts/os/setup_*.sh,
requirements.txt.

Stages overview#

Build stage#

This stage is responsible for building Docker images from a clean state to make sure there are no unexpected results.

ALLOW FAILURE

Jobs are not allowed to fail as any failure means fundamental problems in a specific docker image.

ARTIFACTS

Jobs don’t generate any artifacts.

DEPENDENCIES

Jobs don’t require artifacts from other jobs.

Jobs has no dependencies from other stages or jobs.

ENVIRONMENT

A list of all environment variables can be found here.

IMAGES

docker:19.03.12.

TRIGGERS

Job is triggered only on merge requests when any file from trigger list is changed.

Deploy stage#

This stage is responsible for generating pre-build docker images for our pipelines. So called pre-build images are crucial part of our CI/CD as it allows us to decrease execution time of jobs.

ALLOW FAILURE

Jobs are not allowed to fail as these jobs are run only on CI_DEFAULT_BRANCH after accepting a successful merge request!

ARTIFACTS

New docker images will be deployed to the project container registry.

DEPENDENCIES

Jobs don’t require artifacts from other jobs.

Jobs has no dependencies from other stages or jobs.

ENVIRONMENT

A list of all environment variables can be found here.

IMAGES

docker:19.03.12.

TRIGGERS

Job is triggered only on CI_DEFAULT_BRANCH when any file from trigger list is changed.

Jobs overview#

Job name	Stage	Image
General purpose images
`build:docker:alpine3`	build	Alipne 3
`deploy:docker:alpine3`	deploy	Alipne 3
`build:docker:centos7`	build	CentOS 7
`deploy:docker:centos7`	deploy	CentOS 7
`build:docker:centos8`	build	CentOS 7
`deploy:docker:centos8`	deploy	CentOS 7
`build:docker:ubuntu2004`	build	Ubuntu 20.04
`deploy:docker:ubuntu2004`	deploy	Ubuntu 20.04
`build:docker:ubuntu2304`	build	Ubuntu 20.04
`deploy:docker:ubuntu2304`	deploy	Ubuntu 20.04
Dedicated images
`build:docker:clang-format`	build	Clang-Format
`deploy:docker:clang-format`	deploy	Clang-Format
`build:docker:conan`	build	Conan
`deploy:docker:conan`	deploy	Conan
`build:docker:hadolint`	build	HadoLint
`deploy:docker:hadolint`	deploy	HadoLint

Usage#

This is an internal part of the Docker “sub-pipeline” which meant to be used solely by 3CT: Common CI/CD Tools project.