Building in GitLab

To learn how to use containers and docker on your local machine, refer to our tutorial section.

We use our own installation of GitLab for Source Code Management, Continuous Integration automation, containers registry and other development lifecycle tasks. It fully uses Nautilus Cluster resources, which provides our users unlimited storage and fast builds. All data from our GitLab except container images are backed up nightly to Google storage, which means there’s almost zero chance that you might lose your code in our repository.

Step 1: Create a Git repo
  1. To use our GItLab installation, register at
  2. Use GitLab for storing your code like any git repository. Here’s GitLab basics guide.
  3. create a new project in your GitLab account
Step 2: Use Containers Registry

What makes GitLab especially useful for kubernetes cluster in integration with Containers Registry. You can store your containers directly in our cluster and avoid slow downloads from DockerHub (although you’re still free to do that as well).

If you wish to use our registry, in your project go to Packages & Registries -> Container Registry menu and read instructions on how to use one.

Step 3: Continuous Integration automation

To fully unleash the GitLab powers, introduce yourself to Continuous Integration automation

  1. create the .gitlab-ci.yml file in your project, see Quick start guide. The runners are already configured.
    There’s a list of CI templates available for most common languages.
  2. If you need to build your Dockerfile and create a container from it, adjust this .gitlab-ci.yml template:

      - build-and-push
      stage: build-and-push
        - echo "{\"auths\":{\"$CI_REGISTRY\":{\"username\":\"$CI_REGISTRY_USER\",\"password\":\"$CI_REGISTRY_PASSWORD\"}}}" > /kaniko/.docker/config.json
        - /kaniko/executor --cache=true --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination $CI_REGISTRY_IMAGE:${CI_COMMIT_SHA:0:8} --destination $CI_REGISTRY_IMAGE:latest

    More advanced example

  3. Go to CI / CD -> Jobs tab to see in amazement your job running and image being uploaded to your registry.
  4. From the Packages -> Containers Registry tab get the URL of your image to be included in your pod definition:

      - name: my-container
Build better containers

Make yourself familiar with Docker containers best practices

Use multi-stage builds when necessary