NcamGnrvngu/gitlab-build-images
1
0
Fork 0
mirror of https://ops.gitlab.net/gitlab-org/gitlab-build-images.git synced 2025-12-09 18:12:55 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
Mirror of https://gitlab.com/gitlab-org/gitlab-build-images/
274 commits 76 branches 0 tags 1.5 MiB
Find a file
Marin Jankovski 311bb35edb Merge branch 'remove-terraform-from-charts-image' into 'master' 
Remove terraform from gitlab-charts-build-base

See merge request gitlab-org/gitlab-build-images!121
2018-10-10 08:15:06 +00:00
scripts Ensure that package managers clean up 2018-10-04 23:29:51 +02:00
.gitlab-ci.yml Add GitLab docs linting image to project, based on existing docs image for linting 2018-10-02 13:03:37 +10:00
CONTRIBUTING.md Update license and contributing.md 2017-11-14 14:57:23 +01:00
Dockerfile.alpine-aws Ensure that package managers clean up 2018-10-04 23:29:51 +02:00
Dockerfile.custom Remove references to deleted phantom script 2018-10-01 14:19:20 +02:00
Dockerfile.danger Ensure that package managers clean up 2018-10-04 23:29:51 +02:00
Dockerfile.gitlab-charts-build-base Remove terraform from gitlab-charts-build-base 2018-10-04 17:00:56 -05:00
Dockerfile.gitlab-docs-lint Add GitLab docs linting image to project, based on existing docs image for linting 2018-10-02 13:03:37 +10:00
Dockerfile.gitlab-qa use ruby 2.4 2018-07-09 16:46:50 -04:00
Dockerfile.gitlab-ui Ensure that package managers clean up 2018-10-04 23:29:51 +02:00
Dockerfile.omnibus-gitlab-bionic Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-centos6 Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-centos7 Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-jessie Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-opensuse42.3 Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-stretch Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-trusty Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-wheezy Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.omnibus-gitlab-xenial Delete ruby sources from omnibus images 2018-10-04 23:29:52 +02:00
Dockerfile.release-tools Ensure that package managers clean up 2018-10-04 23:29:51 +02:00
Dockerfile.sitespeed-gitlab add custom sitespeed image for gitlab 2018-02-21 17:50:11 -06:00
Dockerfile.www-gitlab-com-2.4 Update ruby in www-gitlab-com docker image to 2.4.x 2018-06-08 16:29:12 +00:00
LICENSE Update license and contributing.md 2017-11-14 14:57:23 +01:00
README.md Merge branch 'leipert-remove-phantom' into 'master' 2018-10-04 11:22:12 +00:00

README.md

GitLab Build Images

This repository is used to build docker images that are used to build and test various parts of GitLab:

  1. Build Omnibus packages
  2. Test GitLab-CE/EE project
  3. Build gitlab-org/www-gitlab-com project

Adding a new image

There are two methods to adding a new image:

  1. Use a docker buildfile.
  2. Use a custom image with versioned features.

Use a docker buildfile

A bespoke image is one that uses it's own Dockerfile. In the interests of avoiding repetition, it's better to use the custom docker build if possible.

Assuming the image you want to add is called new-image:

  1. Add a test task: new-image test: *test_build.
  2. Add a new build task: new-image: *build_and_deploy.
  3. Add a Dockerfile: Dockerfile.new-image.

Use a custom image with versioned features

To add a new image to the build, edit .gitlab-ci.yml.

With custom images, the name of the image is used to define the contents (as opposed to use a bespoke Dockerfile build).

For this reason, the name needs to be correctly defined.

The name is defined as [feature]-[version] pairs, separated by -.

Here are some example build names:

  1. ruby-2.1-git-2.7
  2. ruby-2.3.3-golang-1.8-git-2.7-chrome-60.0-node-7.1-postgresql-9.6
  3. ruby-2.4.1-golang-1.8-git-2.7-node-7.1-postgresql-9.6

The first pair represents the base image and version. So ruby-2.1-... will use the ruby:2.1 base image, while golang-1.8 will use the golang:1.8 base image.

Each of the following parts represents another feature and version. Available options are:

  1. golang
  2. git
  3. chrome
  4. node
  5. yarn
  6. postgres
  7. terraform
  8. ansible
  9. graphicsmagick

Adding a new build

As an example, if you want to add new image for Ruby 2.4 with git 2.14 and golang 1.9, the name would be ruby-2.4-golang-1.9-git-2.14.

  1. Add a test task: ruby-2.4-golang-1.9-git-2.14 test: *test_custom
  2. Add a new build task: ruby-2.4-golang-1.9-git-2.14: *build_and_deploy_custom

Note regarding Google Chrome

Google has a policy of yanking older versions of Google Chrome from their PPA whenever a new major version is released. To help maintain consistent build images, there is a CI step that saves the latest Google Chrome .deb into an S3 bucket. The install for Chrome will attempt to retrieve from the bucket if it cannot find the file in the apt repository. See scripts/cache-google-chrome for more details.

Contributing

See Contributing