GitLab Continuous Integration (GitLab CI/CD)
GitLab CI/CD is GitLab's built-in tool for software development using continuous methodology:
- Continuous integration (CI).
- Continuous delivery and deployment (CD).
CI/CD is a vast area, so GitLab provides documentation for all levels of expertise. Consult the following table to find the right documentation for you:
|Level of expertise||Resource|
|New to the concepts of CI and CD||For a high-level overview, read an introduction to CI/CD with GitLab.|
|Familiar with GitLab CI/CD concepts||After getting familiar with GitLab CI/CD, let us walk you through a simple example in our getting started guide.|
|A GitLab CI/CD expert||Jump straight to our
Familiarity with GitLab Runner is also useful because it is responsible for running the jobs in your CI/CD pipeline. On GitLab.com, shared Runners are enabled by default so you won't need to set this up to get started.
CI/CD with Auto DevOps
Auto DevOps is the default minimum-configuration method for implementing CI/CD. Auto DevOps:
- Provides simplified setup and execution of CI/CD.
- Allows GitLab to automatically detect, build, test, deploy, and monitor your applications.
Manually configured CI/CD
For complete control, you can manually configure GitLab CI/CD.
With basic knowledge of how GitLab CI/CD works, the following documentation extends your knowledge into more features:
|Creating and using CI/CD pipelines||Understand, visualize, create, and use CI/CD pipelines.|
|CI/CD Variables||How environment variables can be configured and made available in pipelines.|
|Where variables can be used||A deeper look into where and how CI/CD variables can be used.|
|User and job permissions||Learn about the access levels a user can have for performing certain CI actions.|
|Configuring GitLab Runners||Documentation for configuring GitLab Runner.|
|Environments and deployments||Deploy the output of jobs into environments for reviewing, staging, and production.|
|Job artifacts||Learn about the output of jobs.|
|Cache dependencies in GitLab CI/CD||Discover how to speed up pipelines using caching.|
|Using Git submodules with GitLab CI||How to run your CI jobs when using Git submodules.|
|Pipelines for merge requests||Create pipelines specifically for merge requests.|
|Using SSH keys with GitLab CI/CD||Use SSH keys in your build environment.|
|Triggering pipelines through the API||Use the GitLab API to trigger a pipeline.|
|Pipeline schedules||Trigger pipelines on a schedule.|
|Connecting GitLab with a Kubernetes cluster||Integrate one or more Kubernetes clusters to your project.|
|ChatOps||Trigger CI jobs from chat, with results sent back to the channel.|
|Interactive web terminals||Open an interactive web terminal to debug the running jobs.|
|Review Apps||Configure GitLab CI/CD to preview code changes in a per-branch basis.|
|Optimizing GitLab for large repositories||Useful tips on how to optimize GitLab and GitLab Runner for big repositories.|
|Deploy Boards [PREMIUM]||Check the current health and status of each CI/CD environment running on Kubernetes.|
|GitLab CI/CD for external repositories [PREMIUM]||Get the benefits of GitLab CI/CD combined with repositories in GitHub and BitBucket Cloud.|
GitLab provides examples of configuring GitLab CI/CD in the form of:
- A collection of examples and other resources.
- Example projects that are available at the
gitlab-examplesgroup. For example, see:
As a GitLab administrator, you can change the default behavior of GitLab CI/CD for:
Docker is commonly used with GitLab CI/CD. Learn more about how to to accomplish this with the following documentation:
|Using Docker images||Use GitLab and GitLab Runner with Docker to build and test applications.|
|Building Docker images with GitLab CI/CD||Maintain Docker-based projects using GitLab CI/CD.|
Related topics include:
Why GitLab CI/CD?
The following articles explain reasons to use GitLab CI/CD for your CI/CD infrastructure:
See also the Why CI/CD? presentation.
As GitLab CI/CD has evolved, certain breaking changes have been necessary. These are: