diff --git a/docs/appendices/0.10.0-migration-guide.md b/docs/appendices/0.10.0-migration-guide.md new file mode 100644 index 00000000000..23ccb6c4979 --- /dev/null +++ b/docs/appendices/0.10.0-migration-guide.md @@ -0,0 +1,9 @@ +# 0.10.0 Migration Guide + +## PCI Compliance + +By default, Dokku will ship a PCI Compliant nginx configuration. For developers whose users are on older browsers or mobile devices, you may need to ship a custom `nginx.conf.sigil` to enable ciphers for older browsers. + +## Nginx Error Pages + +We now ship with nicer error pages by default. You are free to customize your Dokku installation via a custom `nginx.conf.sigil` to change what error pages are displayed in different circumstances. diff --git a/docs/appendices/0.8.0-migration-guide.md b/docs/appendices/0.8.0-migration-guide.md new file mode 100644 index 00000000000..6247a3e5153 --- /dev/null +++ b/docs/appendices/0.8.0-migration-guide.md @@ -0,0 +1,19 @@ +# 0.8.0 Migration Guide + +## Domain Management + +You can now set global and app domains via `domains:set` and `domains:set-global`. See the [domains documentation](/docs/configuration/domains/) for more details. + +## Plugin Uninstallation + +A new `uninstall` plugin trigger was introduced. This functionality may be in use for newer plugins, so be aware that older Dokku versions may require manual cleanup. + +See the [uninstall trigger documentation](/docs/development/plugin-triggers/#uninstall) for implementation instructions. + +## Deployment Tasks + +Should a pre or post deployment task fail, we now fail the entire deploy. + +## Nginx HTTP2 Support + +Due to bugs in Nginx, the minimum version for HTTP2 is now 1.11.5. diff --git a/docs/appendices/0.9.0-migration-guide.md b/docs/appendices/0.9.0-migration-guide.md new file mode 100644 index 00000000000..0a00cbcddd5 --- /dev/null +++ b/docs/appendices/0.9.0-migration-guide.md @@ -0,0 +1,12 @@ +# 0.9.0 Migration Guide + +## Golang Migration + +There is an ongoing migration to rewrite Dokku in Golang. The reasons are beyond the scope of this document, but this may impact any patches you have for Dokku. As of 0.9.0, only the `repo` plugin is in Golang. + +The following shall remain true, regardless of the state of our rewrite: + +- You will be able to write custom plugins in any language. +- You will be able to enable or disable core plugins. +- `plugn` will continue to be used for executing plugin triggers. +- We will provide bash wrappers that can be sourced to execute core functionality that is implemented in golang. diff --git a/docs/getting-started/upgrading.md b/docs/getting-started/upgrading.md index cfb2b72b81b..bcdeacc805a 100644 --- a/docs/getting-started/upgrading.md +++ b/docs/getting-started/upgrading.md @@ -18,6 +18,18 @@ Before upgrading, check the migration guides to get comfortable with new feature - [0.7 Migration Guide](/docs/appendices/0.7.0-migration-guide.md) +### 0.8 Migration Guide + +- [0.8 Migration Guide](/docs/appendices/0.8.0-migration-guide.md) + +### 0.9 Migration Guide + +- [0.9 Migration Guide](/docs/appendices/0.9.0-migration-guide.md) + +### 0.10 Migration Guide + +- [0.10 Migration Guide](/docs/appendices/0.10.0-migration-guide.md) + ## Upgrade Instructions If Dokku was installed via `apt-get install dokku` or `bootstrap.sh` (most common), upgrade with: