OpsWorks for Puppet Enterprise サーバーの更新して、カスタムドメインを使用する

create-server コマンドで指定できるサービスロールまたはインスタンスプロファイルの ARN がない場合は、「を使用して Chef Automate サーバーを作成する AWS CLI」のステップ 1～5 に従って、使用できるサービスロールとインスタンスプロファイルを作成します。

まだ作成していない場合は、カスタムドメインで新しいサーバーのベースにする既存の Puppet マスターのバックアップを探します。次のコマンドを実行して、アカウントおよびリージョン内のすべての OpsWorks for Puppet Enterprise バックアップに関する情報を表示します。使用するバックアップの ID を書き留めておきます。

aws opsworks-cm --region region name describe-backups

次の create-server コマンドを実行して OpsWorks for Puppet Enterprise サーバーを作成します。

aws opsworks-cm create-server --engine "Puppet" --engine-model "Monolithic" --engine-version "2019" --server-name "server_name" --instance-profile-arn "instance_profile_ARN" --instance-type "instance_type" --engine-attributes '{"PUPPET_ADMIN_PASSWORD":"ASCII_password"}' --key-pair "key_pair_name" --preferred-maintenance-window "ddd:hh:mm" --preferred-backup-window "ddd:hh:mm" --security-group-ids security_group_id1 security_group_id2 --service-role-arn "service_role_ARN" --subnet-ids subnet_ID

次の例では、カスタムドメインを使用する Puppet マスターを作成します。

aws opsworks-cm create-server \
    --engine "Puppet" \
    --engine-model "Monolithic" \
    --engine-version "2019" \
    --server-name "puppet-02" \
    --instance-profile-arn "arn:aws:iam::1019881987024:instance-profile/aws-opsworks-cm-ec2-role" \
    --instance-type "c4.large" \
    --engine-attributes '{"PUPPET_ADMIN_PASSWORD":"zZZzDj2DLYXSZFRv1d"}' \
    --custom-domain "my-puppet-master.my-corp.com" \
    --custom-certificate "-----BEGIN CERTIFICATE----- EXAMPLEqEXAMPLE== -----END CERTIFICATE-----" \
    --custom-private-key "-----BEGIN RSA PRIVATE KEY----- EXAMPLEqEXAMPLE= -----END RSA PRIVATE KEY-----" \
    --key-pair "amazon-test" 
    --preferred-maintenance-window "Mon:08:00" \
    --preferred-backup-window "Sun:02:00" \
    --security-group-ids sg-b00000001 sg-b0000008 \
    --service-role-arn "arn:aws:iam::044726508045:role/service-role/aws-opsworks-cm-service-role" \
    --subnet-ids subnet-383daa71

OpsWorks for Puppet Enterprise は、新しいサーバーを作成するのに約 15 分かかります。create-server コマンドの出力で、Endpoint 属性の値をコピーします。以下に例を示します。

"Endpoint": "puppet-2019-exampleexample.opsworks-cm.us-east-1.amazonaws.com"

create-server コマンドの出力を閉じたり、シェルセッションを閉じたりしないでください。今後表示されない重要な情報が出力に含まれている場合があります。create-server の結果からパスワードとスターターキットを取得するには、次のステップに進みます。

OpsWorks for Puppet Enterprise でパスワードを生成するように選択した場合、[jq] などの JSON プロセッサーを使用して create-server の結果から使用可能な形式でパスワードを抽出できます。jq をインストールした後、以下のコマンドを実行して Puppet 管理者パスワードとスターターキットを抽出できます。ステップ 3 で独自のパスワードを指定しなかった場合は、抽出した管理者パスワードを使いやすく安全な場所に保存してください。

#Get the Puppet password:
cat resp.json | jq -r '.Server.EngineAttributes[] | select(.Name == "PUPPET_ADMIN_PASSWORD") | .Value'

#Get the Puppet Starter Kit:
cat resp.json | jq -r '.Server.EngineAttributes[] | select(.Name == "PUPPET_STARTER_KIT") | .Value' | base64 -D > starterkit.zip

create-server コマンドの結果からスターターキットを抽出していない場合、必要に応じて、新しいスターターキットを OpsWorks for Puppet Enterprise コンソールのサーバーのプロパティページからダウンロードできます。

カスタムドメインを使用していない場合は、次のステップに進みます。サーバーでカスタムドメインを使用している場合は、エンタープライズの DNS 管理ツールで CNAME エントリを作成し、ステップ 4 でコピーした OpsWorks for Puppet Enterprise エンドポイントにカスタムドメインをポイントします。このステップを完了するまで、カスタムドメインを使用するサーバーにアクセスしたりサインインしたりすることはできません。

サーバーの作成プロセスが完了したら、「スターターキットを使用して Puppet マスターを設定する」に進みます。