33a5157ad4
* upstream/master: (149 commits) Revert change to design. Go back to scrollable page Fixes the column widths for the new navigation options in settings Migrate #submodule_url_for to Gitaly Add test example for external commit status retries Fix invalid Rails.logger call in lib/gitlab/health_checks/fs_shards_check.rb Fix build for !12300. Log rescued exceptions to Sentry Fix issues with non-UTF8 filenames by always fixing the encoding of tree and blob paths Revert "Merge branch 'revert-12499' into 'master'" Prevent accidental deletion of protected MR source branch by repeating checks before actual deletion Improve the overall UX for the new monitoring dashboard Document that GitLab 9.3 requires the TRIGGER permission on MySQL Instrument Unicorn with Ruby exporter Remove group modal like remove project modal. Closes #33130 Update prometheus client gem Enables the option in user preferences to turn on the new navigation Add Jasmine tests for `OAuthRememberMe` Simplify authentication logic in the v4 users API for !12445. Use stub_application_setting when testing ApplicationHelper#support_url wait_for_requests is not needed when AJAX is not in play ... |
||
|---|---|---|
| .. | ||
| api | ||
| autodeploy | ||
| build_artifacts | ||
| docker | ||
| examples | ||
| img | ||
| permissions | ||
| quick_start | ||
| review_apps | ||
| runners | ||
| services | ||
| ssh_keys | ||
| triggers | ||
| variables | ||
| yaml | ||
| enable_or_disable_ci.md | ||
| environments.md | ||
| git_submodules.md | ||
| pipelines.md | ||
| README.md | ||
GitLab Continuous Integration (GitLab CI)
The benefits of Continuous Integration are huge when automation plays an integral part of your workflow. GitLab comes with built-in Continuous Integration, Continuous Deployment, and Continuous Delivery support to build, test, and deploy your application.
Here's some info we've gathered to get you started.
Getting started
The first steps towards your GitLab CI journey.
- Getting started with GitLab CI
- Pipelines and jobs
- Configure a Runner, the application that runs your jobs
- Articles:
- Videos:
- Third-party videos:
Reference guides
Once you get familiar with the getting started guides, you'll find yourself digging into specific reference guides.
.gitlab-ci.ymlreference - Learn all about the ins and outs of.gitlab-ci.ymldefinitions- CI Variables - Learn how to use variables defined in
your
.gitlab-ci.ymlor secured ones defined in your project's settings - The permissions model - Learn about the access levels a user can have for performing certain CI actions
GitLab CI + Docker
Leverage the power of Docker to run your CI pipelines.
- Use Docker images with GitLab Runner
- Use CI to build Docker images
- CI services (linked Docker containers)
- Articles:
Advanced use
Once you get familiar with the basics of GitLab CI, it's time to dive in and learn how to leverage its potential even more.
- Environments and deployments - Separate your jobs into environments and use them for different purposes like testing, building and deploying
- Job artifacts
- Git submodules - How to run your CI jobs when Git submodules are involved
- Auto deploy
- Use SSH keys in your build environment
- Trigger pipelines through the GitLab API
- Trigger pipelines on a schedule
Review Apps
GitLab CI for GitLab Pages
See the topic on GitLab Pages.
Special configuration
You can change the default behavior of GitLab CI in your whole GitLab instance as well as in each project.
- Project specific
- Affecting the whole GitLab instance
Examples
Note: A collection of
.gitlab-ci.ymlfiles is maintained at the GitLab CI Yml project. If your favorite programming language or framework is 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.
- GitLab CI examples for the following languages and frameworks:
- Blog posts
- Automated Debian packaging
- Spring boot application with GitLab CI and Kubernetes
- Setting up 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
Integrations
- Articles:
Why GitLab CI?
- Articles:
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.