debian-mirror-gitlab/doc/ci
2019-05-18 00:54:41 +05:30
..
autodeploy New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
build_artifacts New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
caching New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
chatops New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
docker New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
environments New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
examples New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
img New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
interactive_web_terminal New upstream version 11.8.0 2019-03-02 22:35:43 +05:30
introduction New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
large_repositories New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
merge_request_pipelines New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
permissions New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
quick_start New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
review_apps New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
runners New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
services New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
ssh_keys New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
triggers New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
variables New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
yaml New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
enable_or_disable_ci.md New upstream version 10.5.5+dfsg 2018-03-17 18:26:18 +05:30
environments.md New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
git_submodules.md New upstream version 11.3.10+dfsg 2018-11-20 20:47:30 +05:30
junit_test_reports.md New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
pipelines.md New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30
README.md New upstream version 11.10.4+dfsg 2019-05-18 00:54:41 +05:30

comments description
false Learn how to use GitLab CI/CD, the GitLab built-in Continuous Integration, Continuous Deployment, and Continuous Delivery toolset to build, test, and deploy your application.

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).

Within the DevOps lifecycle, GitLab CI/CD spans the Verify (CI) and Release (CD) stages.

Overview

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 .gitlab.yml reference.

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.

Usage

With basic knowledge of how GitLab CI/CD works, the following documentation extends your knowledge into more features:

Topic Description
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 Pages

GitLab CI/CD can be used to build and host static websites. For more information, see the documentation on GitLab Pages, or dive right into the CI/CD step-by-step guide for Pages.

Examples

GitLab provides examples of configuring GitLab CI/CD in the form of:

Administration

As a GitLab administrator, you can change the default behavior of GitLab CI/CD for:

See also:

Using Docker

Docker is commonly used with GitLab CI/CD. Learn more about how to to accomplish this with the following documentation:

Topic Description
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.

Breaking changes

As GitLab CI/CD has evolved, certain breaking changes have been necessary. These are: