Create a GitLab pipeline to push to Artifact Registry

Clone your GitLab repository

1. To clone your GitLab repository to your working environment using SSH or HTTPS, follow the instructions in Clone a Git repository to your local computer.

2. If you are working in your local shell, install Terraform. Terraform is already installed in Cloud Shell.

Create a Dockerfile

1. In your cloned repository, create a new file named Dockerfile.

2. Copy and paste the following into your Dockerfile.

   # Dockerfile for test purposes. Generates a new random image in every build.
   FROM alpine:latest
   RUN dd if=/dev/urandom of=random bs=10 count=1
   

3. Add your Dockerfile to git, commit, and push to your GitLab repository.

   git add Dockerfile
   git commit -m "add dockerfile"
   git push
   

   You are prompted to enter your username and personal access token.

The Dockerfile generates a new random image for every build, and is only for test purposes.

Enable continuous integration (CI) runners on Compute Engine

GitLab Runner is an application that works with GitLab CI/CD to run jobs in a pipeline. The GitLab on Google Cloud integration assists you in setting up an autoscaling fleet of runners on Compute Engine, with a runner manager that creates temporary runners to execute multiple jobs simultaneously.

To set up your autoscaling fleet of runners, follow the instructions in Set up GitLab Runner to execute your CI/CD jobs on Google Cloud. Select Google Cloud as the environment where you want your runners to execute your CI/CD jobs, and fill out the rest of the configuration details.

Once you have entered the details for your runners, you can follow the setup instructions to configure your Google Cloud project, install and register GitLab Runner, and apply the provided terraform in your working environment to apply the configuration.

Create a pipeline

Create a pipeline that builds your Docker image, pushes it to GitLab container registry, and copies the image to Artifact Registry.

1. In your GitLab project, create a .gitlab-ci.yml file.

2. To create a pipeline that builds your image, pushes it to GitLab container registry, and copies it to Artifact Registry, modify the contents of your .gitlab-ci.yml file to resemble the following.

   Before copying the example, replace the following:

   • LOCATION: the Google Cloud region where you created your Artifact Registry repository.
   • PROJECT: your Google Cloud project ID.
   • REPOSITORY: the repository ID of your Artifact Registry repository.

   stages:
     - build
     - deploy
   
   variables:
     GITLAB_IMAGE: $CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA
   
   build-sample-image:
     image: docker:24.0.5
     stage: build
     services:
       - docker:24.0.5-dind
     before_script:
       - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
     script:
       - docker build -t $GITLAB_IMAGE .
       - docker push $GITLAB_IMAGE
   
   include:
     - component: gitlab.com/google-gitlab-components/artifact-registry/upload-artifact-registry@0.1.0
       inputs:
         stage: deploy
         source: $GITLAB_IMAGE
         target: LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/image:v1.0.0
   

The pipeline builds the image docker:24.0.5 using docker-in-docker, stores it in the GitLab container registry, and then pushes it to your Artifact Registry repository with the version v1.0.0 using the Artifact Registry GitLab component.

View your artifacts

To view your artifact in GitLab:

1. In your GitLab project, on the left sidebar, select Build > Artifacts.
2. Click the name of the artifact to view the details of the build.

To view your artifact in Artifact Registry:

1. Open the Repositories page in the Google Cloud console.

   Open the Repositories page

2. Click the name of your linked repository.

3. Click the name of the image to view the version name and tags.

4. Click the name of the image version to view the version's build, pull, and manifest information.