docs/appendices/0.21.0-migration-guide.md

# 0.21.0 Migration Guide

## Changes

The `tls` name is no longer a reserved app name, and can be used by applications. This was previously a reserved app name due to it's use as a place for global SSL certificate files; Dokku has not supported global SSL certificates for many releases, and thus there is no need to reserve the name.

## Deprecations

- `git#git_deploy_branch()` is deprecated in favor of `plugn trigger git-deploy-branch`.
- The `config` command is deprecated in favor of `config:show`.
    - Usage of this command in conjunction with either the `--export` or `--shell` flag is deprecated in favor of `config:export --format` with the correct format value (`exports` or `shell`, respectively).
- The `nginx:build-config` command is deprecated in favor of `proxy:build-config`.

## Removals

The `apps:destroy` command no longer takes a second argument `force`. Instead, this can be passed as the `--force` flag, either globally or as a flag to the command itself.

The `proxy:enable` and `proxy:disable` no longer restart apps when setting the `DOKKU_DISABLE_PROXY` environment variable. A future release will disable usage of `DOKKU_DISABLE_PROXY` altogether.
refactor: deprecate git_deploy_branch in favor of plugn trigger 2020-04-18 18:21:46 -04:00			`# 0.21.0 Migration Guide`

feat: allow apps named tls The `tls` name is no longer a reserved app name, and can be used by applications. This was previously a reserved app name due to it's use as a place for global SSL certificate files; Dokku has not supported global SSL certificates for many releases, and thus there is no need to reserve the name. 2020-05-08 23:57:30 -04:00			`## Changes`

			The `tls` name is no longer a reserved app name, and can be used by applications. This was previously a reserved app name due to it's use as a place for global SSL certificate files; Dokku has not supported global SSL certificates for many releases, and thus there is no need to reserve the name.

refactor: deprecate git_deploy_branch in favor of plugn trigger 2020-04-18 18:21:46 -04:00			`## Deprecations`

			- `git#git_deploy_branch()` is deprecated in favor of `plugn trigger git-deploy-branch`.
feat: simplify flag parsing in config plugin Commands should be written such that they take arguments as is. 2020-05-29 01:18:47 -04:00			- The `config` command is deprecated in favor of `config:show`.
docs: update markdownlint rules for better formatting 2023-08-19 13:29:12 -04:00			- Usage of this command in conjunction with either the `--export` or `--shell` flag is deprecated in favor of `config:export --format` with the correct format value (`exports` or `shell`, respectively).
feat: create proxy:build-config command Closes #4024 2020-06-29 20:17:23 -04:00			- The `nginx:build-config` command is deprecated in favor of `proxy:build-config`.
feat: simplify flag parsing in apps plugin Commands should be written such that they take arguments as is. 2020-05-09 00:44:20 -04:00
			`## Removals`

			The `apps:destroy` command no longer takes a second argument `force`. Instead, this can be passed as the `--force` flag, either globally or as a flag to the command itself.

feat: simplify flag parsing in proxy plugin Commands should be written such that they take arguments as is. 2020-05-28 23:55:30 -04:00			The `proxy:enable` and `proxy:disable` no longer restart apps when setting the `DOKKU_DISABLE_PROXY` environment variable. A future release will disable usage of `DOKKU_DISABLE_PROXY` altogether.