gitlab-org--gitlab-foss/doc/ci/README.md

GitLab Continuous Integration

The benefits of Continuous Integration are huge when automation plays an integral part of your workflow. GitLab comes with integrated Continuous Integration (CI) and Continuous Delivery (CD) to test, build and deploy your code.

Here's some info we've gathered to get you started.

Getting started

• Getting started with GitLab CI
• Configure a Runner, the application that runs your jobs
• Pipelines and jobs
• Environments and deployments
• Job artifacts
• Using Docker
  • Use Docker images with GitLab Runner
  • Use CI to build Docker images
  • CI services (linked Docker containers)
• Blog posts
  • Getting started with GitLab and GitLab CI
  • GitLab CI: Run jobs sequentially, in parallel or build a custom pipeline
  • Continuous Integration, Delivery, and Deployment with GitLab
  • CI deployments and environments
• Videos
  • Getting started with CI in GitLab

Reference guides

Once you get familiar with the getting started guides, you'll find yourself digging into specific reference guides.

• .gitlab-ci.yml reference
• The permissions model
  • User permissions
  • Jobs permissions
• CI Variables - Learn how to use variables defined in your .gitlab-ci.yml or secured ones defined in your project's settings

Advanced use

• Git submodules
• Review Apps
• Auto deploy
• Use SSH keys in your build environment
• Trigger jobs through the GitLab API
• Using GitLab CI with GitLab Pages

Special project configuration

• CI/CD pipelines settings
• Learn how to enable or disable GitLab CI

Examples

Note: A collection of .gitlab-ci.yml files is maintained at the GitLab CI Yml project. If your favorite programming language or framework are missing we would love your help by sending a merge request with a .gitlab-ci.yml.

Here is an collection of tutorials and guides on setting up your CI pipeline:

• Languages and frameworks
  • Testing a PHP application
  • Test and deploy a Ruby application to Heroku
  • Test and deploy a Python application to Heroku
  • Test a Clojure application
  • Test a Scala application
  • Test a Phoenix application
  • Run PHP Composer & NPM scripts then deploy them to a staging server
• Blog posts
  • Automated Debian packaging
  • Spring boot application with GitLab CI and Kubernetes
  • Setting up CI for iOS projects
  • Using GitLab CI for iOS projects
  • Setting up GitLab CI for Android projects
  • Building a new GitLab Docs site with Nanoc, GitLab CI, and GitLab Pages
  • CI/CD with GitLab in action
  • Building an Elixir Release into a Docker image using GitLab CI
• Miscellaneous
  • Using dpl as deployment tool
  • Repositories with examples for various languages
  • The .gitlab-ci.yml file for GitLab itself
  • Example project that shows how to use Review Apps

Breaking changes

• CI variables renaming for GitLab 9.0 Read about the deprecated CI variables and what you should use for GitLab 9.0+.
• New CI job permissions model Read about what changed in GitLab 8.12 and how that affects your jobs. There's a new way to access your Git submodules and LFS objects in jobs.