debian-mirror-gitlab/doc/ci/examples/README.md

126 lines
10 KiB
Markdown
Raw Normal View History

2018-03-17 18:26:18 +05:30
---
comments: false
2019-09-04 21:01:54 +05:30
type: index
2018-03-17 18:26:18 +05:30
---
2015-09-25 12:07:36 +05:30
2018-03-17 18:26:18 +05:30
# GitLab CI/CD Examples
2016-09-29 09:46:39 +05:30
2019-09-04 21:01:54 +05:30
This page contains links to a variety of examples that can help you understand how to
implement [GitLab CI/CD](../README.md) for your specific use case.
2019-07-07 11:18:12 +05:30
Examples are available in several forms. As a collection of:
2019-12-04 20:38:33 +05:30
- `.gitlab-ci.yml` [template files](https://gitlab.com/gitlab-org/gitlab-foss/tree/master/lib/gitlab/ci/templates) maintained in GitLab. When you create a new file via the UI,
2019-12-21 20:55:43 +05:30
GitLab will give you the option to choose one of these templates. This will allow you to start using CI/CD with your project quickly.
2019-07-07 11:18:12 +05:30
If your favorite programming language or framework are missing, we would love your help by sending a merge request with a new `.gitlab-ci.yml` to this project.
2019-12-21 20:55:43 +05:30
- Repositories with [example projects](https://gitlab.com/gitlab-examples) for various languages. You can fork and adjust them to your own needs. Projects include demonstrations of [multi-project pipelines](https://gitlab.com/gitlab-examples/multi-project-pipelines) and using [Review Apps with a static site served by NGINX](https://gitlab.com/gitlab-examples/review-apps-nginx/).
2019-07-07 11:18:12 +05:30
- Examples and [other resources](#other-resources) listed below.
## CI/CD examples
2019-09-04 21:01:54 +05:30
The following table lists examples with step-by-step tutorials that are contained in this section.
| Use case | Resource |
|:----------------------------|:---------------------------------------------------------------------------------------------------------------------------|
2019-12-04 20:38:33 +05:30
| Browser performance testing | [Browser Performance Testing with the Sitespeed.io container](../../user/project/merge_requests/browser_performance_testing.md). |
2019-09-04 21:01:54 +05:30
| Clojure | [Test a Clojure application with GitLab CI/CD](test-clojure-application.md). |
| Deployment with Dpl | [Using `dpl` as deployment tool](deployment/README.md). |
| Elixir | [Testing a Phoenix application with GitLab CI/CD](test_phoenix_app_with_gitlab_ci_cd/index.md). |
| End-to-end testing | [End-to-end testing with GitLab CI/CD and WebdriverIO](end_to_end_testing_webdriverio/index.md). |
| Game development | [DevOps and Game Dev with GitLab CI/CD](devops_and_game_dev_with_gitlab_ci_cd/index.md). |
| GitLab Pages | See the [GitLab Pages](../../user/project/pages/index.md) documentation for a complete example of deploying a static site. |
| Java with Spring Boot | [Deploy a Spring Boot application to Cloud Foundry with GitLab CI/CD](deploy_spring_boot_to_cloud_foundry/index.md). |
| Java with Maven | [How to deploy Maven projects to Artifactory with GitLab CI/CD](artifactory_and_gitlab/index.md). |
| PHP with PHPunit, atoum | [Testing PHP projects](php.md). |
| PHP with NPM, SCP | [Running Composer and NPM scripts with deployment via SCP in GitLab CI/CD](deployment/composer-npm-deploy.md). |
2019-10-12 21:52:04 +05:30
| PHP with Laravel, Envoy | [Test and deploy Laravel applications with GitLab CI/CD and Envoy](laravel_with_gitlab_and_envoy/index.md). |
2019-09-04 21:01:54 +05:30
| Python on Heroku | [Test and deploy a Python application with GitLab CI/CD](test-and-deploy-python-application-to-heroku.md). |
| Ruby on Heroku | [Test and deploy a Ruby application with GitLab CI/CD](test-and-deploy-ruby-application-to-heroku.md). |
| Scala on Heroku | [Test and deploy a Scala application to Heroku](test-scala-application.md). |
2019-09-30 21:07:59 +05:30
| Parallel testing Ruby & JS | [GitLab CI parallel jobs testing for Ruby & JavaScript projects](https://docs.knapsackpro.com/2019/how-to-run-parallel-jobs-for-rspec-tests-on-gitlab-ci-pipeline-and-speed-up-ruby-javascript-testing). |
2019-07-07 11:18:12 +05:30
### Contributing examples
Contributions are welcome! You can help your favorite programming
language users and GitLab by sending a merge request with a guide for that language.
2019-09-30 21:07:59 +05:30
You may want to apply for the [GitLab Community Writers Program](https://about.gitlab.com/community/writers/)
2019-07-07 11:18:12 +05:30
to get paid for writing complete articles for GitLab.
2018-05-09 12:01:36 +05:30
2019-09-30 21:07:59 +05:30
## Adding templates to your GitLab installation **(PREMIUM ONLY)**
2018-05-09 12:01:36 +05:30
2019-09-04 21:01:54 +05:30
If you want to have customized examples and templates for your own self-managed GitLab instance available to your team, your GitLab administrator can [designate an instance template repository](../../user/admin_area/settings/instance_template_repository.md) that contains examples and templates specific to your enterprise.
2018-05-09 12:01:36 +05:30
2019-07-07 11:18:12 +05:30
## Other resources
2018-05-09 12:01:36 +05:30
2019-09-04 21:01:54 +05:30
This section provides further resources to help you get familiar with various uses of GitLab CI/CD.
Note that older articles and videos may not reflect the state of the latest GitLab release.
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
### CI/CD in the cloud
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
For examples of setting up GitLab CI/CD for cloud-based environments, see:
2017-08-17 22:00:37 +05:30
2019-12-21 20:55:43 +05:30
- [How to set up multi-account AWS SAM deployments with GitLab CI](https://about.gitlab.com/blog/2019/02/04/multi-account-aws-sam-deployments-with-gitlab-ci/)
2019-09-04 21:01:54 +05:30
- [Automating Kubernetes Deployments with GitLab CI/CD](https://www.youtube.com/watch?v=wEDRfAz6_Uw)
2019-12-21 20:55:43 +05:30
- [How to autoscale continuous deployment with GitLab Runner on DigitalOcean](https://about.gitlab.com/blog/2018/06/19/autoscale-continuous-deployment-gitlab-runner-digital-ocean/)
- [How to create a CI/CD pipeline with Auto Deploy to Kubernetes using GitLab and Helm](https://about.gitlab.com/blog/2017/09/21/how-to-create-ci-cd-pipeline-with-autodeploy-to-kubernetes-using-gitlab-and-helm/)
2019-09-04 21:01:54 +05:30
- [Demo - Deploying from GitLab to OpenShift Container Cluster](https://youtu.be/EwbhA53Jpp4)
See also the following video overviews:
- [Containers, Schedulers, and GitLab CI](https://www.youtube.com/watch?v=d-9awBxEbvQ).
- [Deploying to IBM Cloud with GitLab CI/CD](https://www.youtube.com/watch?v=6ZF4vgKMd-g).
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
### Customer stories
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
For some customer experiences with GitLab CI/CD, see:
2017-08-17 22:00:37 +05:30
2019-12-21 20:55:43 +05:30
- [How Verizon Connect reduced datacenter deploys from 30 days to under 8 hours with GitLab](https://about.gitlab.com/blog/2019/02/14/verizon-customer-story/)
- [How Wag! cut their release process from 40 minutes to just 6](https://about.gitlab.com/blog/2019/01/16/wag-labs-blog-post/)
- [How Jaguar Land Rover embraced CI to speed up their software lifecycle](https://about.gitlab.com/blog/2018/07/23/chris-hill-devops-enterprise-summit-talk/)
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
### Getting started
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
For some examples to help get you started, see:
2017-08-17 22:00:37 +05:30
2019-12-21 20:55:43 +05:30
- [GitLab CI/CD's 2018 highlights](https://about.gitlab.com/blog/2019/01/21/gitlab-ci-cd-features-improvements/)
- [A beginner's guide to continuous integration](https://about.gitlab.com/blog/2018/01/22/a-beginners-guide-to-continuous-integration/)
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
### Implementing GitLab CI/CD
2019-05-30 16:15:17 +05:30
2019-07-07 11:18:12 +05:30
For examples of others who have implemented GitLab CI/CD, see:
2019-05-30 16:15:17 +05:30
2019-12-21 20:55:43 +05:30
- [How to streamline interactions between multiple repositories with multi-project pipelines](https://about.gitlab.com/blog/2018/10/31/use-multiproject-pipelines-with-gitlab-cicd/)
- [How we used GitLab CI to build GitLab faster](https://about.gitlab.com/blog/2018/05/02/using-gitlab-ci-to-build-gitlab-faster/)
- [Test all the things in GitLab CI with Docker by example](https://about.gitlab.com/blog/2018/02/05/test-all-the-things-gitlab-ci-docker-examples/)
- [A Craftsman looks at continuous integration](https://about.gitlab.com/blog/2018/01/17/craftsman-looks-at-continuous-integration/)
- [Go tools and GitLab: How to do continuous integration like a boss](https://about.gitlab.com/blog/2017/11/27/go-tools-and-gitlab-how-to-do-continuous-integration-like-a-boss/)
- [GitBot automating boring Git operations with CI](https://about.gitlab.com/blog/2017/11/02/automating-boring-git-operations-gitlab-ci/)
- [How to use GitLab CI for Vue.js](https://about.gitlab.com/blog/2017/09/12/vuejs-app-gitlab/)
2019-07-07 11:18:12 +05:30
- Video: [GitLab CI/CD Deep Dive](https://youtu.be/pBe4t1CD8Fc?t=195)
2019-12-21 20:55:43 +05:30
- [Dockerizing GitLab Review Apps](https://about.gitlab.com/blog/2017/07/11/dockerizing-review-apps/)
- [Fast and natural continuous integration with GitLab CI](https://about.gitlab.com/blog/2017/05/22/fast-and-natural-continuous-integration-with-gitlab-ci/)
- [Demo: CI/CD with GitLab in action](https://about.gitlab.com/blog/2017/03/13/ci-cd-demo/)
2019-05-18 00:54:41 +05:30
2019-09-04 21:01:54 +05:30
### Migrating to GitLab from third-party CI tools
- [Migrating from Jenkins to GitLab](https://youtu.be/RlEVGOpYF5Y)
2019-07-07 11:18:12 +05:30
### Integrating GitLab CI/CD with other systems
2019-05-30 16:15:17 +05:30
2019-07-07 11:18:12 +05:30
To see how you can integrate GitLab CI/CD with third-party systems, see:
2019-05-30 16:15:17 +05:30
2019-12-21 20:55:43 +05:30
- [Streamline and shorten error remediation with Sentrys new GitLab integration](https://about.gitlab.com/blog/2019/01/25/sentry-integration-blog-post/)
- [How to simplify your smart home configuration with GitLab CI/CD](https://about.gitlab.com/blog/2018/08/02/using-the-gitlab-ci-slash-cd-for-smart-home-configuration-management/)
- [Demo: GitLab + Jira + Jenkins](https://about.gitlab.com/blog/2018/07/30/gitlab-workflow-with-jira-jenkins/)
- [Introducing Auto Breakfast from GitLab (sort of)](https://about.gitlab.com/blog/2018/06/29/introducing-auto-breakfast-from-gitlab/)
2019-05-30 16:15:17 +05:30
2019-07-07 11:18:12 +05:30
### Mobile development
For help with using GitLab CI/CD for mobile application development, see:
2016-09-29 09:46:39 +05:30
2019-12-21 20:55:43 +05:30
- [How to publish Android apps to the Google Play Store with GitLab and fastlane](https://about.gitlab.com/blog/2019/01/28/android-publishing-with-gitlab-and-fastlane/)
- [Setting up GitLab CI for Android projects](https://about.gitlab.com/blog/2018/10/24/setting-up-gitlab-ci-for-android-projects/)
- [Working with YAML in GitLab CI from the Android perspective](https://about.gitlab.com/blog/2017/11/20/working-with-yaml-gitlab-ci-android/)
- [How to use GitLab CI and MacStadium to build your macOS or iOS projects](https://about.gitlab.com/blog/2017/05/15/how-to-use-macstadium-and-gitlab-ci-to-build-your-macos-or-ios-projects/)
- [Setting up GitLab CI for iOS projects](https://about.gitlab.com/blog/2016/03/10/setting-up-gitlab-ci-for-ios-projects/)