Operator 環境のバックアップとリカバリー


Red Hat Ansible Automation Platform 2.5

OpenShift Container Platform 上の Ansible Automation Platform Operator のバックアップとリカバリーによりデータ損失を保護する

Red Hat Customer Content Services

概要

このガイドでは、OpenShift Container Platform で Red Hat Ansible Automation Platform オペレーターのインストールをバックアップおよびリカバリーするための手順と参照情報を提供します。

はじめに

Red Hat Ansible Automation Platform に興味をお持ちいただきありがとうございます。Ansible Automation Platform は、Ansible を装備した環境に、制御、ナレッジ、委譲の機能を追加して、チームが複雑かつ複数層のデプロイメントを管理できるように支援する商用サービスです。

このガイドの手順を使用して、障害が発生した場合に Red Hat Ansible Automation Platform デプロイメントを復旧するために使用できるバックアップリソースを作成します。

Red Hat ドキュメントへのフィードバック (英語のみ)

このドキュメントの改善に関するご意見がある場合や、エラーを発見した場合は、https://access.redhat.com から Technical Support チームに連絡してください。

第1章 Red Hat Ansible Automation Platform のバックアップと復元

予期しないデータ損失やアプリケーションエラーから保護するには、Red Hat Ansible Automation Platform デプロイメントの定期的なバックアップを実行することが重要です。データ損失の防止に加えて、バックアップを使用すると、別のデプロイメント状態にフォールバックできます。

1.1. バックアップおよびリカバリーについて

Red Hat は、データの損失を防ぐために、Red Hat OpenShift Container Platform 環境で Red Hat Ansible Automation Platform のデプロイメントをバックアップすることが推奨されます。

Red Hat Ansible Automation Platform デプロイメントのバックアップリソースには、以下が含まれます。

  • Ansible Automation Platform カスタムリソースオブジェクトの spec セクションに含まれる特定の値のカスタムデプロイメント
  • postgresql データベースのバックアップ
  • secret_keyadmin_password、および broadcast_websocket シークレット
  • データベースの設定
注記

機密情報が含まれている可能性があるため、バックアップリソースを必ず保護してください。

1.1.1. バックアップの推奨事項

データ損失から復旧するには、定期的に Red Hat Ansible Automation Platform デプロイメントのバックアップリソースを計画して作成する必要があります。少なくとも、Red Hat は、以下の状況で Red Hat Ansible Automation Platform のデプロイメントをバックアップすることを推奨しています。

  • Red Hat Ansible Automation Platform デプロイメントをアップグレードする前
  • OpenShift クラスターをアップグレードする前
  • 1 週間に 1 回。これは、環境が自動アップグレード用に設定されている場合に特に重要です。

第2章 Red Hat Ansible Automation Platform バックアップリソースの作成

Red Hat Ansible Automation Platform デプロイメントをバックアップするには、デプロイされたインスタンスのバックアップリソースを作成する必要があります。以下の手順を使用して、Red Hat Ansible Automation Platform デプロイメントのバックアップリソースを作成します。Ansible Automation Platform Operator をアップグレードする前に、バックアップを作成することが推奨されます。プラットフォームを以前の状態に復元する場合に備えて、定期的にバックアップを作成してください。

2.1. Ansible Automation Platform デプロイメントのバックアップ

予期しないデータ損失やアプリケーションエラーから保護するために、Ansible Automation Platform のデプロイメントを定期的にバックアップすることが重要です。Ansible Automation Platform は、有効なコンポーネント (Automation Controller、Automation Hub、Event-Driven Ansible など) をホストします。Ansible Automation Platform をバックアップすると、Operator によってこれらのコンポーネントもバックアップされます。

注記

Ansible Automation Platform Operator は、Ansible Automation Platform バックアップ用の PersistentVolumeClaim (PVC) を自動的に作成します。backup_pvc 仕様を使用して PVC を指定することにより、事前に作成した独自の PVC を使用できます。

前提条件

  • OpenShift クラスターで認証されている。
  • クラスターに Ansible Automation Platform Operator をインストールした。
  • Ansible Automation Platform Operator を使用して Ansible Automation Platform インスタンスをデプロイした。

手順

  1. Red Hat OpenShift Container Platform にログインします。
  2. OperatorsInstalled Operators に移動します。
  3. Ansible Automation Platform Operator のデプロイメントを選択します。
  4. All Instances タブに移動し、Create New をクリックします。
  5. リストから Ansible Automation Platform Backup を選択します。

    注記

    Ansible Automation Platform Backup リソースを作成すると、ネストされた有効な各コンポーネントのバックアップリソースも作成されます。

  6. Name フィールドにバックアップの名前を入力します。
  7. Deployment name フィールドに、バックアップ対象のデプロイ済み Ansible Automation Platform インスタンスの名前を入力します。たとえば、Ansible Automation Platform のデプロイメントをバックアップする必要があり、デプロイメント名が 'aap' である場合は、Deployment name フィールドに aap と入力します。
  8. Create をクリックします。これにより、次のような AnsibleAutomationPlatformBackup リソースが作成されます。

    apiVersion: aap.ansible.com/v1alpha1
    kind: AnsibleAutomationPlatformBackup
    metadata:
      name: backup
      namespace: aap
    spec:
      no_log: true
      deployment_name: aap
    Copy to Clipboard Toggle word wrap

    検証

    バックアップが成功したかどうかを確認するには、次の手順を実行します。

  9. Red Hat OpenShift Container Platform にログインします。
  10. OperatorsInstalled Operators に移動します。
  11. Ansible Automation Platform Operator のデプロイメントを選択します。
  12. All Instances をクリックします。

All Instances ページには、メインのバックアップと、バックアップリソースの作成時に指定した名前を持つ各コンポーネントのバックアップが表示されます。次のインスタンスのステータスが、Running または Successful のいずれかである必要があります。

  • AnsibleAutomationPlatformBackup
  • AutomationControllerBackup
  • EDABackup
  • AutomationHubBackup

第3章 Red Hat Ansible Automation Platform デプロイメントの復元

システムに関する情報を失ったり、アップグレードで問題が発生したりした場合は、デプロイインスタンスのバックアップリソースを使用できます。Ansible Automation Platform デプロイメントファイルを復元するには、次の手順を使用します。

3.1. Ansible Automation Platform デプロイメントの復元

Ansible Automation Platform は、有効なコンポーネント (Automation Controller、Automation Hub、Event-Driven Ansible など) を管理します。Ansible Automation Platform を復元すると、これらのコンポーネントも復元されます。

以前のバージョンの Ansible Automation Platform Operator では、プラットフォームの各コンポーネントごとに復元オブジェクトを作成する必要がありました。このバージョンでは、1 つの AnsibleAutomationPlatformRestore リソースを作成します。これにより、以下の他の復元オブジェクトを作成および管理します。

  • AutomationControllerRestore
  • AutomationHubRestore
  • EDARestore

前提条件

  • OpenShift クラスターで認証されている。
  • クラスターに Ansible Automation Platform Operator をインストールした。
  • クラスターで AnsibleAutomationPlatformBackups デプロイメントが利用できる。

手順

  1. Red Hat OpenShift Container Platform にログインします。
  2. OperatorsInstalled Operators に移動します。
  3. Ansible Automation Platform Operator のデプロイメントを選択します。
  4. All Instances タブに移動し、Create New をクリックします。
  5. リストから Ansible Automation Platform Restore を選択します。
  6. Name にリカバリーデプロイメントの名前を入力します。
  7. New Ansible Automation Platform Name に、Ansible Automation Platform インスタンスの新しい名前を入力します。
  8. Backup Source のデフォルトは CR です。
  9. Backup name に、バックアップの作成時に選択した名前を入力します。
  10. Create をクリックします。

検証

AnsibleAutomationPlatformRestores タブでバックアップの復元が開始します。

注記

すべてのリソースが正常に復元されるまで、復元は完了しません。データベースのサイズによっては、時間がかかる場合があります。

回復が成功したかどうかを確認するには、次の手順を実行します。

  1. WorkloadsPods に移動します。
  2. すべての Pod が Running または Completed 状態であることを確認します。

3.2. PVC からの Ansible Automation Platform デプロイメントの復元

永続ボリューム要求 (PVC) は、Automation Hub および Automation Controller アプリケーションのデータを保存するストレージボリュームです。この PVC はアプリケーションから独立しており、アプリケーションが削除されても残ります。Ansible Automation Platform バックアップから回復する代わりに、PVC からデータを復元できます。

詳細は、OpenShift Container Platform へのインストール ガイドの PVC の検索および削除 セクションを参照してください。

前提条件

  • バックアップを含む既存の PVC がある。
  • Red Hat OpenShift Container Platform に Ansible Automation Platform Operator をインストールした。

手順

  1. Red Hat OpenShift Container Platform にログインします。
  2. OperatorsInstalled Operators に移動します。
  3. Ansible Automation Platform Operator のデプロイメントを選択します。
  4. All Instances タブに移動し、Create New をクリックします。
  5. リストから Ansible Automation Platform Restore を選択します。
  6. Name にリカバリーデプロイメントの名前を入力します。
  7. New Ansible Automation Platform Name に、Ansible Automation Platform インスタンスの新しい名前を入力します。
  8. Backup SourcePVC を選択します。

    1. Backup PVC: PVC の名前を入力します。
    2. Backup Directory: PVC 上のバックアップディレクトリーへのパスを入力します。
  9. Backup name に、バックアップの作成時に選択した名前を入力します。
  10. YAML view に次の例を貼り付けます。

    ---
    apiVersion: aap.ansible.com/v1alpha1
    kind: AnsibleAutomationPlatformRestore
    metadata:
      name: aap
    spec:
      deployment_name: aap
      backup_source: PVC
      backup_pvc: aap-backup-claim
      backup_dir: '/backups/aap-openshift-backup-2025-06-23-18:28:29'
    
      controller:
        backup_source: PVC
        backup_pvc: aap-controller-backup-claim
        backup_dir: '/backups/tower-openshift-backup-2025-06-23-182910'
    
      hub:
        backup_source: PVC
        backup_pvc: aap-hub-backup-claim
        backup_dir: '/backups/openshift-backup-2025-06-23-182853'
        storage_type: file
    
      eda:
        backup_source: PVC
        backup_pvc: aap-eda-backup-claim
        backup_dir: '/backups/eda-openshift-backup-2025-06-23-18:29:11'
    Copy to Clipboard Toggle word wrap
  11. Create をクリックします。

検証

AnsibleAutomationPlatformRestores タブでバックアップが復元されます。

注記

すべてのリソースが正常に復元されるまで、復元は完了しません。データベースのサイズによっては、時間がかかる場合があります。

  1. WorkloadsPods に移動します。
  2. すべての Pod が Running または Completed 状態であることを確認します。

3.3. 外部データベースからの Ansible Automation Platform デプロイメントの復元

Operator を使用して、Red Hat OpenShift Container Platform 上の外部データベースを復元できます。外部データベースから復元するには、次の手順を使用します。

重要

外部データベースから復元すると、データベースが強制的に削除され、既存の外部データベースがオーバーライドされます。

前提条件

  • 外部データベースがある。
  • OpenShift Container Platform に Ansible Automation Platform Operator をインストールした。

手順

  1. Red Hat OpenShift Container Platform にログインします。
  2. OperatorsInstalled Operators に移動します。
  3. Ansible Automation Platform Operator のデプロイメントを選択します。
  4. All Instances タブに移動し、Create New をクリックします。
  5. リストから Ansible Automation Platform Restore を選択します。
  6. Name にリカバリーデプロイメントの名前を入力します。
  7. New Ansible Automation Platform Name に、Ansible Automation Platform インスタンスの新しい名前を入力します。

    • 同じ名前の Ansible Automation Platform に復元する場合は、復元時にデータベースを削除するために force_drop_db: true を追加する必要があります。
  8. Backup Source のデフォルトは CR です。
  9. Backup name に、バックアップの作成時に選択した名前を入力します。YAML view に次の例を貼り付けます。

    ---
    apiVersion: aap.ansible.com/v1alpha1
    kind: AnsibleAutomationPlatformRestore
    metadata:
      name: aaprestore
    spec:
      deployment_name: aap
      backup_name: aapbackup
      controller:
        force_drop_db: true
    Copy to Clipboard Toggle word wrap
  10. Create をクリックします。

検証

AnsibleAutomationPlatformRestores タブでバックアップの復元が開始します。

注記

すべてのリソースが正常に復元されるまで、復元は完了しません。データベースのサイズによっては、時間がかかる場合があります。

回復が成功したかどうかを確認するには、次の手順を実行します。

  1. WorkloadsPods に移動します。
  2. すべての Pod が Running または Completed 状態であることを確認します。

第4章 トラブルシューティング

この情報を使用して、バックアップおよびリカバリー中の問題を診断および解決します。

4.1. Automation controller のカスタムリソースの名前が既存のデプロイと同じ場合

新しい AutomationController カスタムリソースに指定された名前は、既存のデプロイと一致しない必要があります。そうしないと、復旧プロセスが失敗します。

AutomationController カスタマーリソースが既存のデプロイメントと一致する場合は、次の手順を実行して問題を解決します。

手順

  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

法律上の通知

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat