Add doc about upgrading Ubuntu release

hitachienergy · Jan 5, 2022 · 896d8ec · 896d8ec
1 parent 4a94429
commit 896d8ec
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 1 deletion.
diff --git a/docs/changelogs/CHANGELOG-1.3.md b/docs/changelogs/CHANGELOG-1.3.md
@@ -72,7 +72,8 @@
 
 ### Breaking changes
 
-- Ubuntu 18.04 is not supported. For Ubuntu, only release 20.04 is supported and upgrade from 18.04 is not handled by Epiphany.
+- **Ubuntu 18.04 is not supported**. For Ubuntu, only release 20.04 is supported and upgrade from 18.04 is not handled by Epiphany.
+For more information, see [How to upgrade from Ubuntu 18.04 to 20.04](../home/howto/OS_UPGRADE.md#how-to-upgrade-from-ubuntu-1804-to-2004).
 - PgBouncer available only as Kubernetes service
 
 ### Known issues

diff --git a/docs/home/howto/OS_UPGRADE.md b/docs/home/howto/OS_UPGRADE.md
@@ -0,0 +1,8 @@
+# How to upgrade from Ubuntu 18.04 to 20.04
+
+Epiphany doesn't provide automation to perform Ubuntu release upgrade.
+
+For information about upgrading Ubuntu release, please refer to [Ubuntu documentation](https://ubuntu.com/server/docs/upgrade-introduction).
+
+For testing purposes, we use Ansible playbook ([ci/ansible/playbooks/os/ubuntu/upgrade-release.yml](../../../ci/ansible/playbooks/os/ubuntu/upgrade-release.yml)),
+however it is strongly recommended that an administrator is involved to prepare for and perform the upgrade.