` does not exist until 4.9](https://gcc.gnu.org/bugzilla/show_bug.cgi?id=53631)).
To upgrade GCC to a more recent version, you will have to install the appropriate version from the `ubuntu-toolchain-r-test` source; see below for examples:
@@ -62,39 +65,29 @@ before_install:
```
{: data-file=".travis.yml"}
-### GCC on OS X
+### GCC on FreeBSD
-```yaml
-matrix:
- include:
- - os: osx
- osx_image: xcode8
- env:
- - MATRIX_EVAL="CC=gcc-4.9 && CXX=g++-4.9"
-
- - os: osx
- osx_image: xcode8
- env:
- - MATRIX_EVAL="brew install gcc5 && CC=gcc-5 && CXX=g++-5"
+Travis CI FreeBSD image ships with GCC 10.0.0 (it's not in the base system by default).
- - os: osx
- osx_image: xcode8
- env:
- - MATRIX_EVAL="brew install gcc6 && CC=gcc-6 && CXX=g++-6"
-
- - os: osx
- osx_image: xcode8
- env:
- - MATRIX_EVAL="brew install gcc && CC=gcc-7 && CXX=g++-7"
+To upgrade GCC to a more recent version, install the appropriate version from packages; see below for examples:
-before_install:
- - eval "${MATRIX_EVAL}"
+```yaml
+os: freebsd
+addons:
+ pkg:
+ - gcc10
+ env:
+ - CC=gcc10
+ - CXX=g++10
```
{: data-file=".travis.yml"}
-### Clang
+### Clang on Linux
-Ubuntu 12.04 ships with Clang 3.4 and Ubuntu 14.04 ships with Clang 3.5.0.
+* [Precise](/user/reference/precise/) ships with Clang 3.4
+* [Trusty](/user/reference/trusty/) ships with Clang 3.5.0
+* [Xenial](/user/reference/xenial/) ships with Clang 7
+* [Bionic](/user/reference/bionic/) ships with Clang 7
Note that [C++11 support is complete starting from Clang 3.3](http://clang.llvm.org/cxx_status.html).
@@ -177,11 +170,35 @@ before_install:
```
{: data-file=".travis.yml"}
-On OS X, the version of `clang` is controlled by the choice of `osx_image`.
+
+### Clang on FreeBSD
+
+> Clang is the default compiler on FreeBSD
+
+FreeBSD ships with Clang 8.0.1
+
+To upgrade Clang to a more recent version, install the appropriate version from packages; see below for examples:
+
+```yaml
+os: freebsd
+addons:
+ pkg:
+ - llvm90
+ env:
+ - CC=/usr/local/bin/clang90 # llvm90 installs it to /usr/local/bin/clang90
+ - CXX=/usr/local/bin/clang++90 # llvm90 installs it to /usr/local/bin/clang++90
+```
+{: data-file=".travis.yml"}
+
+> Clang is the default compiler on FreeBSD
#### CMake
-Ubuntu 12.04 ships with cmake 2.8.7 and Ubuntu 14.04 ships with cmake 3.2.2.
+* [Precise](/user/reference/precise/) ships with CMake 2.8.7
+* [Trusty](/user/reference/trusty/) ships with CMake 3.9.2
+* [Xenial](/user/reference/xenial/) ships with CMake 3.12.4
+* [Bionic](/user/reference/bionic/) ships with CMake 3.12.4
+* [FreeBSD](/user/reference/freebsd/) ships with CMake 3.15.5
You can upgrade cmake to 3.2.3 on Precise from the `george-edison55-precise-backports` source (note that the `cmake-data` package contains dependencies which Aptitude does not automatically resolve), c.f.
@@ -196,4 +213,4 @@ addons:
```
{: data-file=".travis.yml"}
-On OS X, the version of `cmake` is controlled by the choice of `osx_image`.
+
diff --git a/_includes/conditional_deploy.html b/_includes/conditional_deploy.html
index d46b10efb30..4d04164840a 100644
--- a/_includes/conditional_deploy.html
+++ b/_includes/conditional_deploy.html
@@ -1,4 +1,4 @@
-Conditional Deploys
+Conditional Deploys
It is possible to make deployments conditional using the on option:
@@ -40,5 +40,3 @@ Conditional Deploys
ruby - Ruby version to deploy from if passing
repo - only trigger a build for the given repository, to play nice with forks
-
-
diff --git a/_includes/deploy/before_after_deploy.md b/_includes/deploy/before_after_deploy.md
new file mode 100644
index 00000000000..907b6728750
--- /dev/null
+++ b/_includes/deploy/before_after_deploy.md
@@ -0,0 +1,18 @@
+## Running commands before and after the deploy step
+
+Sometimes you want to run commands before or after deploying.
+
+You can use the `before_deploy` and `after_deploy` steps for this.
+
+> Please note: These will
+only be triggered if Travis CI is actually deploying.
+
+```yaml
+before_deploy: "echo ready?"
+deploy:
+ # ⋮
+after_deploy:
+ - ./after_deploy_1.sh
+ - ./after_deploy_2.sh
+```
+{: data-file=".travis.yml"}
diff --git a/_includes/deploy/cleanup.md b/_includes/deploy/cleanup.md
new file mode 100644
index 00000000000..81aa20c4f29
--- /dev/null
+++ b/_includes/deploy/cleanup.md
@@ -0,0 +1,23 @@
+## Cleaning up the Git Working Directory
+
+By default your Git working directory will not be cleaned up before the deploy
+step, so it might contain left over artifacts from previous steps.
+
+For many providers and deployment targets this is not an issue or even intended.
+
+If you do need to clean up the working directory from any changes made during
+the build process, you can add the following to your `.travis.yml` file:
+
+```yaml
+deploy:
+ provider: {{ page.provider | default: '[your provider]' }}
+ cleanup: true
+```
+{: data-file=".travis.yml"}
+
+> Please note that the previous version of dpl, our deployment integration
+tooling, used to reset your working directory and delete all changes made
+during the build using `git stash --all`. In order to keep changes one had to
+opt out using `skip_cleanup: true`. This default turned out to be useful only
+for very few providers and has been changed in dpl v2. You still might find
+external tutorials or posts mentioning `skip_cleanup`.
diff --git a/_includes/deploy/conditional.md b/_includes/deploy/conditional.md
new file mode 100644
index 00000000000..5f2bbb18ca8
--- /dev/null
+++ b/_includes/deploy/conditional.md
@@ -0,0 +1,5 @@
+## Conditional Deploys
+
+You can deploy only when certain conditions are met.
+
+See [Conditional Deployments](/user/deployment-v2/conditional).
diff --git a/_includes/deploy/edge.md b/_includes/deploy/edge.md
new file mode 100644
index 00000000000..1f3836a7e20
--- /dev/null
+++ b/_includes/deploy/edge.md
@@ -0,0 +1,14 @@
+## Running an edge version
+
+If you contribute to or experiment with [dpl](https://github.com/travis-ci/dpl), our deployment tooling, make sure you use the edge version from GitHub:
+
+```yaml
+deploy:
+ provider:
+ edge:
+ branch: master
+ source: /dpl # only needed for forks of travis-ci/dpl
+```
+{: data-file=".travis.yml"}
+
+You can find more information about contributing to dpl [here](https://github.com/travis-ci/dpl#contributing-to-dpl).
diff --git a/_includes/deploy/maturity_levels.md b/_includes/deploy/maturity_levels.md
new file mode 100644
index 00000000000..208a8114dfb
--- /dev/null
+++ b/_includes/deploy/maturity_levels.md
@@ -0,0 +1,16 @@
+## Maturity Levels
+
+In order to communicate the current development status and maturity of dpl's
+support for a particular service, the respective provider is marked with one of
+the following maturity levels, according to the given criteria:
+
+* `dev` - the provider is in development (initial level)
+* `alpha` - the provider is fully tested
+* `beta` - the provider has been in alpha for at least a month and successful real-world production deployments have been observed
+* `stable` - the provider has been in beta for at least two months and there are no open issues that qualify as critical (such as deployments failing, documented functionality broken, etc.)
+
+> Dpl v2 represents a major rewrite, so support for all providers has been
+reset to `dev` or `alpha`, depending on the test status.
+
+For all levels except `stable` a message will be printed to your build log
+that informs you about the current status.
diff --git a/_includes/deploy/multiple_targets.md b/_includes/deploy/multiple_targets.md
new file mode 100644
index 00000000000..a9f61326a80
--- /dev/null
+++ b/_includes/deploy/multiple_targets.md
@@ -0,0 +1,19 @@
+## Deploying to multiple targets
+
+Running multiple deployments to different providers (or the same provider with
+different configurations) is possible by adding configurations to the `deploy`
+section as a list. For example, if you want to deploy to both s3 and Heroku,
+your `deploy` section would look something like this:
+
+```yaml
+deploy:
+ - provider: s3
+ access_key_id:
+ secret_access_key:
+ # ⋮
+ - provider: heroku
+ api_key:
+ # ⋮
+```
+{: data-file=".travis.yml"}
+
diff --git a/_includes/deploy/opt_in.md b/_includes/deploy/opt_in.md
new file mode 100644
index 00000000000..acfecf12730
--- /dev/null
+++ b/_includes/deploy/opt_in.md
@@ -0,0 +1,30 @@
+## How to opt in to different deployment tooling versions
+
+In order to use different version of our deployment tooling, please add the
+following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider:
+ # ⋮
+ dpl_version: # Optional, defaults to the latest stable version
+```
+if you want to use the latest edge version of the deployment tooling:
+
+```yaml
+deploy:
+ provider:
+ # ⋮
+ edge: true
+```
+if you want to use other edge version of the deployment tooling:
+
+```yaml
+deploy:
+ provider:
+ # ⋮
+ dpl_version:
+ edge: true
+```
+
+{: data-file=".travis.yml"}
diff --git a/_includes/deploy/providers/anynines.md b/_includes/deploy/providers/anynines.md
new file mode 100644
index 00000000000..abd299f3265
--- /dev/null
+++ b/_includes/deploy/providers/anynines.md
@@ -0,0 +1,46 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: anynines
+ username:
+ password:
+ organization:
+ space:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Anynines is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | anynines username — **required**, type: string |
+| `password` | anynines password — **required**, **secret**, type: string |
+| `organization` | anynines organization — **required**, type: string |
+| `space` | anynines space — **required**, type: string |
+| `app_name` | Application name — type: string |
+| `buildpack` | Buildpack name or Git URL — type: string |
+| `manifest` | Path to the manifest — type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `ANYNINES_`.
+
+For example, `password` can be given as `ANYNINES_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="ANYNINES_PASSWORD" %}
diff --git a/_includes/deploy/providers/azure_web_apps.md b/_includes/deploy/providers/azure_web_apps.md
new file mode 100644
index 00000000000..f5ab01c4f1c
--- /dev/null
+++ b/_includes/deploy/providers/azure_web_apps.md
@@ -0,0 +1,43 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: azure_web_apps
+ username:
+ password:
+ site:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Azure Web Apps is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | Web App Deployment Username — **required**, type: string |
+| `password` | Web App Deployment Password — **required**, **secret**, type: string |
+| `site` | Web App name (e.g. myapp in myapp.azurewebsites.net) — **required**, type: string |
+| `slot` | Slot name (if your app uses staging deployment) — type: string |
+| `verbose` | Print deployment output from Azure. Warning: If authentication fails, Git prints credentials in clear text. Correct credentials remain hidden. — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `AZURE_WA_`.
+
+For example, `password` can be given as `AZURE_WA_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="AZURE_WA_PASSWORD" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/bintray.md b/_includes/deploy/providers/bintray.md
new file mode 100644
index 00000000000..995dc7e00ee
--- /dev/null
+++ b/_includes/deploy/providers/bintray.md
@@ -0,0 +1,42 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: bintray
+ user:
+ key:
+ file:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Bintray is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `user` | Bintray user — **required**, type: string |
+| `key` | Bintray API key — **required**, **secret**, type: string |
+| `file` | Path to a descriptor file for the Bintray upload — **required**, type: string |
+| `passphrase` | Passphrase as configured on Bintray (if GPG signing is used) — type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `BINTRAY_`.
+
+For example, `key` can be given as `BINTRAY_KEY=`.
+
+{% include deploy/secrets.md name="key" env_name="BINTRAY_KEY" %}
diff --git a/_includes/deploy/providers/bluemixcloudfoundry.md b/_includes/deploy/providers/bluemixcloudfoundry.md
new file mode 100644
index 00000000000..3169a66aa56
--- /dev/null
+++ b/_includes/deploy/providers/bluemixcloudfoundry.md
@@ -0,0 +1,49 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: bluemixcloudfoundry
+ username:
+ password:
+ organization:
+ space:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Bluemix Cloud Foundry is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | Bluemix username — **required**, type: string |
+| `password` | Bluemix password — **required**, **secret**, type: string |
+| `organization` | Bluemix organization — **required**, type: string |
+| `space` | Bluemix space — **required**, type: string |
+| `region` | Bluemix region — type: string, default: `ng`, known values: `ng`, `eu-gb`, `eu-de`, `au-syd` |
+| `api` | Bluemix api URL — type: string |
+| `app_name` | Application name — type: string |
+| `buildpack` | Buildpack name or Git URL — type: string |
+| `manifest` | Path to the manifest — type: string |
+| `skip_ssl_validation` | Skip SSL validation — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `CLOUDFOUNDRY_`.
+
+For example, `password` can be given as `CLOUDFOUNDRY_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="CLOUDFOUNDRY_PASSWORD" %}
diff --git a/_includes/deploy/providers/boxfuse.md b/_includes/deploy/providers/boxfuse.md
new file mode 100644
index 00000000000..98779acb3ec
--- /dev/null
+++ b/_includes/deploy/providers/boxfuse.md
@@ -0,0 +1,45 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: boxfuse
+ user:
+ secret:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Boxfuse is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `user` | **required**, type: string |
+| `secret` | **required**, **secret**, type: string |
+| `payload` | type: string |
+| `app` | type: string |
+| `version` | type: string |
+| `env` | type: string |
+| `config_file` | type: string, alias: `configfile` (deprecated, please use `config_file`) |
+| `extra_args` | type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `BOXFUSE_`.
+
+For example, `secret` can be given as `BOXFUSE_SECRET=`.
+
+{% include deploy/secrets.md name="secret" env_name="BOXFUSE_SECRET" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/cargo.md b/_includes/deploy/providers/cargo.md
new file mode 100644
index 00000000000..d3809add71f
--- /dev/null
+++ b/_includes/deploy/providers/cargo.md
@@ -0,0 +1,38 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: cargo
+ token:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Cargo is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `token` | Cargo registry API token — **required**, **secret**, type: string |
+| `allow_dirty` | Allow publishing from a dirty git working directory — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `CARGO_`.
+
+For example, `token` can be given as `CARGO_TOKEN=`.
+
+{% include deploy/secrets.md name="token" env_name="CARGO_TOKEN" %}
diff --git a/_includes/deploy/providers/chef_supermarket.md b/_includes/deploy/providers/chef_supermarket.md
new file mode 100644
index 00000000000..f0d3051e96f
--- /dev/null
+++ b/_includes/deploy/providers/chef_supermarket.md
@@ -0,0 +1,36 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: chef_supermarket
+ user_id:
+ category:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Chef Supermarket is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `user_id` | Chef Supermarket user name — **required**, type: string |
+| `name` | Cookbook name — type: string, alias: `cookbook_name` (deprecated, please use `name`), note: defaults to the name given in metadata.json or metadata.rb |
+| `category` | Cookbook category in Supermarket — **required**, type: string, alias: `cookbook_category` (deprecated, please use `category`), see: [https://docs.getchef.com/knife_cookbook_site.html#id12](https://docs.getchef.com/knife_cookbook_site.html#id12) |
+| `client_key` | Client API key file name — type: string, default: `client.pem` |
+| `dir` | Directory containing the cookbook — type: string, default: `.` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+
diff --git a/_includes/deploy/providers/cloud66.md b/_includes/deploy/providers/cloud66.md
new file mode 100644
index 00000000000..8cdd9ec964c
--- /dev/null
+++ b/_includes/deploy/providers/cloud66.md
@@ -0,0 +1,37 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: cloud66
+ redeployment_hook:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Cloud66 is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `redeployment_hook` | The redeployment hook URL — **required**, **secret**, type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `CLOUD66_`.
+
+For example, `redeployment_hook` can be given as `CLOUD66_REDEPLOYMENT_HOOK=`.
+
+{% include deploy/secrets.md name="redeployment_hook" env_name="CLOUD66_REDEPLOYMENT_HOOK" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/cloudfiles.md b/_includes/deploy/providers/cloudfiles.md
new file mode 100644
index 00000000000..0ae34b1bb1f
--- /dev/null
+++ b/_includes/deploy/providers/cloudfiles.md
@@ -0,0 +1,45 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: cloudfiles
+ username:
+ api_key:
+ region:
+ container:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Cloud Files is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | Rackspace username — **required**, type: string |
+| `api_key` | Rackspace API key — **required**, **secret**, type: string |
+| `region` | Cloudfiles region — **required**, type: string, known values: `ord`, `dfw`, `syd`, `iad`, `hkg` |
+| `container` | Name of the container that files will be uploaded to — **required**, type: string |
+| `glob` | Paths to upload — type: string, default: `**/*` |
+| `dot_match` | Upload hidden files starting a dot — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `CLOUDFILES_`.
+
+For example, `api_key` can be given as `CLOUDFILES_API_KEY=`.
+
+{% include deploy/secrets.md name="api_key" env_name="CLOUDFILES_API_KEY" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/cloudformation.md b/_includes/deploy/providers/cloudformation.md
new file mode 100644
index 00000000000..0d965061622
--- /dev/null
+++ b/_includes/deploy/providers/cloudformation.md
@@ -0,0 +1,57 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: cloudformation
+ access_key_id:
+ secret_access_key:
+ template:
+ stack_name:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to AWS CloudFormation is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `access_key_id` | AWS Access Key ID — **required**, **secret**, type: string |
+| `secret_access_key` | AWS Secret Key — **required**, **secret**, type: string |
+| `region` | AWS Region to deploy to — type: string, default: `us-east-1` |
+| `template` | CloudFormation template file — **required**, type: string, note: can be either a local path or an S3 URL |
+| `stack_name` | CloudFormation Stack Name. — **required**, type: string |
+| `stack_name_prefix` | CloudFormation Stack Name Prefix. — type: string |
+| `promote` | Deploy changes — type: boolean, default: `true`, note: otherwise a change set is created |
+| `role_arn` | AWS Role ARN — type: string |
+| `sts_assume_role` | AWS Role ARN for cross account deployments (assumed by travis using given AWS credentials). — type: string |
+| `capabilities` | CloudFormation allowed capabilities — type: string or array of strings, known values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, `CAPABILITY_AUTO_EXPAND`, see: [https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html) |
+| `wait` | Wait for CloutFormation to finish the stack creation and update — type: boolean, default: `true` |
+| `wait_timeout` | How many seconds to wait for stack creation and update. — type: integer, default: `3600` |
+| `create_timeout` | How many seconds to wait before the stack status becomes CREATE_FAILED — type: integer, default: `3600`, note: valid only when creating a stack |
+| `parameters` | key=value pairs or ENV var names — type: string or array of strings |
+| `output_file` | Path to output file to store CloudFormation outputs to — type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `AWS_` or `CLOUDFORMATION_`.
+
+For example, `access_key_id` can be given as
+
+* `AWS_ACCESS_KEY_ID=` or
+* `CLOUDFORMATION_ACCESS_KEY_ID=`
+
+{% include deploy/secrets.md name="access_key_id" env_name="AWS_ACCESS_KEY_ID" %}
diff --git a/_includes/deploy/providers/cloudfoundry.md b/_includes/deploy/providers/cloudfoundry.md
new file mode 100644
index 00000000000..02f962189b4
--- /dev/null
+++ b/_includes/deploy/providers/cloudfoundry.md
@@ -0,0 +1,50 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: cloudfoundry
+ username:
+ password:
+ organization:
+ space:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Cloud Foundry is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | Cloud Foundry username — **required**, type: string |
+| `password` | Cloud Foundry password — **required**, **secret**, type: string |
+| `organization` | Cloud Foundry organization — **required**, type: string |
+| `space` | Cloud Foundry space — **required**, type: string |
+| `api` | Cloud Foundry api URL — type: string, default: `https://api.run.pivotal.io` |
+| `app_name` | Application name — type: string |
+| `buildpack` | Buildpack name or Git URL — type: string |
+| `manifest` | Path to the manifest — type: string |
+| `skip_ssl_validation` | Skip SSL validation — type: boolean |
+| `deployment_strategy` | Deployment strategy, either rolling or null — type: string |
+| `v3` | Use the v3 API version to push the application — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `CLOUDFOUNDRY_`.
+
+For example, `password` can be given as `CLOUDFOUNDRY_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="CLOUDFOUNDRY_PASSWORD" %}
diff --git a/_includes/deploy/providers/codedeploy.md b/_includes/deploy/providers/codedeploy.md
new file mode 100644
index 00000000000..2fbcdb82256
--- /dev/null
+++ b/_includes/deploy/providers/codedeploy.md
@@ -0,0 +1,89 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: codedeploy
+ access_key_id:
+ secret_access_key:
+ application:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to AWS Code Deploy is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `access_key_id` | AWS access key — **required**, **secret**, type: string |
+| `secret_access_key` | AWS secret access key — **required**, **secret**, type: string |
+| `application` | CodeDeploy application name — **required**, type: string |
+| `deployment_group` | CodeDeploy deployment group name — type: string |
+| `revision_type` | CodeDeploy revision type — type: string, known values: `s3`, `github`, downcase: true |
+| `commit_id` | Commit ID in case of GitHub — type: string |
+| `repository` | Repository name in case of GitHub — type: string |
+| `bucket` | S3 bucket in case of S3 — type: string |
+| `region` | AWS availability zone — type: string, default: `us-east-1` |
+| `file_exists_behavior` | How to handle files that already exist in a deployment target location — type: string, default: `disallow`, known values: `disallow`, `overwrite`, `retain` |
+| `wait_until_deployed` | Wait until the deployment has finished — type: boolean |
+| `bundle_type` | Bundle type of the revision — type: string |
+| `key` | S3 bucket key of the revision — type: string |
+| `description` | Description of the revision — type: string |
+| `endpoint` | S3 endpoint url — type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `AWS_` or `CODEDEPLOY_`.
+
+For example, `access_key_id` can be given as
+
+* `AWS_ACCESS_KEY_ID=` or
+* `CODEDEPLOY_ACCESS_KEY_ID=`
+## Interpolation variables
+
+The following variables are available for interpolation on `description`:
+
+* `application`
+* `bucket`
+* `bundle_type`
+* `commit_id`
+* `deployment_group`
+* `endpoint`
+* `file_exists_behavior`
+* `git_author_email`
+* `git_author_name`
+* `git_branch`
+* `git_commit_author`
+* `git_commit_msg`
+* `git_sha`
+* `git_tag`
+* `key`
+* `region`
+* `repository`
+* `revision_type`
+* `build_number`
+
+Interpolation uses the syntax `%{variable-name}`. For example,
+`"Current commit sha: %{git_sha}"` would result in a string with the
+current Git sha embedded.
+
+Furthermore, environment variables present in the current build
+environment can be used through standard Bash variable interpolation.
+For example: "Current build number: ${TRAVIS_BUILD_NUMBER}".
+See [here](/user/environment-variables/#default-environment-variables)
+for a list of default environment variables set.
+
+{% include deploy/secrets.md name="access_key_id" env_name="AWS_ACCESS_KEY_ID" %}
diff --git a/_includes/deploy/providers/convox.md b/_includes/deploy/providers/convox.md
new file mode 100644
index 00000000000..0a973f9be63
--- /dev/null
+++ b/_includes/deploy/providers/convox.md
@@ -0,0 +1,46 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: convox
+ app:
+ rack:
+ password:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Convox is in **development**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `host` | type: string, default: `console.convox.com` |
+| `app` | **required**, type: string |
+| `rack` | **required**, type: string |
+| `password` | **required**, type: string |
+| `install_url` | type: string, default: `https://convox.com/cli/linux/convox` |
+| `update_cli` | type: boolean |
+| `create` | type: boolean |
+| `promote` | type: boolean, default: `true` |
+| `env_names` | type: string or array of strings |
+| `env` | type: string or array of strings |
+| `env_file` | type: string |
+| `description` | type: string |
+| `generation` | type: integer, default: `2` |
+| `prepare` | Run commands with convox cli available just before deployment — type: string or array of strings |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+
diff --git a/_includes/deploy/providers/datica.md b/_includes/deploy/providers/datica.md
new file mode 100644
index 00000000000..911d7355007
--- /dev/null
+++ b/_includes/deploy/providers/datica.md
@@ -0,0 +1,32 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: datica
+ target:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Datica is in **development**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `target` | The git remote repository to deploy to — **required**, type: string |
+| `path` | Path to files to deploy — type: string, default: `.` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+
diff --git a/_includes/deploy/providers/elasticbeanstalk.md b/_includes/deploy/providers/elasticbeanstalk.md
new file mode 100644
index 00000000000..bf8dd54a596
--- /dev/null
+++ b/_includes/deploy/providers/elasticbeanstalk.md
@@ -0,0 +1,53 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: elasticbeanstalk
+ access_key_id:
+ secret_access_key:
+ bucket:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to AWS Elastic Beanstalk is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `access_key_id` | AWS Access Key ID — **required**, **secret**, type: string |
+| `secret_access_key` | AWS Secret Key — **required**, **secret**, type: string |
+| `region` | AWS Region the Elastic Beanstalk app is running in — type: string, default: `us-east-1` |
+| `app` | Elastic Beanstalk application name — type: string, default: `repo name` |
+| `env` | Elastic Beanstalk environment name to be updated. — type: string |
+| `bucket` | Bucket name to upload app to — **required**, type: string, alias: `bucket_name` |
+| `bucket_path` | Location within Bucket to upload app to — type: string |
+| `description` | Description for the application version — type: string |
+| `label` | Label for the application version — type: string |
+| `zip_file` | The zip file that you want to deploy. If not given, a zipfile will be created from the current directory, honoring .ebignore and .gitignore. — type: string |
+| `wait_until_deployed` | Wait until the deployment has finished — type: boolean, requires: `env` |
+| `wait_until_deployed_timeout` | How many seconds to wait for Elastic Beanstalk deployment update. — type: integer, default: `600` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `AWS_` or `ELASTIC_BEANSTALK_`.
+
+For example, `access_key_id` can be given as
+
+* `AWS_ACCESS_KEY_ID=` or
+* `ELASTIC_BEANSTALK_ACCESS_KEY_ID=`
+
+{% include deploy/secrets.md name="access_key_id" env_name="AWS_ACCESS_KEY_ID" %}
diff --git a/_includes/deploy/providers/engineyard.md b/_includes/deploy/providers/engineyard.md
new file mode 100644
index 00000000000..ad71d5e4221
--- /dev/null
+++ b/_includes/deploy/providers/engineyard.md
@@ -0,0 +1,55 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: engineyard
+ api_key:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `email` and `password`:
+
+```yaml
+deploy:
+ provider: engineyard
+ email:
+ password:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Engineyard is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment. Either `api_key` or `email` and `password` are required.
+
+| `api_key` | Engine Yard API key — **secret**, type: string, note: can be obtained at https://cloud.engineyard.com/cli |
+| `email` | Engine Yard account email — type: string |
+| `password` | Engine Yard password — **secret**, type: string |
+| `app` | Engine Yard application name — type: string, default: `repo name` |
+| `env` | Engine Yard application environment — type: string, alias: `environment` |
+| `migrate` | Engine Yard migration commands — type: string |
+| `account` | Engine Yard account name — type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `ENGINEYARD_` or `EY_`.
+
+For example, `api_key` can be given as
+
+* `ENGINEYARD_API_KEY=` or
+* `EY_API_KEY=`
+
+{% include deploy/secrets.md name="api_key" env_name="ENGINEYARD_API_KEY" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/firebase.md b/_includes/deploy/providers/firebase.md
new file mode 100644
index 00000000000..d6b412961c9
--- /dev/null
+++ b/_includes/deploy/providers/firebase.md
@@ -0,0 +1,41 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: firebase
+ token:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Firebase is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `token` | Firebase CI access token (generate with firebase login:ci) — **required**, **secret**, type: string |
+| `project` | Firebase project to deploy to (defaults to the one specified in your firebase.json) — type: string |
+| `message` | Message describing this deployment. — type: string |
+| `only` | Firebase services to deploy — type: string, note: can be a comma-separated list |
+| `force` | Whether or not to delete Cloud Functions missing from the current working directory — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `FIREBASE_`.
+
+For example, `token` can be given as `FIREBASE_TOKEN=`.
+
+{% include deploy/secrets.md name="token" env_name="FIREBASE_TOKEN" %}
diff --git a/_includes/deploy/providers/flynn.md b/_includes/deploy/providers/flynn.md
new file mode 100644
index 00000000000..3c913c4bbdf
--- /dev/null
+++ b/_includes/deploy/providers/flynn.md
@@ -0,0 +1,31 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: flynn
+ git:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Flynn is in **development**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `git` | Flynn Git remote URL — **required**, type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+
diff --git a/_includes/deploy/providers/gae.md b/_includes/deploy/providers/gae.md
new file mode 100644
index 00000000000..93ba9235b45
--- /dev/null
+++ b/_includes/deploy/providers/gae.md
@@ -0,0 +1,38 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: gae
+ project:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Google App Engine is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `project` | Project ID used to identify the project on Google Cloud — **required**, type: string |
+| `keyfile` | Path to the JSON file containing your Service Account credentials in JSON Web Token format. To be obtained via the Google Developers Console. Should be handled with care as it contains authorization keys. — type: string, default: `service-account.json` |
+| `config` | Path to your service configuration file — type: string or array of strings, default: `app.yaml` |
+| `version` | The version of the app that will be created or replaced by this deployment. If you do not specify a version, one will be generated for you — type: string |
+| `verbosity` | Adjust the log verbosity — type: string, default: `warning` |
+| `promote` | Whether to promote the deployed version — type: boolean, default: `true` |
+| `stop_previous_version` | Prevent the deployment from stopping a previously promoted version — type: boolean, default: `true` |
+| `install_sdk` | Whether to install the Google Cloud SDK — type: boolean, default: `true` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+
diff --git a/_includes/deploy/providers/gcs.md b/_includes/deploy/providers/gcs.md
new file mode 100644
index 00000000000..6d6e5ec6d22
--- /dev/null
+++ b/_includes/deploy/providers/gcs.md
@@ -0,0 +1,58 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: gcs
+ key_file:
+ bucket:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `access_key_id` and `secret_access_key`:
+
+```yaml
+deploy:
+ provider: gcs
+ access_key_id:
+ secret_access_key:
+ bucket:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Google Cloud Store is **stable**.
+## Known options
+
+Use the following options to further configure the deployment. Either `key_file` or `access_key_id` and `secret_access_key` are required.
+
+| `key_file` | Path to a GCS service account key JSON file — type: string |
+| `access_key_id` | GCS Interoperable Access Key ID — **secret**, type: string |
+| `secret_access_key` | GCS Interoperable Access Secret — **secret**, type: string |
+| `bucket` | GCS Bucket — **required**, type: string |
+| `local_dir` | Local directory to upload from — type: string, default: `.` |
+| `upload_dir` | GCS directory to upload to — type: string |
+| `dot_match` | Upload hidden files starting with a dot — type: boolean |
+| `acl` | Access control to set for uploaded objects — type: string, default: `private`, known values: `private`, `public-read`, `public-read-write`, `authenticated-read`, `bucket-owner-read`, `bucket-owner-full-control`, see: [https://cloud.google.com/storage/docs/reference-headers#xgoogacl](https://cloud.google.com/storage/docs/reference-headers#xgoogacl) |
+| `detect_encoding` | HTTP header Content-Encoding to set for files compressed with gzip and compress utilities. — type: boolean |
+| `cache_control` | HTTP header Cache-Control to suggest that the browser cache the file. — type: string, see: [https://cloud.google.com/storage/docs/xml-api/reference-headers#cachecontrol](https://cloud.google.com/storage/docs/xml-api/reference-headers#cachecontrol) |
+| `glob` | type: string, default: `**/*` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `GCS_`.
+
+For example, `access_key_id` can be given as `GCS_ACCESS_KEY_ID=`.
+
+{% include deploy/secrets.md name="access_key_id" env_name="GCS_ACCESS_KEY_ID" %}
diff --git a/_includes/deploy/providers/git_push.md b/_includes/deploy/providers/git_push.md
new file mode 100644
index 00000000000..1f285ba4b4b
--- /dev/null
+++ b/_includes/deploy/providers/git_push.md
@@ -0,0 +1,95 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: git_push
+ token:
+ branch:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `deploy_key`, `name` and `email`:
+
+```yaml
+deploy:
+ provider: git_push
+ deploy_key:
+ name:
+ email:
+ branch:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Git (push) is in **development**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment. Either `token` or `deploy_key`, `name` and `email` are required.
+
+| `repo` | Repo slug — type: string, default: `repo slug` |
+| `token` | GitHub token with repo permission — **secret**, type: string, alias: `github_token` |
+| `deploy_key` | Path to a file containing a private deploy key with write access to the repository — type: string, see: [https://developer.github.com/v3/guides/managing-deploy-keys/#deploy-keys](https://developer.github.com/v3/guides/managing-deploy-keys/#deploy-keys) |
+| `branch` | Target branch to push to — **required**, type: string |
+| `base_branch` | Base branch to branch off initially, and (optionally) create a pull request for — type: string, default: `master` |
+| `name` | Committer name — type: string, note: defaults to the GitHub name or login associated with the GitHub token |
+| `email` | Committer email — type: string, note: defaults to the GitHub email associated with the GitHub token |
+| `commit_message` | type: string, default: `Update %{base_branch}` |
+| `allow_empty_commit` | Allow an empty commit to be created — type: boolean |
+| `force` | Whether to push --force — type: boolean, default: `false` |
+| `local_dir` | Local directory to push — type: string, default: `.` |
+| `pull_request` | Whether to create a pull request for the given branch — type: boolean |
+| `allow_same_branch` | Whether to allow pushing to the same branch as the current branch — type: boolean, default: `false`, note: setting this to true risks creating infinite build loops, use conditional builds or other mechanisms to prevent build from infinitely triggering more builds |
+| `host` | type: string, default: `github.com` |
+| `enterprise` | Whether to use a GitHub Enterprise API style URL — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `GITHUB_` or `GIT_`.
+
+For example, `token` can be given as
+
+* `GITHUB_TOKEN=` or
+* `GIT_TOKEN=`
+## Interpolation variables
+
+The following variables are available for interpolation on `commit_message`:
+
+* `base_branch`
+* `branch`
+* `deploy_key`
+* `email`
+* `git_author_email`
+* `git_author_name`
+* `git_branch`
+* `git_commit_author`
+* `git_commit_msg`
+* `git_sha`
+* `git_tag`
+* `host`
+* `local_dir`
+* `name`
+* `repo`
+
+Interpolation uses the syntax `%{variable-name}`. For example,
+`"Current commit sha: %{git_sha}"` would result in a string with the
+current Git sha embedded.
+
+Furthermore, environment variables present in the current build
+environment can be used through standard Bash variable interpolation.
+For example: "Current build number: ${TRAVIS_BUILD_NUMBER}".
+See [here](/user/environment-variables/#default-environment-variables)
+for a list of default environment variables set.
+
+{% include deploy/secrets.md name="token" env_name="GITHUB_TOKEN" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/gleis.md b/_includes/deploy/providers/gleis.md
new file mode 100644
index 00000000000..d5bcf69fafb
--- /dev/null
+++ b/_includes/deploy/providers/gleis.md
@@ -0,0 +1,42 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: gleis
+ username:
+ password:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Gleis is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `app` | Gleis application to upload to — type: string, default: `repo name` |
+| `username` | Gleis username — **required**, type: string |
+| `password` | Gleis password — **required**, **secret**, type: string |
+| `key_name` | Name of the SSH deploy key pushed to Gleis — type: string, default: `dpl_deploy_key` |
+| `verbose` | type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `GLEIS_`.
+
+For example, `password` can be given as `GLEIS_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="GLEIS_PASSWORD" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/hackage.md b/_includes/deploy/providers/hackage.md
new file mode 100644
index 00000000000..c3e519ed15f
--- /dev/null
+++ b/_includes/deploy/providers/hackage.md
@@ -0,0 +1,40 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: hackage
+ username:
+ password:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Hackage is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | Hackage username — **required**, type: string |
+| `password` | Hackage password — **required**, **secret**, type: string |
+| `publish` | Whether or not to publish the package — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `HACKAGE_`.
+
+For example, `password` can be given as `HACKAGE_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="HACKAGE_PASSWORD" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/hephy.md b/_includes/deploy/providers/hephy.md
new file mode 100644
index 00000000000..541d59a704f
--- /dev/null
+++ b/_includes/deploy/providers/hephy.md
@@ -0,0 +1,45 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: hephy
+ controller:
+ username:
+ password:
+ app:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Hephy is in **beta**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `controller` | Hephy controller — **required**, type: string, e.g.: hephy.hephyapps.com |
+| `username` | Hephy username — **required**, type: string |
+| `password` | Hephy password — **required**, **secret**, type: string |
+| `app` | Deis app — **required**, type: string |
+| `cli_version` | Install a specific Hephy CLI version — type: string, default: `stable` |
+| `verbose` | Verbose log output — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `HEPHY_`.
+
+For example, `password` can be given as `HEPHY_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="HEPHY_PASSWORD" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/heroku_api.md b/_includes/deploy/providers/heroku_api.md
new file mode 100644
index 00000000000..d7acd881a8b
--- /dev/null
+++ b/_includes/deploy/providers/heroku_api.md
@@ -0,0 +1,39 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: heroku:api
+ api_key:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Heroku API is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `api_key` | Heroku API key — **required**, **secret**, type: string |
+
+### Shared options
+
+| `strategy` | Heroku deployment strategy — type: string, default: `api`, known values: `api`, `git` |
+| `app` | Heroku app name — type: string, default: `repo name` |
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `HEROKU_`.
+
+For example, `api_key` can be given as `HEROKU_API_KEY=`.
+
+{% include deploy/secrets.md name="api_key" env_name="HEROKU_API_KEY" %}
diff --git a/_includes/deploy/providers/heroku_git.md b/_includes/deploy/providers/heroku_git.md
new file mode 100644
index 00000000000..a1bd678c96a
--- /dev/null
+++ b/_includes/deploy/providers/heroku_git.md
@@ -0,0 +1,51 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: heroku:git
+ api_key:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `username` and `password`:
+
+```yaml
+deploy:
+ provider: heroku:git
+ username:
+ password:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Heroku Git is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment. Either `api_key` or `username` and `password` are required.
+
+| `api_key` | Heroku API key — **secret**, type: string |
+| `username` | Heroku username — type: string, alias: `user` |
+| `password` | Heroku password — **secret**, type: string |
+| `git` | Heroku Git remote URL — type: string |
+
+### Shared options
+
+| `strategy` | Heroku deployment strategy — type: string, default: `api`, known values: `api`, `git` |
+| `app` | Heroku app name — type: string, default: `repo name` |
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `HEROKU_`.
+
+For example, `api_key` can be given as `HEROKU_API_KEY=`.
+
+{% include deploy/secrets.md name="api_key" env_name="HEROKU_API_KEY" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/lambda.md b/_includes/deploy/providers/lambda.md
new file mode 100644
index 00000000000..7b1d720b45e
--- /dev/null
+++ b/_includes/deploy/providers/lambda.md
@@ -0,0 +1,96 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: lambda
+ access_key_id:
+ secret_access_key:
+ function_name:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to AWS Lambda is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `access_key_id` | AWS access key id — **required**, **secret**, type: string |
+| `secret_access_key` | AWS secret key — **required**, **secret**, type: string |
+| `region` | AWS region the Lambda function is running in — type: string, default: `us-east-1` |
+| `function_name` | Name of the Lambda being created or updated — **required**, type: string |
+| `role` | ARN of the IAM role to assign to the Lambda function — type: string, note: required when creating a new function |
+| `handler_name` | Function the Lambda calls to begin execution. — type: string, note: required when creating a new function |
+| `module_name` | Name of the module that exports the handler — type: string, requires: `handler_name`, default: `index` |
+| `description` | Description of the Lambda being created or updated — type: string |
+| `timeout` | Function execution time (in seconds) at which Lambda should terminate the function — type: string, default: `3` |
+| `memory_size` | Amount of memory in MB to allocate to this Lambda — type: string, default: `128` |
+| `subnet_ids` | List of subnet IDs to be added to the function — type: string or array of strings, note: Needs the ec2:DescribeSubnets and ec2:DescribeVpcs permission for the user of the access/secret key to work |
+| `security_group_ids` | List of security group IDs to be added to the function — type: string or array of strings, note: Needs the ec2:DescribeSecurityGroups and ec2:DescribeVpcs permission for the user of the access/secret key to work |
+| `environment` | List of Environment Variables to add to the function — type: string or array of strings, alias: `environment_variables`, format: `/[\w\-]+=.+/`, note: Can be encrypted for added security |
+| `runtime` | Lambda runtime to use — type: string, default: `nodejs10.x`, known values: `nodejs12.x`, `nodejs10.x`, `python3.8`, `python3.7`, `python3.6`, `python2.7`, `ruby2.7`, `ruby2.5`, `java11`, `java8`, `go1.x`, `dotnetcore2.1`, note: required when creating a new function |
+| `dead_letter_arn` | ARN to an SNS or SQS resource used for the dead letter queue. — type: string |
+| `kms_key_arn` | KMS key ARN to use to encrypt environment_variables. — type: string |
+| `tracing_mode` | Tracing mode — type: string, default: `PassThrough`, known values: `Active`, `PassThrough`, note: Needs xray:PutTraceSegments xray:PutTelemetryRecords on the role |
+| `layers` | Function layer arns — type: string or array of strings |
+| `function_tags` | List of tags to add to the function — type: string or array of strings, format: `/[\w\-]+=.+/`, note: Can be encrypted for added security |
+| `publish` | Create a new version of the code instead of replacing the existing one. — type: boolean |
+| `zip` | Path to a packaged Lambda, a directory to package, or a single file to package — type: string, default: `.` |
+| `dot_match` | Include hidden .* files to the zipped archive — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `AWS_` or `LAMBDA_`.
+
+For example, `access_key_id` can be given as
+
+* `AWS_ACCESS_KEY_ID=` or
+* `LAMBDA_ACCESS_KEY_ID=`
+## Interpolation variables
+
+The following variables are available for interpolation on `description`:
+
+* `dead_letter_arn`
+* `function_name`
+* `git_author_email`
+* `git_author_name`
+* `git_branch`
+* `git_commit_author`
+* `git_commit_msg`
+* `git_sha`
+* `git_tag`
+* `handler_name`
+* `kms_key_arn`
+* `memory_size`
+* `module_name`
+* `region`
+* `role`
+* `runtime`
+* `timeout`
+* `tracing_mode`
+* `zip`
+
+Interpolation uses the syntax `%{variable-name}`. For example,
+`"Current commit sha: %{git_sha}"` would result in a string with the
+current Git sha embedded.
+
+Furthermore, environment variables present in the current build
+environment can be used through standard Bash variable interpolation.
+For example: "Current build number: ${TRAVIS_BUILD_NUMBER}".
+See [here](/user/environment-variables/#default-environment-variables)
+for a list of default environment variables set.
+
+{% include deploy/secrets.md name="access_key_id" env_name="AWS_ACCESS_KEY_ID" %}
diff --git a/_includes/deploy/providers/launchpad.md b/_includes/deploy/providers/launchpad.md
new file mode 100644
index 00000000000..734da3366da
--- /dev/null
+++ b/_includes/deploy/providers/launchpad.md
@@ -0,0 +1,39 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: launchpad
+
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Launchpad is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `oauth_token` | Launchpad OAuth token — **secret**, type: string |
+| `oauth_token_secret` | Launchpad OAuth token secret — **secret**, type: string |
+| `slug` | Launchpad project slug — type: string, format: `/^~[^\/]+\/[^\/]+\/[^\/]+$/`, e.g.: ~user-name/project-name/branch-name |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `LAUNCHPAD_`.
+
+For example, `oauth_token` can be given as `LAUNCHPAD_OAUTH_TOKEN=`.
+
+{% include deploy/secrets.md name="oauth_token" env_name="LAUNCHPAD_OAUTH_TOKEN" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/netlify.md b/_includes/deploy/providers/netlify.md
new file mode 100644
index 00000000000..fce3ca7529e
--- /dev/null
+++ b/_includes/deploy/providers/netlify.md
@@ -0,0 +1,43 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: netlify
+ site:
+ auth:
+ edge: true # opt in to dpl v2
+```
+
+{: data-file=".travis.yml"}
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Netlify is **stable**.
+
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `site` | A site ID to deploy to — **required**, type: string |
+| `auth` | An auth token to log in with — **required**, **secret**, type: string |
+| `dir` | Specify a folder to deploy — type: string |
+| `functions` | Specify a functions folder to deploy — type: string |
+| `message` | A message to include in the deploy log — type: string |
+| `prod` | Deploy to production — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `NETLIFY_`.
+
+For example, `auth` can be given as `NETLIFY_AUTH=`.
+
+{% include deploy/secrets.md name="auth" env_name="NETLIFY_AUTH" %}
diff --git a/_includes/deploy/providers/npm.md b/_includes/deploy/providers/npm.md
new file mode 100644
index 00000000000..c32c7a307e5
--- /dev/null
+++ b/_includes/deploy/providers/npm.md
@@ -0,0 +1,45 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: npm
+ api_token:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to npm is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `email` | npm account email — type: string |
+| `api_token` | npm api token — **required**, **secret**, type: string, alias: `api_key`, note: can be retrieved from your local ~/.npmrc file, see: [https://docs.npmjs.com/creating-and-viewing-authentication-tokens](https://docs.npmjs.com/creating-and-viewing-authentication-tokens) |
+| `access` | Access level — type: string, known values: `public`, `private` |
+| `registry` | npm registry url — type: string |
+| `src` | directory or tarball to publish — type: string, default: `.` |
+| `tag` | distribution tags to add — type: string |
+| `run_script` | run the given script from package.json — type: string or array of strings, note: skips running npm publish |
+| `dry_run` | performs test run without uploading to registry — type: boolean |
+| `auth_method` | Authentication method — type: string, known values: `auth` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `NPM_`.
+
+For example, `api_token` can be given as `NPM_API_TOKEN=`.
+
+{% include deploy/secrets.md name="api_token" env_name="NPM_API_TOKEN" %}
diff --git a/_includes/deploy/providers/nuget.md b/_includes/deploy/providers/nuget.md
new file mode 100644
index 00000000000..97642bc9093
--- /dev/null
+++ b/_includes/deploy/providers/nuget.md
@@ -0,0 +1,45 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: nuget
+ api_key:
+ registry:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to nuget is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `api_key` | NuGet registry API key — **required**, **secret**, type: string, note: can be retrieved from your NuGet registry provider, see: [https://docs.npmjs.com/creating-and-viewing-authentication-tokens](https://docs.npmjs.com/creating-and-viewing-authentication-tokens) |
+| `registry` | NuGet registry url — **required**, type: string |
+| `src` | The nupkg file(s) to publish — type: string, default: `*.nupkg` |
+| `no_symbols` | Do not push symbols, even if present — type: boolean |
+| `skip_duplicate` | Do not overwrite existing packages — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `NUGET_` or `DOTNET_`.
+
+For example, `api_key` can be given as
+
+* `NUGET_API_KEY=` or
+* `DOTNET_API_KEY=`
+
+{% include deploy/secrets.md name="api_key" env_name="NUGET_API_KEY" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/openshift.md b/_includes/deploy/providers/openshift.md
new file mode 100644
index 00000000000..550d9a44d21
--- /dev/null
+++ b/_includes/deploy/providers/openshift.md
@@ -0,0 +1,42 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: openshift
+ server:
+ token:
+ project:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to OpenShift is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `server` | OpenShift server — **required**, type: string |
+| `token` | OpenShift token — **required**, **secret**, type: string |
+| `project` | OpenShift project — **required**, type: string |
+| `app` | OpenShift application — type: string, default: `repo name` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `OPENSHIFT_`.
+
+For example, `token` can be given as `OPENSHIFT_TOKEN=`.
+
+{% include deploy/secrets.md name="token" env_name="OPENSHIFT_TOKEN" %}
diff --git a/_includes/deploy/providers/opsworks.md b/_includes/deploy/providers/opsworks.md
new file mode 100644
index 00000000000..f25a64cfb71
--- /dev/null
+++ b/_includes/deploy/providers/opsworks.md
@@ -0,0 +1,51 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: opsworks
+ access_key_id:
+ secret_access_key:
+ app_id:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to AWS OpsWorks is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `access_key_id` | AWS access key id — **required**, **secret**, type: string |
+| `secret_access_key` | AWS secret key — **required**, **secret**, type: string |
+| `app_id` | The app id — **required**, type: string |
+| `region` | AWS region — type: string, default: `us-east-1` |
+| `instance_ids` | An instance id — type: string or array of strings |
+| `layer_ids` | A layer id — type: string or array of strings |
+| `migrate` | Migrate the database. — type: boolean |
+| `wait_until_deployed` | Wait until the app is deployed and return the deployment status. — type: boolean |
+| `update_on_success` | When wait-until-deployed and updated-on-success are both not given, application source is updated to the current SHA. Ignored when wait-until-deployed is not given. — type: boolean, alias: `update_app_on_success` |
+| `custom_json` | Custom json options override (overwrites default configuration) — type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `AWS_` or `OPSWORKS_`.
+
+For example, `access_key_id` can be given as
+
+* `AWS_ACCESS_KEY_ID=` or
+* `OPSWORKS_ACCESS_KEY_ID=`
+
+{% include deploy/secrets.md name="access_key_id" env_name="AWS_ACCESS_KEY_ID" %}
diff --git a/_includes/deploy/providers/packagecloud.md b/_includes/deploy/providers/packagecloud.md
new file mode 100644
index 00000000000..8152a593a73
--- /dev/null
+++ b/_includes/deploy/providers/packagecloud.md
@@ -0,0 +1,48 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: packagecloud
+ username:
+ token:
+ repository:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Packagecloud is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | The packagecloud.io username. — **required**, type: string |
+| `token` | The packagecloud.io api token. — **required**, **secret**, type: string |
+| `repository` | The repository to push to. — **required**, type: string |
+| `local_dir` | The sub-directory of the built assets for deployment. — type: string, default: `.` |
+| `dist` | Required for debian, rpm, and node.js packages (use "node" for node.js packages). The complete list of supported strings can be found on the packagecloud.io docs. — type: string |
+| `force` | Whether package has to be (re)uploaded / deleted before upload — type: boolean |
+| `connect_timeout` | type: integer, default: `60` |
+| `read_timeout` | type: integer, default: `60` |
+| `write_timeout` | type: integer, default: `180` |
+| `package_glob` | type: string or array of strings, default: `["**/*"]` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `PACKAGECLOUD_`.
+
+For example, `token` can be given as `PACKAGECLOUD_TOKEN=`.
+
+{% include deploy/secrets.md name="token" env_name="PACKAGECLOUD_TOKEN" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/pages_api.md b/_includes/deploy/providers/pages_api.md
new file mode 100644
index 00000000000..98f09e21f10
--- /dev/null
+++ b/_includes/deploy/providers/pages_api.md
@@ -0,0 +1,42 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: pages:api
+ token:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to GitHub Pages (API) is in **development**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `repo` | GitHub repo slug — type: string, default: `repo slug` |
+| `token` | GitHub oauth token with repo permission — **required**, **secret**, type: string, alias: `github_token` |
+
+### Shared options
+
+| `strategy` | GitHub Pages deployment strategy — type: string, default: `git`, known values: `api`, `git` |
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `GITHUB_` or `PAGES_`.
+
+For example, `token` can be given as
+
+* `GITHUB_TOKEN=` or
+* `PAGES_TOKEN=`
+
+{% include deploy/secrets.md name="token" env_name="GITHUB_TOKEN" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/pages_git.md b/_includes/deploy/providers/pages_git.md
new file mode 100644
index 00000000000..f39d2027440
--- /dev/null
+++ b/_includes/deploy/providers/pages_git.md
@@ -0,0 +1,94 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: pages:git
+ token:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `deploy_key`:
+
+```yaml
+deploy:
+ provider: pages:git
+ deploy_key:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to GitHub Pages is **stable**.
+## Known options
+
+Use the following options to further configure the deployment. Either `token` or `deploy_key` are required.
+
+| `repo` | Repo slug — type: string, default: `repo slug` |
+| `token` | GitHub token with repo permission — **secret**, type: string, alias: `github_token` |
+| `deploy_key` | Path to a file containing a private deploy key with write access to the repository — type: string, see: [https://developer.github.com/v3/guides/managing-deploy-keys/#deploy-keys](https://developer.github.com/v3/guides/managing-deploy-keys/#deploy-keys) |
+| `target_branch` | Branch to push force to — type: string, default: `gh-pages` |
+| `keep_history` | Create incremental commit instead of doing push force — type: boolean, default: `true` |
+| `commit_message` | type: string, default: `Deploy %{project_name} to %{url}:%{target_branch}` |
+| `allow_empty_commit` | Allow an empty commit to be created — type: boolean, requires: `keep_history` |
+| `verbose` | Be verbose about the deploy process — type: boolean |
+| `local_dir` | Directory to push to GitHub Pages — type: string, default: `.` |
+| `fqdn` | Write the given domain name to the CNAME file — type: string |
+| `project_name` | Used in the commit message only (defaults to fqdn or the current repo slug) — type: string |
+| `name` | Committer name — type: string, note: defaults to the current git commit author name |
+| `email` | Committer email — type: string, note: defaults to the current git commit author email |
+| `committer_from_gh` | Use the token's owner name and email for the commit — type: boolean, requires: `token` |
+| `deployment_file` | Enable creation of a deployment-info file — type: boolean |
+| `url` | type: string, alias: `github_url`, default: `github.com` |
+
+### Shared options
+
+| `strategy` | GitHub Pages deployment strategy — type: string, default: `git`, known values: `api`, `git` |
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `GITHUB_` or `PAGES_`.
+
+For example, `token` can be given as
+
+* `GITHUB_TOKEN=` or
+* `PAGES_TOKEN=`
+## Interpolation variables
+
+The following variables are available for interpolation on `commit_message`:
+
+* `deploy_key`
+* `email`
+* `fqdn`
+* `git_author_email`
+* `git_author_name`
+* `git_branch`
+* `git_commit_author`
+* `git_commit_msg`
+* `git_sha`
+* `git_tag`
+* `local_dir`
+* `name`
+* `project_name`
+* `repo`
+* `target_branch`
+* `url`
+
+Interpolation uses the syntax `%{variable-name}`. For example,
+`"Current commit sha: %{git_sha}"` would result in a string with the
+current Git sha embedded.
+
+Furthermore, environment variables present in the current build
+environment can be used through standard Bash variable interpolation.
+For example: "Current build number: ${TRAVIS_BUILD_NUMBER}".
+See [here](/user/environment-variables/#default-environment-variables)
+for a list of default environment variables set.
+
+{% include deploy/secrets.md name="token" env_name="GITHUB_TOKEN" %}
diff --git a/_includes/deploy/providers/puppetforge.md b/_includes/deploy/providers/puppetforge.md
new file mode 100644
index 00000000000..72d6646fb8f
--- /dev/null
+++ b/_includes/deploy/providers/puppetforge.md
@@ -0,0 +1,40 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: puppetforge
+ username:
+ password:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Puppet Forge is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | Puppet Forge user name — **required**, type: string, alias: `user` |
+| `password` | Puppet Forge password — **required**, **secret**, type: string |
+| `url` | Puppet Forge URL to deploy to — type: string, default: `https://forgeapi.puppetlabs.com/` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `PUPPETFORGE_`.
+
+For example, `password` can be given as `PUPPETFORGE_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="PUPPETFORGE_PASSWORD" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/pypi.md b/_includes/deploy/providers/pypi.md
new file mode 100644
index 00000000000..5140bd2d1a9
--- /dev/null
+++ b/_includes/deploy/providers/pypi.md
@@ -0,0 +1,49 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: pypi
+ username:
+ password:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to PyPI is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `username` | PyPI Username — **required**, type: string, alias: `user` |
+| `password` | PyPI Password — **required**, **secret**, type: string |
+| `server` | Release to a different index — type: string, default: `https://upload.pypi.org/legacy/` |
+| `distributions` | Space-separated list of distributions to be uploaded to PyPI — type: string, default: `sdist` |
+| `docs_dir` | Path to the directory to upload documentation from — type: string, default: `build/docs` |
+| `skip_existing` | Do not overwrite an existing file with the same name on the server. — type: boolean |
+| `upload_docs` | Upload documentation — type: boolean, default: `false`, note: most PyPI servers, including upload.pypi.org, do not support uploading documentation |
+| `twine_check` | Whether to run twine check — type: boolean, default: `true` |
+| `remove_build_dir` | Remove the build dir after the upload — type: boolean, default: `true` |
+| `setuptools_version` | type: string, format: `/\A\d+(?:\.\d+)*\z/` |
+| `twine_version` | type: string, format: `/\A\d+(?:\.\d+)*\z/` |
+| `wheel_version` | type: string, format: `/\A\d+(?:\.\d+)*\z/` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `PYPI_`.
+
+For example, `password` can be given as `PYPI_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="PYPI_PASSWORD" %}
diff --git a/_includes/deploy/providers/releases.md b/_includes/deploy/providers/releases.md
new file mode 100644
index 00000000000..24c0b8e0506
--- /dev/null
+++ b/_includes/deploy/providers/releases.md
@@ -0,0 +1,63 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: releases
+ token:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `username` and `password`:
+
+```yaml
+deploy:
+ provider: releases
+ username:
+ password:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to GitHub Releases is **stable**.
+## Known options
+
+Use the following options to further configure the deployment. Either `token` or `username` and `password` are required.
+
+| `token` | GitHub oauth token (needs public_repo or repo permission) — **secret**, type: string, alias: `api_key` |
+| `username` | GitHub login name — type: string, alias: `user` |
+| `password` | GitHub password — **secret**, type: string |
+| `repo` | GitHub repo slug — type: string, default: `repo slug` |
+| `file` | File or glob to release to GitHub — type: string or array of strings, default: `*` |
+| `file_glob` | Interpret files as globs — type: boolean, default: `true` |
+| `overwrite` | Overwrite files with the same name — type: boolean |
+| `prerelease` | Identify the release as a prerelease — type: boolean |
+| `release_number` | Release number (override automatic release detection) — type: string |
+| `release_notes` | Content for the release notes — type: string, alias: `body` |
+| `release_notes_file` | Path to a file containing the release notes — type: string, note: will be ignored if --release_notes is given |
+| `draft` | Identify the release as a draft — type: boolean |
+| `tag_name` | Git tag from which to create the release — type: string |
+| `target_commitish` | Commitish value that determines where the Git tag is created from — type: string |
+| `name` | Name for the release — type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `GITHUB_` or `RELEASES_`.
+
+For example, `token` can be given as
+
+* `GITHUB_TOKEN=` or
+* `RELEASES_TOKEN=`
+
+{% include deploy/secrets.md name="token" env_name="GITHUB_TOKEN" %}
diff --git a/_includes/deploy/providers/rubygems.md b/_includes/deploy/providers/rubygems.md
new file mode 100644
index 00000000000..c8d41a71c81
--- /dev/null
+++ b/_includes/deploy/providers/rubygems.md
@@ -0,0 +1,52 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: rubygems
+ api_key:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `username` and `password`:
+
+```yaml
+deploy:
+ provider: rubygems
+ username:
+ password:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Rubygems is **stable**.
+## Known options
+
+Use the following options to further configure the deployment. Either `api_key` or `username` and `password` are required.
+
+| `api_key` | Rubygems api key — **secret**, type: string |
+| `username` | Rubygems user name — type: string, alias: `user` |
+| `password` | Rubygems password — **secret**, type: string |
+| `gem` | Name of the gem to release — type: string, default: `repo name` |
+| `gemspec` | Gemspec file to use to build the gem — type: string |
+| `gemspec_glob` | Glob pattern to search for gemspec files when multiple gems are generated in the repository (overrides the gemspec option) — type: string |
+| `host` | type: string |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `RUBYGEMS_`.
+
+For example, `api_key` can be given as `RUBYGEMS_API_KEY=`.
+
+{% include deploy/secrets.md name="api_key" env_name="RUBYGEMS_API_KEY" %}
diff --git a/_includes/deploy/providers/s3.md b/_includes/deploy/providers/s3.md
new file mode 100644
index 00000000000..2b169c12657
--- /dev/null
+++ b/_includes/deploy/providers/s3.md
@@ -0,0 +1,62 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: s3
+ access_key_id:
+ secret_access_key:
+ bucket:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to AWS S3 is **stable**.
+## Known options
+
+Use the following options to further configure the deployment.
+
+| `access_key_id` | AWS access key id — **required**, **secret**, type: string |
+| `secret_access_key` | AWS secret key — **required**, **secret**, type: string |
+| `bucket` | S3 bucket — **required**, type: string |
+| `region` | S3 region — type: string, default: `us-east-1` |
+| `endpoint` | S3 endpoint — type: string |
+| `upload_dir` | S3 directory to upload to — type: string |
+| `local_dir` | Local directory to upload from — type: string, default: `.`, e.g.: ~/travis/build (absolute path) or ./build (relative path) |
+| `glob` | Files to upload — type: string, default: `**/*` |
+| `dot_match` | Upload hidden files starting with a dot — type: boolean |
+| `acl` | Access control for the uploaded objects — type: string, default: `private`, known values: `private`, `public_read`, `public_read_write`, `authenticated_read`, `bucket_owner_read`, `bucket_owner_full_control` |
+| `detect_encoding` | HTTP header Content-Encoding for files compressed with gzip and compress utilities — type: boolean |
+| `cache_control` | HTTP header Cache-Control to suggest that the browser cache the file — type: string or array of strings, default: `no-cache`, known values: `/^no-cache.*/`, `/^no-store.*/`, `/^max-age=\d+.*/`, `/^s-maxage=\d+.*/`, `/^no-transform/`, `/^public/`, `/^private/`, note: accepts mapping values to globs |
+| `expires` | Date and time that the cached object expires — type: string or array of strings, format: `/^"?\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} .+"?.*$/`, note: accepts mapping values to globs |
+| `default_text_charset` | Default character set to append to the content-type of text files — type: string |
+| `storage_class` | S3 storage class to upload as — type: string, default: `STANDARD`, known values: `STANDARD`, `STANDARD_IA`, `REDUCED_REDUNDANCY` |
+| `server_side_encryption` | Use S3 Server Side Encryption (SSE-AES256) — type: boolean |
+| `index_document_suffix` | Index document suffix of a S3 website — type: string |
+| `overwrite` | Whether or not to overwrite existing files — type: boolean, default: `true` |
+| `force_path_style` | Whether to force keeping the bucket name on the path — type: boolean |
+| `max_threads` | The number of threads to use for S3 file uploads — type: integer, default: `5`, max: 15 |
+| `verbose` | Be verbose about uploading files — type: boolean |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `AWS_` or `S3_`.
+
+For example, `access_key_id` can be given as
+
+* `AWS_ACCESS_KEY_ID=` or
+* `S3_ACCESS_KEY_ID=`
+
+{% include deploy/secrets.md name="access_key_id" env_name="AWS_ACCESS_KEY_ID" %}
diff --git a/_includes/deploy/providers/scalingo.md b/_includes/deploy/providers/scalingo.md
new file mode 100644
index 00000000000..406a30df660
--- /dev/null
+++ b/_includes/deploy/providers/scalingo.md
@@ -0,0 +1,53 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: scalingo
+ api_token:
+ edge: true # opt in to dpl v2
+```
+{: data-file=".travis.yml"}
+
+Alternatively, you can use `username` and `password`:
+
+```yaml
+deploy:
+ provider: scalingo
+ username:
+ password:
+```
+{: data-file=".travis.yml"}
+
+
+{{ include.content }}
+{% endunless %}
+
+## Status
+
+Support for deployments to Scalingo is in **alpha**. Please see [Maturity Levels](/user/deployment-v2/#maturity-levels) for details.
+## Known options
+
+Use the following options to further configure the deployment. Either `api_token` or `username` and `password` are required.
+
+| `app` | type: string, default: `repo name` |
+| `api_token` | Scalingo API token — type: string, alias: `api_key` (deprecated, please use `api_token`) |
+| `username` | Scalingo username — type: string |
+| `password` | Scalingo password — **secret**, type: string |
+| `region` | Scalingo region — type: string, default: `agora-fr1`, known values: `agora-fr1`, `osc-fr1` |
+| `remote` | Git remote name — type: string, default: `scalingo-dpl` |
+| `branch` | Git branch — type: string, default: `master` |
+| `timeout` | Timeout for Scalingo CLI commands — type: integer, default: `60` |
+
+### Shared options
+
+| `cleanup` | Clean up build artifacts from the Git working directory before the deployment — type: boolean |
+| `run` | Commands to execute after the deployment finished successfully — type: string or array of strings |
+
+## Environment variables
+
+All options can be given as environment variables if prefixed with `SCALINGO_`.
+
+For example, `password` can be given as `SCALINGO_PASSWORD=`.
+
+{% include deploy/secrets.md name="password" env_name="SCALINGO_PASSWORD" %}
\ No newline at end of file
diff --git a/_includes/deploy/providers/script.md b/_includes/deploy/providers/script.md
new file mode 100644
index 00000000000..3ce13b59ad4
--- /dev/null
+++ b/_includes/deploy/providers/script.md
@@ -0,0 +1,31 @@
+{% unless include.minimal == false %}
+For a minimal configuration, add the following to your `.travis.yml`:
+
+```yaml
+deploy:
+ provider: script
+ script:
-