From f0f0d8de8ff4be09a39eac5017482e59009f00af Mon Sep 17 00:00:00 2001 From: kurokobo <2920259+kurokobo@users.noreply.github.com> Date: Thu, 12 Oct 2023 16:49:25 +0900 Subject: [PATCH] docs: add notes for restoration on 2.7.0 --- README.md | 4 ++++ restore/README.md | 2 +- tips/upgrade-operator.md | 4 ++++ 3 files changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 40bd796..edf2d3c 100644 --- a/README.md +++ b/README.md @@ -88,6 +88,10 @@ Clone this repository and change directory. If you want to use files suitable for the specific version of AWX Operator, [refer tags in this repository](https://github.com/kurokobo/awx-on-k3s/tags) and specify desired tag in `git checkout`. Especially for `0.13.0` or earlier version of AWX Operator, refer to [📝Tips: Deploy older version of AWX Operator](tips/deploy-older-operator.md). +**⚠️Note for 2.7.0⚠️** + +**AWX Operator 2.7.0 has a bug that restoration using backup files directly instead of using AWXBackup object will fail ([#1586](https://github.com/ansible/awx-operator/issues/1586)). If you want to use this method to restore your AWX, you should avoid to use 2.7.0.** + ```bash cd ~ git clone https://github.com/kurokobo/awx-on-k3s.git diff --git a/restore/README.md b/restore/README.md index 96ff24c..12532fc 100644 --- a/restore/README.md +++ b/restore/README.md @@ -73,7 +73,7 @@ If you want to restore from AWXBackup object, specify its name in `restore/awxre ... ``` -If the AWXBackup object no longer exists, place the backup files and specify the name of the PVC and directory in `restore/awxrestore.yaml`. +If the AWXBackup object no longer exists, place the backup files under `/data/backup/` (e.g. `/data/backup/tower-openshift-backup-2021-06-06-10:51:49`) and specify the name of the PVC and directory in `restore/awxrestore.yaml`. **⚠️This method does not work on AWX Operator 2.7.0 due to [#1586](https://github.com/ansible/awx-operator/issues/1586).** ```yaml ... diff --git a/tips/upgrade-operator.md b/tips/upgrade-operator.md index 2573bce..51462b8 100644 --- a/tips/upgrade-operator.md +++ b/tips/upgrade-operator.md @@ -11,6 +11,10 @@ Note that once you upgrade AWX Operator, your AWX will also be upgraded automati [There is `image_version` parameter for AWX resource to change which image will be used](https://ansible.readthedocs.io/projects/awx-operator/en/latest/user-guide/advanced-configuration/deploying-a-specific-version-of-awx.html), but it appears that using a version of AWX other than the one bundled with the AWX Operator [is currently not supported](https://ansible.readthedocs.io/projects/awx-operator/en/latest/user-guide/advanced-configuration/deploying-a-specific-version-of-awx.html). Conversely, if you want to upgrade AWX, you need to plan to upgrade AWX Operator first. +**⚠️Note for 2.7.0⚠️** + +**AWX Operator 2.7.0 has a bug that restoration using backup files directly instead of using AWXBackup object will fail ([#1586](https://github.com/ansible/awx-operator/issues/1586)). If you want to use this method to restore your AWX, you should avoid to use 2.7.0.** + ## Table of Contents