AWS OpsWorks for Chef Automate サーバーを Chef Automate 2 にアップグレードする

にサインイン AWS Management Console し、https://console.aws.amazon.com/opsworks/ で AWS OpsWorks コンソールを開きます。

左側のナビゲーションペインで、[AWS OpsWorks for Chef Automate] を選択します。

サーバーを選択して、そのプロパティページを表示します。ページの上部にある青いバナーは、サーバーが Chef Automate 2 へのアップグレード対象であるかどうかを示します。

サーバーがアップグレード対象である場合は、[Start upgrade] を選択します。

アップグレードには最大 3 時間かかります。アップグレードプロセス中は、プロパティページにサーバーのステータスとして [Under maintenance] と表示されます。

アップグレードが完了すると、プロパティページにメッセージとして、[Successfully upgraded to Automate 2] と [Maintenance completed successfully] の 2 つが表示されます。サーバーのステータスは [HEALTHY] となります。

既存の認証情報を使用して Chef Automate ダッシュボードにサインインし、ノードが正しくレポートすることを確認します。

（オプション) アップグレードの対象となる AWS OpsWorks for Chef Automate サーバーがわからない場合は、次のコマンドを実行します。デフォルトの AWS リージョンとは異なる AWS リージョンの AWS OpsWorks for Chef Automate サーバーを一覧表示する場合は、必ず --regionパラメータを追加してください。

aws opsworks-cm describe-servers

表示された結果で、true 属性の値が CHEF_MAJOR_UPGRADE_AVAILABLE であるものを探します。これは、サーバーが Chef Automate 2 へのアップグレード対象であることを示します。アップグレードの対象となる AWS OpsWorks for Chef Automate サーバーの名前を書き留めます。

server_name をサーバーの名前に置き換えて、次のコマンドを実行します AWS OpsWorks for Chef Automate 。定期的なシステムメンテナンスを実行せずに Chef Automate 2 にアップグレードする場合は、コマンドに示すように CHEF_MAJOR_UPGRADE エンジン属性を追加します。ターゲットサーバーがデフォルトの AWS リージョンにない場合は、--region パラメータを追加します。1 つのコマンドでアップグレードできるサーバーは 1 つだけです。

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 時間かかります。次のコマンドを実行すると、定期的にアップグレードのステータスを確認できます。

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 Automate 1 にロールバックします。

アップグレードには成功したが、サーバーがアップグレード前と同じように動作しない場合 (たとえば、マネージドノードがレポートしない場合) は、サーバーを手動でロールバックできます。手動のロールバックについては、「AWS OpsWorks for Chef Automate サーバーを Chef Automate 1 にロールバックする (CLI)」を参照してください。

次のコマンドを実行して、アップグレードの試行前にサーバーで実行された最後のバックアップの BackupId を表示します。サーバーがデフォルトの AWS リージョンとは異なる AWS リージョンにある場合は、--region パラメータを追加します。

aws opsworks-cm describe-backups server_name

バックアップ IDs形式は ServerName-yyyyMMddHHmmssSSS です。表示された結果で、次の Chef Automate 1 のプロパティを探します。

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

ステップ 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 コマンドの結果に返されます。

復元が完了すると、コンソールに [Restore completed successfully] というメッセージが表示されます。 AWS OpsWorks for Chef Automate サーバーはオンラインであり、アップグレードプロセスを開始する前と同じです。