2016-12-23 10:08:09 +00:00
|
|
|
# Auto deploy
|
2016-12-21 15:21:55 +00:00
|
|
|
|
2017-01-31 04:38:54 +00:00
|
|
|
> [Introduced][mr-8135] in GitLab 8.15. Currently requires a [Public project][project-settings].
|
2016-12-21 15:21:55 +00:00
|
|
|
|
2016-12-23 10:08:09 +00:00
|
|
|
Auto deploy is an easy way to configure GitLab CI for the deployment of your
|
2016-12-21 15:21:55 +00:00
|
|
|
application. GitLab Community maintains a list of `.gitlab-ci.yml`
|
|
|
|
|
templates for various infrastructure providers and deployment scripts
|
|
|
|
|
powering them. These scripts are responsible for packaging your application,
|
|
|
|
|
setting up the infrastructure and spinning up necessary services (for
|
|
|
|
|
example a database).
|
|
|
|
|
|
|
|
|
|
You can use [project services][project-services] to store credentials to
|
|
|
|
|
your infrastructure provider and they will be available during the
|
|
|
|
|
deployment.
|
|
|
|
|
|
|
|
|
|
## Supported templates
|
|
|
|
|
|
2016-12-23 10:08:09 +00:00
|
|
|
The list of supported auto deploy templates is available [here][auto-deploy-templates].
|
2016-12-21 15:21:55 +00:00
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
|
|
1. Enable a deployment [project service][project-services] to store your
|
2016-12-21 23:23:26 +00:00
|
|
|
credentials. For example, if you want to deploy to OpenShift you have to
|
|
|
|
|
enable [Kubernetes service][kubernetes-service].
|
|
|
|
|
1. Configure GitLab Runner to use Docker or Kubernetes executor with
|
|
|
|
|
[privileged mode enabled][docker-in-docker].
|
2016-12-23 10:08:09 +00:00
|
|
|
1. Navigate to the "Project" tab and click "Set up auto deploy" button.
|
|
|
|
|
|
2016-12-21 15:21:55 +00:00
|
|
|
1. Select a template.
|
2016-12-23 10:08:09 +00:00
|
|
|
|
2016-12-21 15:21:55 +00:00
|
|
|
1. Commit your changes and create a merge request.
|
|
|
|
|
1. Test your deployment configuration using a [Review App][review-app] that was
|
|
|
|
|
created automatically for you.
|
|
|
|
|
|
|
|
|
|
[mr-8135]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/8135
|
2017-01-31 04:41:43 +00:00
|
|
|
[project-settings]: https://docs.gitlab.com/ce/public_access/public_access.html
|
2016-12-21 15:21:55 +00:00
|
|
|
[project-services]: ../../project_services/project_services.md
|
2016-12-23 10:08:09 +00:00
|
|
|
[auto-deploy-templates]: https://gitlab.com/gitlab-org/gitlab-ci-yml/tree/master/autodeploy
|
2016-12-21 15:21:55 +00:00
|
|
|
[kubernetes-service]: ../../project_services/kubernetes.md
|
|
|
|
|
[docker-in-docker]: ../docker/using_docker_build.md#use-docker-in-docker-executor
|
|
|
|
|
[review-app]: ../review_apps/index.md
|
