GitLab on Google Cloud documentation

The GitLab on Google Cloud integration simplifies deploying GitLab source code to Google Cloud runtimes, and is available for the Free, Premium, and Ultimate tier of the GitLab.com offering.

To get started, try the end-to-end GitLab tutorial, Set up the GitLab on Google Cloud integration.

Get started for free

Start your proof of concept with $300 in free credit

Get access to Gemini 2.0 Flash Thinking
Free monthly usage of popular products, including AI APIs and BigQuery
No automatic charges, no commitment

View free product offers

Keep exploring with 20+ always-free products

Access 20+ free products for common use cases, including AI APIs, VMs, data warehouses, and more.

Documentation resources

Find quickstarts and guides, review key references, and get help with common issues.

Guides

Tutorials

Resources

Explore self-paced training from Google Cloud Skills Boost, use cases, reference architectures, and code samples with examples of how to use and connect Google Cloud services.

Artifact Registry GitLab component

Artifact Registry is a single place to manage container images. It is fully integrated with Google Cloud’s tooling and runtimes. This makes it simple to integrate it with your CI/CD tooling to set up automated pipelines.

Once you have connected GitLab to Artifact Registry and pushed a container image to your repository, you can view the container image in GitLab orArtifact Registry, and you can access metadata for each artifact inGoogle Cloud.

Component

Cloud Deploy component

The create-cloud-deploy-release GitLab Component creates a Cloud Deploy release to manage the deployment of an application to one or more Google Kubernetes Engine (GKE) Enterprise edition or Cloud Run targets.

Component

Cloud Run component

The deploy-cloud-run GitLab Component automates the deployment of your Cloud Run services within your GitLab CI/CD pipeline. The component offers flexible deployment behavior, creating a brand-new service if one doesn't already exist in your project and region. Conversely, if a Cloud Run service with the same name is already present, the component updates it to a new revision using your inputs.

Component

Google Cloud SDK component

The run-gcloud GitLab component executes Google Cloud CLI commands. The component uses a customized Google Cloud CLI image instead of the google/cloud-sdk image to reduce the image size and avoid security vulnerabilities.

Component

Cloud Storage component

Cloud Storage is a managed service for storing unstructured data. Store any amount of data and retrieve it as often as you like. To upload to Cloud Storage, add the component to your CICD pipeline in GitLab.

Component

App Engine component

The deploy-app-engine component deploys container images stored in Artifact Registry, or App Engine flexible environmentsource code, to App Engine as part of your GitLab CI/CD pipeline.

Component

Google Kubernetes Engine (GKE) component

The deploy-gke component deploys a container image to a GKE cluster. It also performs horizontal pod autoscaling up to 3 nodes and creates a Service if the application needs a port exposed.

Component