GitLab CI/CD on Google Kubernetes Engine in 15 minutes or less
https://about.gitlab.com/blog/gitlab-ci-on-google-kubernetes-engine/ • 194 KB fetched Open original page
GitLab CI/CD on Google Kubernetes Engine in 15 minutes or less
Close
To search repositories and projects, login to gitlab.com .
Suggestions GitLab Duo Agent Platform Code Suggestions (AI) CI/CD GitLab on AWS GitLab on Google Cloud Why GitLab?
* Platform Execution & Workflows
* CI/CD
* Source Code Management
* Agile Delivery
Security & Governance
* Application Security Testing
* Governance & Compliance
* Supply Chain Security
Context & AI
* Agentic Orchestration
* Context Graph
* Visibility & Measurement
Explore the Platform
Why GitLab
One platform for speed with control across your software lifecycle.
Learn more
* Solutions Outcomes
* DevOps Modernization
* Security Modernization
* AI Modernization
By size
* Enterprise
* Small Business
* Startups
Industries
* Financial Services
* Public Sector
* Telecommunications
* Automotive
* Education
* Aerospace
View all Solutions
GitLab Transcend
Catch our latest innovations announced at the last Transcend.
Read the blog
* Pricing
* Resources Discover
* Docs
* University
* Demo Series
* Demo Hub
* Services
Connect
* Blog
* Community
* Customers
* Partners
* Events
View all resources
What’s new in GitLab
Stay updated with our latest features and improvements.
Read the latest
* Company
* About
* Jobs
* Press
* Handbook
* Leadership
* Investor relations
* Trust Center
* AI Transparency Center
* Newsletter
* Contact us
* Talk to sales
* Support portal
* Customer portal
Request a demo Get free trial Sign in
Get free trial
Ship at agent speed. Prove every step. Transcend returns on October 6. Register now
Blog
Engineering
GitLab CI/CD on Google Kubernetes Engine in 15 minutes or less
Published on: March 27, 2020
4 min read
GitLab CI/CD on Google Kubernetes Engine in 15 minutes or less
Install GitLab's Runner on GKE in a few simple steps and get started with GitLab CI/CD pipelines.
Elliot Rushton
integrations
kubernetes
cloud native
CI/CD
GKE
google
If you use GitLab Self-Managed , then getting started with GitLab CI using GitLab's integration with Google Kubernetes Engine (GKE) can be accomplished in a few simple steps. We have several blog posts and documentation that provide detailed setup instructions for working with Kubernetes clusters . In this post, we highlight the essential steps so that you can get going with GitLab CI/CD in less than 15 minutes.
By using the GitLab and GKE integration, with one click, you install GitLab Runners on GKE and immediately start running your CI pipelines. Runners are the lightweight agents that execute the CI jobs in your GitLab CI/CD pipeline.
Prerequisites:
The following pre-requisities will need to have been configured in order for you to use the built in GitLab GKE integration:
* GitLab instance installed and configured with user credentials
* Google OAuth2 OmniAuth Provider installed and configured on your GitLab instance
* A Google Cloud project with the following APIs enabled :
* Google Kubernetes Engine API
* Cloud Resource Manager API
* Cloud Billing API
Get started
Step 1
We’re going to add a shared runner at the instance level. First, as an administrator, click the “Admin Area” icon
Then on the left menu, select “Kubernetes”
Step 2
Click the green “Add Kubernetes cluster” button.
Step 3
The screen to “Add a Kubernetes cluster integration” should come up. Click on the “Google GKE” icon on the right.
Step 4
Give your cluster a name, and select a “Google Cloud Platform project” from your linked GCP account. If no projects are populated in the menu then either your Google OAUTH2 integration isn’t configured correctly or your project is missing the needed permissions. Check that these are set up and that the APIs mentioned in the prerequisites above are enabled.
Choose a zone in which to run your cluster. For the purposes of running CI, the number of nodes in your cluster is going to be how many simultaneous jobs you can run at given time. As we are using the built-in GitLab Google Kubernetes integration, you can set a maximum of four nodes.
Here we set that to three.
Click “Create Kubernetes Cluster”
It takes a few minutes for the cluster to be created. While it’s happening you should see a screen like this. You can leave this screen and come back (by going to “Admin Area> Kubernetes > your cluster name ”)
Step 5
Once the cluster has been created, we need to install two applications. First, install “Helm Tiller” by clicking on the “Install” button next to it.
This takes a moment, but should be much quicker than creating the cluster initially was.
Step 6
Now that Helm Tiller is installed, more applications can be installed. For this tutorial we only need to install the “GitLab Runner” application. Click the install button next to GitLab Runner.
Again, this should go pretty quickly.
Once done, the button will change to an “Uninstall” button. You’re now set up with shared runners on your GitLab instance and can run your first CI pipeline!
Next steps
Now that you are up and running with GitLab CI/CD on GKE, you can build and run your first GitLab CI/CD pipeline. Here are links to a few resources to get you started.
* Getting Started with GitLab CI/CD
* How to build a CI/CD pipeline in 20 minutes or less
* Getting started with Auto DevOps
If you are planning to manage your own fleet of GitLab Runners, then you may also be thinking about how best to set up autoscaling of GitLab Runners. As we have just set up your first Runner on GKE, then you can review the GitLab Runner Kubernetes Executor docs for additional details as to how the GitLab Runner uses Kubernetes to run builds on a Kubernetes cluster.
Other resources
* Scalable app depoyment webcast
* Install GitLab on a cloud native environment
* Adding and removing Kubernetes clusters
* Deploy production-ready GitLab on Google Kubernetes Engine
Cover image by Agê Barros on Unsplash
Share this article
Stay in the know with GitLab's monthly newsletter
All fields required
More to explore
View all blog posts
Engineering
Co-Create: Building GitLab with our users
Read the blog
Engineering
Git was built for humans — agents need an upgrade
Read the blog
Engineering
From chaos to context: Building an AI dev workflow
Read the blog
We want to hear from you
Enjoyed reading this blog post or have questions or feedback? Share your thoughts by creating a new topic in the GitLab community forum.
Share your feedback
Start building faster today
See what your team can do with the intelligent orchestration platform for DevSecOps.
Get your free trial Contact sales
®
Footer links
Pricing
* View plans
* Why Premium?
* Why Ultimate?
Contact Us
* Contact sales
* Support portal
* Customer portal
* Status
* Terms of use
* Privacy statement
*
Platform
* Explore the platform
* Agentic Orchestration
* CI/CD
* Context Graph
* Why GitLab
Topics
* CI/CD
* GitOps
* DevOps
* Version Control
* DevSecOps
* Cloud Native
* AI for Coding
* Agentic AI
Solutions
* DevOps modernization
* Security modernization
* AI modernization
* Financial services
* Public sector
* Telecommunications
* Automotive
* Education
* Aerospace
* Enterprise
* Small business
* Startups
* GitOps
* Software composition analysis
* Value stream management
* All solutions
Resources
* Install
* Quick start guides
* Docs
* University
* Demo Series
* Demo Hub
* Services
* Blog
* Community
* Customers
* Partners
* Events
* Newsletter
* What's new
* All resources
Company
* About
* Jobs
* Press
* Handbook
* Leadership
* Investor relations
* Trust Center
* AI Transparency Center
* Sustainability
* Diversity, inclusion and belonging (DIB)
* Modern Slavery Transparency Statement
*
*
*
*
Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license
View page source Edit this page Please contribute
© 2026 GitLab Inc.
Links found on this page
- gitlab.com [direct]
- GitLab Duo Agent Platform [direct]
- Code Suggestions (AI) [direct]
- CI/CD [direct]
- GitLab on AWS [direct]
- GitLab on Google Cloud [direct]
- Why GitLab? [direct]
- Source Code Management [direct]
- Agile Delivery [direct]
- Application Security Testing [direct]
- Governance & Compliance [direct]
- Supply Chain Security [direct]
- Context Graph [direct]
- Visibility & Measurement [direct]
- Explore the Platform [direct]
- DevOps Modernization [direct]
- Security Modernization [direct]
- AI Modernization [direct]
- Enterprise [direct]
- Small Business [direct]
- Startups [direct]
- Financial Services [direct]
- Public Sector [direct]
- Telecommunications [direct]
- Automotive [direct]
- Education [direct]
- Aerospace [direct]
- View all Solutions [direct]
- GitLab Transcend Catch our latest innovations announced at the last Transcend. Read the blog [direct]
- Pricing [direct]
- Docs [direct]
- University [direct]
- Demo Series [direct]
- Demo Hub [direct]
- Services [direct]
- Blog [direct]
- Community [direct]
- Customers [direct]
- Partners [direct]
- Events [direct]
- View all resources [direct]
- What’s new in GitLab Stay updated with our latest features and improvements. Read the latest [direct]
- About [direct]
- Jobs [direct]
- Press [direct]
- Handbook [direct]
- Leadership [direct]
- Investor relations [direct]
- Trust Center [direct]
- AI Transparency Center [direct]
- Newsletter [direct]
- Talk to sales [direct]
- Support portal [direct]
- Customer portal [direct]
- Request a demo [direct]
- Get free trial [direct]
- Ship at agent speed. Prove every step. Transcend returns on October 6. Register now [direct]
- Engineering [direct]
- Elliot Rushton [direct]
- integrations [direct]
- kubernetes [direct]
- cloud native [direct]
- CI/CD [direct]
- GKE [direct]
- google [direct]
- setup instructions for working with Kubernetes clusters [direct]
- GitLab CI/CD [direct]
- Google OAuth2 OmniAuth Provider [direct]
- Getting Started with GitLab CI/CD [direct]
- How to build a CI/CD pipeline in 20 minutes or less [direct]
- Getting started with Auto DevOps [direct]
- GitLab Runner Kubernetes Executor docs [direct]
- Install GitLab on a cloud native environment [direct]
- Adding and removing Kubernetes clusters [direct]
- Deploy production-ready GitLab on Google Kubernetes Engine [direct]
- Agê Barros [direct]
- Unsplash [direct]
- Engineering Co-Create: Building GitLab with our users Read the blog [direct]
- Engineering Git was built for humans — agents need an upgrade Read the blog [direct]
- Engineering From chaos to context: Building an AI dev workflow Read the blog [direct]
|
|