AWS OpsWorks for Chef Automate 서버를 Chef Automate 2로 업그레이드

중요

AWS OpsWorks for Chef Automate는 더 이상 신규 고객을 받지 않습니다. 기존 고객은 서비스를 이용할 수 없게 되는 2024년 5월 5일까지 영향을 받지 않습니다. 기존 고객은 Chef SaaS 또는 대체 솔루션으로 마이그레이션하는 것이 좋습니다. 자세한 내용은 AWS OpsWorks for Chef Automate 수명 종료 관련 자주 묻는 질문 섹션을 참조하세요.

Chef Automate 2로 업그레이드하기 위한 사전 요구 사항

시작하기 전에 Chef Automate 2가 추가하는 새로운 기능과 Chef Automate 2가 지원하지 않는 기능을 이해하십시오. Chef Automate 2의 새로운 기능 및 지원되지 않는 기능에 대한 자세한 내용은 Chef 웹사이트에서 Chef Automate 2 설명서를 참조하십시오.

Chef Auto 1을 실행하는 서버는 2019년 11월 1일 이후에 유지 관리를 최소 1회 이상 성공적으로 실행했어야 업그레이드할 수 있습니다.

AWS OpsWorks for Chef Automate 서버의 유지 관리 작업과 마찬가지로 업그레이드 중에는 서버가 오프라인 상태가 됩니다. 업그레이드 프로세스 중에 최대 3시간의 가동 중지 시간을 계획해야 합니다.

Chef Automate 대시보드 웹사이트에서 이 서버에 대한 로그인 자격 증명이 필요합니다. 업그레이드가 완료되면 Chef Automate 대시보드에 로그인하여 노드 및 구성 정보가 변경되지 않았는지 확인해야 합니다.

중요

AWS OpsWorks for Chef Automate 서버를 Chef Automate 2로 업그레이드할 준비가 되면 여기에 있는 지침만 사용하여 업그레이드하십시오. AWS OpsWorks for Chef Automate는 백업 생성과 같은 많은 업그레이드 프로세스를 자동화하므로 Chef 웹사이트의 업그레이드 지침을 따르지 마십시오.

업그레이드 프로세스 정보

업그레이드 프로세스 중에는 업그레이드를 시작하기 전과 업그레이드를 완료한 후에 서버가 백업됩니다. 다음 백업이 생성됩니다.

• Chef Automate 1(버전 12.17.33)을 계속 실행 중일 때 서버의 백업.

• 업그레이드가 완료되고 서버가 Chef Automate 2(버전 2019-08)를 실행 중일 때 서버의 백업.

업그레이드 프로세스는 Chef Automate 1을 실행할 때 서버가 사용했던 Amazon EC2 인스턴스를 종료합니다. Chef Automate 2 서버를 실행하기 위해 새 인스턴스가 생성됩니다.

Chef Automate 2로 업그레이드(콘솔)

1. AWS Management Console에 로그인하고 AWS OpsWorkshttps://console.aws.amazon.com/opsworks/에서 콘솔을 엽니다.

2. 왼쪽 탐색 창에서 AWS OpsWorks for Chef Automate를 선택합니다.

3. 서버를 선택하여 해당 속성 페이지를 봅니다. 페이지 상단의 파란색 배너는 서버를 Chef Auto 2로 업그레이드할 수 있는지 여부를 나타냅니다.

   참고

   Chef Auto 1을 실행하는 서버는 2019년 11월 1일 이후에 유지 관리를 최소 1회 이상 성공적으로 실행했어야 업그레이드할 수 있습니다.

4. 서버를 업그레이드할 수 있는 경우 업그레이드 시작을 선택합니다.

5. 업그레이드에 최대 3시간이 소요됩니다. 업그레이드 프로세스 중에 속성 페이지에 서버 상태가 유지 관리 중으로 표시됩니다.

6. 업그레이드가 완료되면 속성 페이지에 Automate 2로 업그레이드 완료와 유지 관리 완료라는 두 개의 메시지가 표시됩니다. 서버 상태는 정상이어야 합니다.

7. 기존 자격 증명을 사용하여 Chef Automate 대시보드에 로그인하고 노드가 올바르게 보고되는지 확인합니다.

Chef Automate 2(CLI)로 업그레이드

1. (선택 사항) 업그레이드할 수 있는 AWS OpsWorks for Chef Automate 서버를 잘 모르는 경우 다음 명령을 실행합니다. 기본 AWS 리전과 다른 AWS 리전의 AWS OpsWorks for Chef Automate 서버를 나열하려면 --region 파라미터를 추가하십시오.

   aws opsworks-cm describe-servers

   결과에서 CHEF_MAJOR_UPGRADE_AVAILABLE 속성의 true 값을 찾습니다. 이는 서버를 Chef Auto 2로 업그레이드할 수 있음을 나타냅니다. 업그레이드에 적합한 AWS OpsWorks for Chef Automate 서버 이름을 기록해 둡니다.

2. 다음 명령을 실행하여 server_name을 AWS OpsWorks for Chef Automate 서버 이름으로 바꿉니다. 일상적인 시스템 유지 관리를 수행하는 대신 Chef Automate 2로 업그레이드하려면 명령과 같이 CHEF_MAJOR_UPGRADE 엔진 속성을 추가합니다. 대상 서버가 기본 AWS 리전에 없는 경우 --region 파라미터를 추가합니다. 명령당 하나의 서버만 업그레이드할 수 있습니다.

   aws opsworks-cm start-maintenance --server-name server_name --engine-attributes Name=CHEF_MAJOR_UPGRADE,Value=true --region region

   어떤 이유로든 AWS OpsWorks for Chef Automate에서 서버를 업그레이드할 수 없는 경우 이 명령을 실행하면 유효성 검사 예외가 발생합니다.

3. 업그레이드에 최대 3시간이 소요됩니다. 다음 명령을 실행하여 업그레이드 상태를 주기적으로 확인할 수 있습니다.

   aws opsworks-cm describe-servers --server-name server_name

   결과에서 Status 값을 찾습니다. Status가 UNDER_MAINTENANCE면 업그레이드가 아직 진행 중임을 의미합니다. 성공적으로 업그레이드하면 다음과 유사한 메시지가 반환됩니다.

   2019/10/24 00:27:56 UTC           Successfully upgraded to Automate 2.
   2019/10/23 23:50:38 UTC           Upgrading Chef server from Automate 1 to Automate 2

   업그레이드가 실패한 경우 AWS OpsWorks for Chef Automate는 자동으로 서버를 Chef Automato 1로 롤백합니다.

   업그레이드가 성공했지만 서버가 업그레이드 이전과 동일하게 작동하지 않는 경우(예: 관리형 노드가 보고되지 않는 경우) 수동으로 서버를 롤백할 수 있습니다. 수동 롤백 정보는 AWS OpsWorks for Chef Automate 서버를 Chef Automate 1(CLI)로 롤백 단원을 참조하십시오.

AWS OpsWorks for Chef Automate 서버를 Chef Automate 1(CLI)로 롤백

업그레이드 프로세스가 실패하는 경우 AWS OpsWorks for Chef Automate는 자동으로 서버를 Chef Automato 1로 롤백합니다. 업그레이드가 성공했지만 서버가 업그레이드 전과 동일하게 작동하지 않는 경우 AWS CLI를 사용하여 수동으로 AWS OpsWorks for Chef Automate 서버를 Chef Automate 1로 롤백할 수 있습니다.

1. 다음 명령을 실행하여 업그레이드를 시도하기 전에 서버에서 수행한 마지막 백업의 BackupId를 표시합니다. 서버가 기본 AWS 리전과 다른 AWS 리전에 있는 경우 --region 파라미터를 추가합니다.

   aws opsworks-cm describe-backups server_name

   백업 ID는 ServerName-yyyyMMddHHmmssSSS 형식입니다. 결과에서 다음 Chef Automate 1 속성을 찾습니다.

   "Engine": "Chef"
   "EngineVersion": "12.17.33"

2. 1단계에서 반환한 백업 ID를 --backup-id의 값으로 사용하여 다음 명령을 실행합니다.

   aws opsworks-cm restore-server --server-name server_name --backup-id ServerName-yyyyMMddHHmmssSSS

   서버에 저장된 데이터 양에 따라 서버를 복원하는 데 20분에서 3시간이 소요됩니다. 복원 작업 중에 서버의 상태는 RESTORING입니다. 이 상태는 AWS Management Console의 서버 속성 페이지에 표시되고 describe-servers 명령 결과로 반환됩니다.

3. 복원이 완료되면 복원 완료 메시지가 콘솔에 표시됩니다. AWS OpsWorks for Chef Automate 서버가 온라인 상태이며 업그레이드 프로세스를 시작하기 전과 동일합니다.

참고 항목

• AWS OpsWorks for Chef Automate의 시스템 유지 관리

• 백업에서 AWS OpsWorks for Chef Automate 서버 복원

• AWS OpsWorks API 참조의 DescribeServers

• AWS OpsWorks API 참조의 StartMaintenance