Red Hat Ansible Automation Platform Operator 백업 및 복구 가이드

Red Hat Ansible Automation Platform 2.4

OpenShift Container Platform에서 Ansible Automation Platform Operator의 백업 및 복구로 데이터 손실 방지

Red Hat Customer Content Services

초록

이 가이드에서는 OpenShift Container Platform의 Red Hat Ansible Automation Platform Operator의 백업 및 복구를 위한 절차 및 참조 정보를 제공합니다.

머리말

Red Hat Ansible Automation Platform에 관심을 가져 주셔서 감사합니다. Ansible Automation Platform은 Ansible 기반 환경에 제어, 지식, 위임을 추가하여 팀이 복잡한 다중 계층 배포를 관리하는 데 도움이 되는 상용 서비스입니다.

이 가이드의 절차를 사용하여 오류가 발생할 경우 Red Hat Ansible Automation Platform 배포를 복구하는 데 사용할 수 있는 백업 리소스를 생성합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지를 참조하십시오.

Red Hat 문서에 관한 피드백 제공

Red Hat의 기술 콘텐츠에 대한 귀하의 피드백에 감사드리며, 귀하가 생각하는 것을 알려 주시기 바랍니다. 주석을 추가하거나, 인사이트를 제공하거나, 오타를 수정하거나, 질문을 하려면 문서에서 직접 이 작업을 수행할 수 있습니다.

참고

Red Hat 계정이 있어야 하며 고객 포털에 로그인해야 합니다.

고객 포털에서 문서 피드백을 제출하려면 다음을 수행하십시오.

  1. 다중 페이지 HTML 형식을 선택합니다.
  2. 문서 오른쪽 상단에 있는 피드백 버튼을 클릭합니다.
  3. 피드백을 제공하려는 텍스트 섹션을 강조 표시합니다.
  4. 강조 표시된 텍스트 옆에 있는 피드백 추가 대화 상자를 클릭합니다.
  5. 페이지 오른쪽에 있는 텍스트 상자에 피드백을 입력한 다음 제출을 클릭합니다.

피드백을 제출할 때마다 추적 문제가 자동으로 생성됩니다. Submit 을 클릭한 후 표시되는 링크를 열고 문제 모니터링을 시작하거나 의견을 더 추가합니다.

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_KEY,admin_password, broadcast_websocket 시크릿
  • 데이터베이스 구성
참고

중요한 정보를 포함할 수 있으므로 백업 리소스를 보호하십시오.

1.1.1. 백업 권장 사항

데이터 손실에서 복구하려면 정기적으로 Red Hat Ansible Automation Platform 배포의 백업 리소스를 계획하고 생성해야 합니다. 최소한 Red Hat은 다음과 같은 상황에서 Red Hat Ansible Automation Platform 배포를 백업할 것을 권장합니다.

  • Red Hat Ansible Automation Platform 배포를 업그레이드하기 전에
  • Openshift 클러스터를 업그레이드하기 전에
  • 일주일에 한 번. 이는 환경이 자동 업그레이드용으로 구성된 경우 특히 중요합니다.

2장. Red Hat Ansible Automation Platform 백업 리소스 생성

Red Hat Ansible Automation Platform 배포를 백업하려면 배포된 자동화 허브 및 자동화 컨트롤러 인스턴스를 위한 백업 리소스를 생성해야 합니다. Red Hat Ansible Automation Platform 배포를 위한 백업 리소스를 생성하려면 다음 절차를 사용하십시오.

2.1. 자동화 컨트롤러 배포 백업

작업, 인벤토리, 인증 정보를 포함하여 컨트롤러 배포를 백업하려면 다음 절차를 사용하십시오.

사전 요구 사항

  • Openshift 클러스터로 인증해야 합니다.
  • Ansible Automation Platform Operator가 클러스터에 설치되었습니다.
  • 자동화 컨트롤러는 Ansible Automation Platform Operator를 사용하여 에 배포됩니다.

절차

  1. Red Hat OpenShift Container Platform 에 로그인합니다.
  2. Operators(운영자) InstalledOperators 로 이동합니다.
  3. 프로젝트 네임스페이스에 설치된 Ansible Automation Platform Operator를 선택합니다.
  4. 자동화 컨트롤러 백업 탭을 선택합니다.
  5. AutomationControllerBackup 생성 을 클릭합니다.
  6. 백업 의 이름을 입력합니다.
  7. 백업 중인 배포된 Ansible Automation Platform 인스턴스의 배포 이름을 입력합니다. 예를 들어 자동화 컨트롤러를 백업하고 배포 이름이 aap-controller 인 경우 배포 이름 필드에 'aap-controller'를 입력합니다.

  8. 사용자 지정, 사전 생성된 pvc를 사용하려면 다음을 수행합니다.

    1. 필요한 경우 Backup persistant 볼륨 클레임 의 이름을 입력합니다.

    2. 필요한 경우 Backup PVC 스토리지 요구 사항 및 Backup PVC 스토리지 클래스 를 입력합니다.

      참고

      pvc 또는 스토리지 클래스가 제공되지 않으면 클러스터의 기본 스토리지 클래스가 pvc를 생성하는 데 사용됩니다.

    3. 대규모 데이터베이스가 있는 경우 Backup 관리 Pod 리소스 요구 사항에 따라 스토리지 요청을 지정합니다.

      참고

      postgres Pod 내에서 다음 명령을 실행하여 기존 postgres 데이터베이스 데이터 디렉터리의 크기를 확인할 수 있습니다. 

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

  9. 생성을 클릭합니다.

    지정된 배포의 백업 tarball이 생성되고 데이터 복구 또는 배포 롤백에 사용할 수 있습니다. 향후 백업은 동일한 pvc의 별도의 tar 파일에 저장됩니다.

2.2. 자동화 허브 배포 백업

모든 호스팅된 Ansible 콘텐츠를 포함하여 허브 배포를 백업하려면 다음 절차를 사용하십시오.

사전 요구 사항

  • Openshift 클러스터로 인증해야 합니다.
  • Ansible Automation Platform Operator가 클러스터에 설치되었습니다.
  • 자동화 허브는 Ansible Automation Platform Operator를 사용하는 데 배포됩니다.

절차

  1. Red Hat OpenShift Container Platform 에 로그인합니다.
  2. Operators(운영자) InstalledOperators 로 이동합니다.
  3. 프로젝트 네임스페이스에 설치된 Ansible Automation Platform Operator를 선택합니다.
  4. Automation Hub Backup 탭을 선택합니다.
  5. AutomationHubBackup 생성 을 클릭합니다.
  6. 백업 의 이름을 입력합니다.
  7. 백업 중인 배포된 Ansible Automation Platform 인스턴스의 배포 이름을 입력합니다. 예를 들어 자동화 허브를 백업하고 배포 이름이 aap-hub 인 경우 배포 이름 필드에 'aap-hub'를 입력합니다.

  8. 사용자 지정, 사전 생성된 pvc를 사용하려면 다음을 수행합니다.

    1. 필요한 경우 Backup 영구 볼륨 클레임, Backup 영구 볼륨 클레임 네임스페이스, 백업 PVC 스토리지 요구 사항 및 Backup PVC 스토리지 클래스 를 입력합니다.

  9. 생성을 클릭합니다.

    지정된 배포의 백업이 생성되고 데이터 복구 또는 배포 롤백에 사용할 수 있습니다.

3장. Red Hat Ansible Automation Platform 배포 복구

시스템에 대한 정보나 업그레이드 관련 문제가 손실되는 경우 배포 인스턴스의 백업 리소스를 사용할 수 있습니다. 이러한 절차를 사용하여 자동화 컨트롤러 및 자동화 허브 배포 파일을 복구하십시오.

3.1. 자동화 컨트롤러 배포 복구

AutomationControllerBackup에서 이전 컨트롤러 배포를 복원하려면 다음 절차를 사용하십시오. 제공하는 배포 이름은 생성될 새 AutomationController 사용자 정의 리소스의 이름이 됩니다.

참고

새 AutomationController 사용자 지정 리소스에 지정된 이름이 기존 배포와 일치하지 않아야 합니다. 그렇지 않으면 복구 프로세스가 실패합니다. 지정된 이름이 기존 배포와 일치하는 경우 문제 해결 단계를 참조하십시오.

사전 요구 사항

  • Openshift 클러스터로 인증해야 합니다.
  • 자동화 컨트롤러가 클러스터에 배포되었습니다.
  • AutomationControllerBackup은 클러스터의 PVC에서 사용할 수 있습니다.

절차

  1. Red Hat OpenShift Container Platform 에 로그인합니다.
  2. Operators(운영자) InstalledOperators 로 이동합니다.
  3. 프로젝트 네임스페이스에 설치된 Ansible Automation Platform Operator를 선택합니다.
  4. 자동화 컨트롤러 복원 탭을 선택합니다.
  5. AutomationControllerRestore 생성 을 클릭합니다.
  6. 복구 배포 의 이름을 입력합니다.

  7. 복원된 배포의 새 배포 이름을 입력합니다.

    참고

    이는 원래 배포 이름과 달라야 합니다.

  8. 복원할 백업 소스를 선택합니다. Backup CR 을 사용하는 것이 좋습니다.
  9. AutomationControllerBackup 오브젝트의 Backup Name 을 입력합니다.

  10. 생성을 클릭합니다.

    새 배포가 생성되고 백업이 복원됩니다. 데이터베이스 크기에 따라 약 5~15분이 걸릴 수 있습니다.

3.2. 자동화 허브 배포 복구

이전 허브 배포를 네임스페이스에 복원하려면 다음 절차를 사용하십시오. 제공하는 배포 이름은 생성될 새 AutomationHub 사용자 정의 리소스의 이름이 됩니다.

참고

새 AutomationHub 사용자 지정 리소스에 지정된 이름이 기존 배포와 일치하지 않아야 합니다. 그렇지 않으면 복구 프로세스가 실패합니다.

사전 요구 사항

  • Openshift 클러스터로 인증해야 합니다.
  • 자동화 허브가 클러스터에 배포되었습니다.
  • AutomationHubBackup은 클러스터의 PVC에서 사용할 수 있습니다.

절차

  1. Red Hat OpenShift Container Platform 에 로그인합니다.
  2. Operators(운영자) InstalledOperators 로 이동합니다.
  3. 프로젝트 네임스페이스에 설치된 Ansible Automation Platform Operator를 선택합니다.
  4. Automation Hub Restore 탭을 선택합니다.
  5. AutomationHubRestore 생성 을 클릭합니다.
  6. 복구 배포 의 이름을 입력합니다.
  7. 복원할 백업 소스를 선택합니다. Backup CR 을 사용하는 것이 좋습니다.
  8. AutomationHub Backup 오브젝트의 백업 이름을 입력합니다.

  9. 생성을 클릭합니다.

    새 배포가 생성되고 백업이 복원됩니다.

4장. 문제 해결

이 정보를 사용하여 백업 및 복구 중에 문제를 진단하고 해결합니다.

4.1. 자동화 컨트롤러 사용자 정의 리소스에는 기존 배포와 동일한 이름이 있습니다.

새 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>

  2. 동일한 deployment_name으로 AutomationControllerRestore를 사용합니다. 

    oc apply -f restore.yaml

법적 공지

Copyright © 2023 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.