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.
Code sample
Code Samples
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
Code sample
Code Samples
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
Code sample
Code Samples
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
Code sample
Code Samples
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
Code sample
Code Samples
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
Code sample
Code Samples
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
Code sample
Code Samples
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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThe GitLab on Google Cloud integration enables easy deployment of GitLab source code to Google Cloud runtimes, and is accessible for GitLab.com's Free, Premium, and Ultimate tiers.\u003c/p\u003e\n"],["\u003cp\u003eThis integration provides a range of tools and components like Artifact Registry, Cloud Deploy, Cloud Run, Cloud SDK, Cloud Storage, App Engine, and Google Kubernetes Engine (GKE) to manage and automate various cloud services within GitLab CI/CD pipelines.\u003c/p\u003e\n"],["\u003cp\u003eThere are several tutorials available, such as setting up the GitLab on Google Cloud integration and creating pipelines to interact with the Google Artifact Registry, simplifying the process of setting up and using the service.\u003c/p\u003e\n"],["\u003cp\u003eUsers can access comprehensive documentation, guides, and quickstarts, as well as resources like pricing information and release notes, to better understand and utilize the GitLab and Google Cloud services.\u003c/p\u003e\n"],["\u003cp\u003eThe GitLab components for Google Cloud simplify tasks such as managing container images, deploying applications to GKE and Cloud Run, and executing Google Cloud CLI commands directly within GitLab's CI/CD environment.\u003c/p\u003e\n"]]],[],null,["# GitLab on Google Cloud documentation\n====================================\n\n[Read product documentation](https://docs.gitlab.com/ee/ci/gitlab_google_cloud_integration/) The GitLab on Google Cloud integration simplifies deploying GitLab source code\nto Google Cloud runtimes, and is available for the Free, Premium, and\nUltimate tier of the GitLab.com offering.\n\n\nTo get started,\ntry the end-to-end GitLab tutorial,\n[Set up the GitLab on Google Cloud integration](https://docs.gitlab.com/ee/tutorials/set_up_gitlab_google_integration/).\n[Get started for free](https://console.cloud.google.com/freetrial) \n\n#### Start your proof of concept with $300 in free credit\n\n- Get access to Gemini 2.0 Flash Thinking\n- Free monthly usage of popular products, including AI APIs and BigQuery\n- No automatic charges, no commitment \n[View free product offers](/free/docs/free-cloud-features#free-tier) \n\n#### Keep exploring with 20+ always-free products\n\n\nAccess 20+ free products for common use cases, including AI APIs, VMs, data warehouses,\nand more.\n\nDocumentation resources\n-----------------------\n\nFind quickstarts and guides, review key references, and get help with common issues. \nformat_list_numbered\n\n### Guides\n\n-\n\n [Set up the GitLab on Google Cloud integration](https://docs.gitlab.com/ee/tutorials/set_up_gitlab_google_integration/)\n\n-\n\n [Overview](https://docs.gitlab.com/ee/ci/gitlab_google_cloud_integration/)\n\n-\n\n [GitLab on Google Cloud Identity and Access Management](https://docs.gitlab.com/ee/integration/google_cloud_iam.html)\n\n-\n\n [GitLab on Google Cloud Artifact management](https://docs.gitlab.com/ee/user/project/integrations/google_artifact_management.html)\n\n-\n\n [Provisioning runners](https://docs.gitlab.com/ee/ci/runners/provision_runners_google_cloud.html)\n\ninfo\n\n### Tutorials\n\n-\n\n [Create a GitLab pipeline to push to Google Artifact Registry](https://docs.gitlab.com/ee/tutorials/create_gitlab_pipeline_push_to_google_artifact_registry/)\n\n-\n\n [Create and deploy a web service with the Google Cloud Run component](https://docs.gitlab.com/ee/tutorials/create_and_deploy_web_service_with_google_cloud_run_component/)\n\ninfo\n\n### Resources\n\n-\n\n [GitLab Pricing](https://about.gitlab.com/pricing/)\n\n-\n\n [Artifact Registry Pricing](/artifact-registry/pricing)\n\n-\n\n [Google Cloud Pricing](/pricing)\n\n-\n\n [Release notes](/docs/gitlab/release-notes)\n\nRelated resources\n-----------------\n\nExplore self-paced training, use cases, reference architectures, and code samples with examples of how to use and connect Google Cloud services. Code sample \nCode Samples\n\n### Artifact Registry GitLab component\n\n\nArtifact Registry is a single place to manage container images. It is\nfully integrated with Google Cloud's tooling and runtimes. This makes\nit simple to integrate it with your CI/CD tooling to set up automated\npipelines. \n\nOnce you have connected GitLab to Artifact Registry and pushed a container image to your repository, you can view the\ncontainer image in GitLab orArtifact Registry, and you can access metadata\nfor each artifact inGoogle Cloud.\n\nComponent\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://gitlab.com/google-gitlab-components/artifact-registry) \nCode sample \nCode Samples\n\n### Cloud Deploy component\n\n\nThe `create-cloud-deploy-release` GitLab Component\ncreates a Cloud Deploy release to manage the deployment of an\napplication to one or more Google Kubernetes Engine (GKE) Enterprise edition or Cloud Run targets.\n\nComponent\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://gitlab.com/google-gitlab-components/cloud-deploy) \nCode sample \nCode Samples\n\n### Cloud Run component\n\n\nThe `deploy-cloud-run` GitLab Component automates the\ndeployment of your Cloud Run services within your GitLab\nCI/CD pipeline. The component offers flexible deployment behavior,\ncreating a brand-new service if one doesn't already exist in your project\nand region. Conversely, if a Cloud Run service with the same\nname is already present, the component updates it to a new revision using\nyour inputs.\n\nComponent\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://gitlab.com/google-gitlab-components/cloud-run) \nCode sample \nCode Samples\n\n### Google Cloud SDK component\n\n\nThe `run-gcloud` GitLab component executes Google Cloud CLI commands. The component uses a customized Google Cloud CLI image\ninstead of the `google/cloud-sdk` image to reduce the image size\nand avoid security vulnerabilities.\n\nComponent\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://gitlab.com/google-gitlab-components/cloud-sdk) \nCode sample \nCode Samples\n\n### Cloud Storage component\n\n\nCloud Storage is a managed service for storing unstructured data.\nStore 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.\n\nComponent\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://gitlab.com/google-gitlab-components/cloud-storage) \nCode sample \nCode Samples\n\n### App Engine component\n\n\nThe `deploy-app-engine` component deploys container\nimages stored in Artifact Registry, or App Engine flexible environmentsource code, to App Engine as part of your GitLab CI/CD pipeline.\n\nComponent\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://gitlab.com/google-gitlab-components/gae) \nCode sample \nCode Samples\n\n### Google Kubernetes Engine (GKE) component\n\n\nThe `deploy-gke` component deploys a container image to a GKE cluster. It also performs horizontal pod autoscaling\nup to 3 nodes and creates a Service if the application needs a port exposed.\n\nComponent\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://gitlab.com/google-gitlab-components/gke)\n\nRelated videos\n--------------"]]
