第9章 バックアップおよび復元

手順

1. 基盤デプロイメントとタグのバージョンが同じ ansible-on-clouds-ops コンテナーイメージをプルします。

   注記

   Docker イメージをプルする前に、Docker を使用して registry.redhat.io にログインしていることを確認してください。以下のコマンドを使用して registry.redhat.io にログインします。

   $ docker login registry.redhat.io

   Copy to Clipboard Toggle word wrap

   レジストリーのログインに関する詳細は、Registry Authentication を参照してください。

   $ export IMAGE=registry.redhat.io/ansible-on-clouds/ansible-on-clouds-ops-rhel9:2.4.20230630
   $ docker pull $IMAGE --platform=linux/amd64

   Copy to Clipboard Toggle word wrap

手順

1. 設定を保存するフォルダーを作成します。

   $ mkdir command_generator_data

   Copy to Clipboard Toggle word wrap

2. command_generator_data フォルダーに設定ファイルのテンプレートを追加します。これにより、command-generator_data ディレクトリー内に backup.yml ファイルが作成されます。

   注記

   Linux では、コマンドジェネレーターが作成したファイルまたはディレクトリーは、デフォルトで root:root の所有となります。ファイルとディレクトリーの所有権を変更するには、ファイルの作成後に sudo chmod コマンドを実行します。詳細は、コマンドジェネレーター - root が所有する Linux ファイル を参照してください。

   $ docker run --rm -v $(pwd)/command_generator_data:/data $IMAGE \
     command_generator_vars aws_backup_stack \
     --output-data-file /data/backup.yml

   Copy to Clipboard Toggle word wrap

3. これらのコマンドを実行すると、$(pwd)/command_generator_data/backup.yml テンプレートファイルが作成されます。このテンプレートファイルは以下のようになります。

   aws_backup_stack:
     ansible_config_path:
     cloud_credentials_path:
     deployment_name:
     extra_vars:
       aws_backup_iam_role_arn:
       aws_backup_vault_name: Default
       aws_region:
       aws_s3_bucket:
       aws_ssm_bucket_name:
       backup_prefix: aoc-backup

   Copy to Clipboard Toggle word wrap

手順

1. バックアップを実行するために、コマンドジェネレーターを実行します。

   $ docker run --rm -v $(pwd)/command_generator_data:/data $IMAGE command_generator aws_backup_stack --data-file /data/backup.yml

   Copy to Clipboard Toggle word wrap

   これにより、バックアップ CLI コマンドが生成されます。

   ----------------------------------------------
   docker run --rm --env PLATFORM=AWS -v ~/.aws/credentials:/home/runner/.aws/credentials:ro \
   --env ANSIBLE_CONFIG=../aws-ansible.cfg --env DEPLOYMENT_NAME=AnsibleAutomationPlatform --env GENERATE_INVENTORY=true  \
   $IMAGE redhat.ansible_on_clouds.aws_backup_stack \
   -e 'aws_foundation_stack_name=AnsibleAutomationPlatform aws_region=us-east-1 aws_backup_vault_name=Default \
   aws_backup_iam_role_arn=arn:aws:iam::<Your AWS Account Number>:role/service-role/AWSBackupDefaultServiceRole \
   aws_s3_bucket=ansible-automation-platform-bucket aws_ssm_bucket_name=aap-ssm-bucket backup_prefix=aoc-backup'
   ===============================================

   Copy to Clipboard Toggle word wrap

2. 生成されたコマンドを実行してバックアップをトリガーします。

   $ docker run --rm --env PLATFORM=AWS -v ~/.aws/credentials:/home/runner/.aws/credentials:ro \
   --env ANSIBLE_CONFIG=../aws-ansible.cfg --env DEPLOYMENT_NAME=AnsibleAutomationPlatform --env GENERATE_INVENTORY=true  \
   $IMAGE redhat.ansible_on_clouds.aws_backup_stack \
   -e 'aws_foundation_stack_name=AnsibleAutomationPlatform aws_region=us-east-1 aws_backup_vault_name=Default \
   aws_backup_iam_role_arn=arn:aws:iam::<Your AWS Account Number>:role/service-role/AWSBackupDefaultServiceRole \
   aws_s3_bucket=ansible-automation-platform-bucket aws_ssm_bucket_name=aap-ssm-bucket backup_prefix=aoc-backup'

   Copy to Clipboard Toggle word wrap

3. データベースのサイズによっては、バックアップが完了するまでに数分かかる場合があります。バックアップが成功すると、次のようなログが返されます。

   {
       "msg": [
           "Successfully backed up AnsibleAutomationPlatform!",
           "Please note below the bucket name, region and backup name which are required for restore process.",
           "aws_s3_bucket: ansible-automation-platform-bucket ",
           "aws_region: us-east-1",
           "aws_backup_name: ansible-automation-platform-bucket-20230706T163309",
           "Your backup files can be found at:",
           "https://s3.console.aws.amazon.com/s3/buckets/ansible-automation-platform-bucket?region=us-east-1&prefix=aoc-backup-AnsibleAutomationPlatform-20230706T163309/&showversions=false"
       ]
   }

   Copy to Clipboard Toggle word wrap
4. これで、Ansible Automation Platform from AWS Marketplace デプロイメントが正常にバックアップされました。ログに示されているように、Playbook は上で指定した S3 バケットにバックアップフォルダーを正常に作成します。

手順

1. command_generator_data ディレクトリーに設定ファイルのテンプレートを追加します。

   注記

   Linux では、コマンドジェネレーターが作成したファイルまたはディレクトリーは、デフォルトで root:root の所有となります。ファイルとディレクトリーの所有権を変更するには、ファイルの作成後に sudo chmod コマンドを実行します。詳細は、コマンドジェネレーター - root が所有する Linux ファイル を参照してください。

   docker run --rm -v $(pwd)/command_generator_data/:/data $IMAGE command_generator_vars aws_backups_delete --output-data-file /data/backups_delete.yml

   Copy to Clipboard Toggle word wrap

   このコマンドを実行すると以下が出力されます。

   ===============================================
   Playbook: aws_backups_delete
   Description: This playbook delete a specified backup.
   -----------------------------------------------
   This playbook delete a specified backup
   
   -----------------------------------------------
   Command generator template:
   
   docker run --rm -v <local_data_file_directory>:/data $IMAGE command_generator aws_backups_delete --data-file /data/backups_delete.yml

   Copy to Clipboard Toggle word wrap

2. コマンドを実行すると、$(pwd)/command_generator_data/backups_delete.yml テンプレートファイルが作成されます。このテンプレートファイルは以下のようになります。

   aws_backups_delete:
     cloud_credentials_path:
     extra_vars:
       aws_backup_names:
       aws_region:
       aws_s3_bucket:
       delete:

   Copy to Clipboard Toggle word wrap

1. バックアップを削除するには、コマンドジェネレーターを実行して aws_backups_delete コマンドを生成します。

   docker run --rm -v $(pwd)/command_generator_data:/data $IMAGE command_generator aws_backups_delete --data-file /data/backups_delete.yml

   Copy to Clipboard Toggle word wrap

   その結果、次の出力が得られます。

   Command to run playbook:
   
   docker run --rm --env PLATFORM=AWS -v ~/.aws/credentials:/home/runner/.aws/credentials:ro \
   --env ANSIBLE_CONFIG=../aws-ansible.cfg  $IMAGE redhat.ansible_on_clouds.aws_backups_delete \
   -e 'aws_region=<region> aws_s3_bucket=<bucket> aws_backup_names=["backup1","backup2"] delete=True'
   ===============================================

   Copy to Clipboard Toggle word wrap
2. 提供されたバックアップコマンドを実行してバックアップを削除します。

3. Playbook の実行が完了すると、出力は次のようになります。

   TASK [redhat.ansible_on_clouds.standalone_aws_backup_delete : [delete_backup] Dry-run message] ***
   skipping: [localhost]
   
   PLAY RECAP *********************************************************************
   localhost                  : ok=21   changed=2    unreachable=0    failed=0    skipped=2    rescued=0    ignored=0

   Copy to Clipboard Toggle word wrap