Red Hat Ansible Automation Platform Operator バックアップおよびリカバリーガイド

手順

1. Red Hat OpenShift Container Platform にログインします。
2. Operators → Installed Operators に移動します。
3. Ansible Automation Platform Operator のデプロイメントを選択します。
4. Automation Controller Backup タブを選択します。
5. Create AutomationControllerBackup をクリックします。
6. バックアップの Name を入力します。
7. Deployment name フィールドに、バックアップされているデプロイされた Ansible Automation Platform インスタンスの AutomationController カスタムリソースオブジェクトの名前を入力します。この名前は、AutomationController オブジェクトの作成 時に作成されました。

8. 事前に作成したカスタムの pvc を使用する必要がある場合は、以下を行います。

   1. 必要に応じて、バックアップ永続ボリュームクレーム の名前を入力します。

   2. 必要に応じて、バックアップ PVC ストレージ要件 と バックアップ PVC ストレージクラス を入力します。

      注記

      pvc やストレージクラスが指定されていない場合は、クラスターのデフォルトのストレージクラスを使用して pvc が作成されます。

   3. 大規模なデータベースがある場合は、それに応じて、バックアップ管理 Pod のリソース要件 でストレージ要求を指定します。

      注記

      postgres Pod 内で次のコマンドを実行すると、既存の postgres データベースデータディレクトリーのサイズを確認できます。

      $ df -h | grep "/var/lib/pgsql/data"

      Copy to Clipboard Toggle word wrap

9. Create をクリックします。

   指定したデプロイメントのバックアップ tarball が作成され、データの復旧またはデプロイメントのロールバックに使用できます。今後のバックアップは、同じ pvc の別の tar ファイルに保存されます。

検証

1. Red Hat OpenShift Container Platform にログインします
2. Operators → Installed Operators に移動します。
3. Ansible Automation Platform Operator を選択します。
4. AutomationControllerBackup タブを選択します。
5. 確認するバックアップリソースを選択します。

6. Conditions までスクロールし、Successful ステータスが True であることを確認します。

   注記

   ステータスが Failure であれば、バックアップは失敗しています。問題を解決するには、Automation Controller の Operator ログでエラーを確認してください。

手順

1. 次の内容を含む "backup-awx.yml" という名前のファイルを作成します。

   ---
   apiVersion: automationcontroller.ansible.com/v1beta1
   kind: AWXBackup
   metadata:
     name: awxbackup-2024-07-15
     namespace: my-namespace
   spec:
     deployment_name: controller

   Copy to Clipboard Toggle word wrap
   注記

   上記の "deployment_name" は、バックアップ元の Automation Controller のデプロイメントの名前です。上記の namespace は、バックアップする Automation Controller デプロイメントを含む namespace です。

2. oc apply コマンドを使用して、クラスターにバックアップオブジェクトを作成します。

手順

1. Red Hat OpenShift Container Platform にログインします。
2. Operators → Installed Operators に移動します。
3. Ansible Automation Platform Operator のデプロイメントを選択します。
4. Automation Hub Backup タブを選択します。
5. Create AutomationHubBackup をクリックします。
6. バックアップの Name を入力します。
7. バックアップされているデプロイされた Ansible Automation Platform インスタンスの デプロイメント名 を入力します。たとえば、Automation Hub のバックアップが必要で、デプロイメント名が aap-hub の場合は、デプロイメント名 フィールドに 'aap-hub' と入力します。

8. 事前に作成したカスタムの pvc を使用する必要がある場合は、以下を行います。

   1. 必要に応じて、Backup persistent volume claim、Backup persistent volume claim namespace、Backup PVC storage requirements、および Backup PVC storage class の名前を入力します。
9. Create をクリックします。

手順

1. Red Hat OpenShift Container Platform にログインします。
2. Operators → Installed Operators に移動します。
3. Ansible Automation Platform Operator のデプロイメントを選択します。
4. Automation Controller Restore タブを選択します。
5. Create AutomationControllerRestore をクリックします。
6. リカバリーデプロイメントの Name を入力します。

7. 復元された配置の New Deployment name を入力します。

   注記

   これは、元のデプロイメント名とは異なる必要があります。

8. Backup source to restore from を選択します。Backup CR を推奨します。
9. AutomationControllerBackup オブジェクトの Backup Name を入力します。

10. Create をクリックします。

    新しいデプロイメントが作成され、バックアップが復元されます。データベースのサイズにもよりますが、これには約 5 ~ 15 分かかります。

検証

1. Red Hat OpenShift Container Platform にログインします
2. Operators → Installed Operators に移動します。
3. Ansible Automation Platform Operator のデプロイメントを選択します。
4. AutomationControllerRestore タブを選択します。
5. 確認する復元リソースを選択します。

6. Conditions までスクロールし、Successful ステータスが True であることを確認します。

   注記

   Successful が False の場合は、リカバリーに失敗しました。問題を解決するには、Automation Controller の Operator ログでエラーを確認してください。

1. 以下のテンプレートに従って、external-postgres-configuration-secret YAML ファイルを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: external-restore-postgres-configuration
     namespace: <target_namespace> 

   1

   
   stringData:
     host: "<external_ip_or_url_resolvable_by_the_cluster>" 

   2

   
     port: "<external_port>" 

   3

   
     database: "<desired_database_name>"
     username: "<username_to_connect_as>"
     password: "<password_to_connect_with>" 

   4

   
     sslmode: "prefer" 

   5

   
     type: "unmanaged"
   type: Opaque

   Copy to Clipboard Toggle word wrap

   1

   シークレットを作成する namespace。これは、デプロイ先の namespace と同じにする必要があります。

   2

   データベースノードの解決可能なホスト名です。

   3

   外部ポートのデフォルトは 5432 です。

   4

   変数 password の値には、デプロイ、バックアップ、または復元中の問題を回避するために、一重引用符 (')、二重引用符 (")、またはバックスラッシュ (\) を含めないでください。

   5

   変数 sslmode は、external データベースに対してのみ有効です。使用できる値は、prefer、disable、allow、require、verify-ca、および verify-full です。

2. oc create コマンドを使用して、external-postgres-configuration-secret.yml をクラスターに適用します。

   $ oc create -f external-postgres-configuration-secret.yml

   Copy to Clipboard Toggle word wrap

3. AutomationControllerRestore カスタムリソースオブジェクトを作成する際は、以下の例に従って、仕様にシークレットを指定します。

   kind: AutomationControllerRestore
   apiVersion: automationcontroller.ansible.com/v1beta1
   metadata:
     namespace: my-namespace
     name: awxrestore-2024-07-15
   spec:
     deployment_name: restored_controller
     backup_name: awxbackup-2024-07-15
     postgres_configuration_secret: 'external-restore-postgres-configuration'

   Copy to Clipboard Toggle word wrap

手順

1. Red Hat OpenShift Container Platform にログインします。
2. Operators → Installed Operators に移動します。
3. Ansible Automation Platform Operator のデプロイメントを選択します。
4. Automation Hub Restore タブを選択します。
5. Create AutomationHubRestore をクリックします。
6. リカバリーデプロイメントの Name を入力します。
7. Backup source to restore を選択します。Backup CR を推奨します。
8. AutomationHubBackup オブジェクトの Backup Name を入力します。
9. Create をクリックします。

手順

1. 既存の AutomationController と関連する postgres PVC を削除します。

   oc delete automationcontroller <YOUR_DEPLOYMENT_NAME> -n <YOUR_NAMESPACE>
   
   oc delete pvc postgres-13-<YOUR_DEPLOYMENT_NAME>-13-0 -n <YOUR_NAMESPACE>

   Copy to Clipboard Toggle word wrap

2. 同じ deployment_name で AutomationControllerRestore を使用します。

   oc apply -f restore.yaml

   Copy to Clipboard Toggle word wrap