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.
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
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
Related resources
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.
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.
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.
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.
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.
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.
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.