使用建立 AWS OpsWorks for Puppet Enterprise 主版 AWS CloudFormation

請登入 AWS Management Console 並開啟 AWS CloudFormation 主控台，網址為 https://console.aws.amazon.com/cloudformation。

在 AWS CloudFormation 首頁上，選擇 [建立堆疊]。

在 Prerequisite - Prepare template (先決條件 - 準備範本)中，如果您使用的是 範例 AWS CloudFormation 範本，請選擇 Template is ready (範本備妥)。

在 Specify template (指定範本) 中，請選擇範本的來源。對於本逐步解說，請選擇 [上傳範本檔案]，然後上傳建立 Puppet Enterprise 伺服器的 AWS CloudFormation 範本。瀏覽您的範本檔案，然後選擇 Next (下一步)。

AWS CloudFormation 範本可以是 YAML 或 JSON 格式。您可以使用AWS CloudFormation 範例範本；請務必使用您自己的範例值來取代範例值。您可以使用 AWS CloudFormation 範本設計工具來建立新範本或驗證現有範本。若要取得有關如何執行此操作的更多資訊，請參閱《AWS CloudFormation 使用指南》中的AWS CloudFormation 設計師介面概述

在 Specify stack details (指定堆疊詳細資訊) 頁面上，輸入堆疊的名稱。這個名稱不會與您的伺服器名稱相同，這只是堆疊名稱。在 Parameters (參數) 區域中，輸入用於登入 Puppet Enterprise 網頁的管理員密碼。此密碼必須使用 8 到 32 個 ASCII 字元。選擇下一步。

在 [選項] 頁面上，您可以將標籤新增到使用堆疊建立的伺服器，如果尚未指定要在範本中使用的 IAM 角色，則可以選擇 IAM 角色來建立資源。指定選項完成後，選擇 Next (下一步)。若要取得有關進階選項 (例如回復觸發器) 的詳細資訊，請參閱《AWS CloudFormation 使用指南》中的〈設定 AWS CloudFormation 堆疊

在 Review (檢閱) 頁面上，檢視您的選擇。當您準備好建立伺服器堆疊時，請選擇 Create (建立)。

當您等待 AWS CloudFormation 建立堆疊時，請檢視堆疊建立狀態。如果堆疊建立失敗，則檢閱顯示在主控台中的錯誤訊息，以協助您解決問題。如需疑難排解 AWS CloudFormation 堆疊中錯誤的詳細資訊，請參閱AWS CloudFormation 使用者指南中的疑難排解錯誤。

伺服器建立完成後，您的 Puppet 主版可在 OpsWorks Puppet 企業版首頁上使用，其狀態為線上。伺服器上線之後，伺服器的網域會提供 Puppet Enterprise 主控台，URL 格式如下：https://your_server_name-randomID.region.opsworks-cm.io。

aws opsworks describe-servers --server-name server_name

請務必完成用必要條件於創建 OpsWorks Puppet 企業主機。

建立服務角色和執行個體設定檔。 AWS OpsWorks 提供可用來建立兩者的 AWS CloudFormation 樣板。執行下列 AWS CLI 命令以建立為您建立服務角色和執行個體設定檔的 AWS CloudFormation 堆疊。

aws cloudformation create-stack --stack-name OpsWorksCMRoles --template-url https://s3.amazonaws.com/opsworks-cm-us-east-1-prod-default-assets/misc/opsworks-cm-roles.yaml --capabilities CAPABILITY_NAMED_IAM

建立堆疊 AWS CloudFormation 完成後，尋找並複製帳戶中服務角色的 ARN。

aws iam list-roles --path-prefix "/service-role/" --no-paginate

在 list-roles 命令的結果中，尋找類似如下的服務角色和執行個體描述檔項目。記下服務角色和執行個體設定檔的 ARN，並將其新增至您用來建立 Puppet 主要伺服器堆疊的 AWS CloudFormation 範本。

{
    "AssumeRolePolicyDocument": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Action": "sts:AssumeRole",
                "Effect": "Allow",
                "Principal": {
                    "Service": "ec2.amazonaws.com"
                }
            }
        ]
    },
    "RoleId": "AROZZZZZZZZZZQG6R22HC",
    "CreateDate": "2018-01-05T20:42:20Z",
    "RoleName": "aws-opsworks-cm-ec2-role",
    "Path": "/service-role/",
    "Arn": "arn:aws:iam::000000000000:role/service-role/aws-opsworks-cm-ec2-role"
},
{
    "AssumeRolePolicyDocument": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Action": "sts:AssumeRole",
                "Effect": "Allow",
                "Principal": {
                    "Service": "opsworks-cm.amazonaws.com"
                }
            }
        ]
    },
    "RoleId": "AROZZZZZZZZZZZZZZZ6QE",
    "CreateDate": "2018-01-05T20:42:20Z",
    "RoleName": "aws-opsworks-cm-service-role",
    "Path": "/service-role/",
    "Arn": "arn:aws:iam::000000000000:role/service-role/aws-opsworks-cm-service-role"
}

再次執行create-stack命令， OpsWorks 為 Puppet 企業主機建立。

aws cloudformation create-stack --stack-name stack_name --template-body file://template.yaml or json --parameters ParameterKey=AdminPassword,ParameterValue="password"

以下是範例。

aws cloudformation create-stack --stack-name "OpsWorksCMPuppetServerStack" --template-body file://opsworkscm-puppet-server.json --parameters ParameterKey=AdminPassword,ParameterValue="09876543210Ab#"

下列範例會在範本中未提供 r10k 引擎屬性時，將 AWS CloudFormation 它們指定為參數。包含 r10k 引擎屬性的範例範本，puppet-server-param-attributes.yaml，已包含在範例 AWS CloudFormation 範本中。

aws cloudformation create-stack --stack-name MyPuppetStack --template-body file://puppet-server-param-attributes.yaml --parameters ParameterKey=AdminPassword,ParameterValue="superSecret1%3" ParameterKey=R10KRemote,ParameterValue="https://www.yourRemote.com" ParameterKey=R10KKey,ParameterValue="$(cat puppet-r10k.pem)"

下面範例會在 AWS CloudFormation 範本中指定 r10k 引擎屬性及其值；此命令只需要指向範本檔案。經指定做為 --template-body、puppet-server-in-file-attributes.yaml 值的範本，則包含於範例 AWS CloudFormation 範本中。

aws cloudformation create-stack --stack-name MyPuppetStack --template-body file://puppet-server-in-file-attributes.yaml

(選用) 若要取得堆疊建立狀態，請執行下列命令。

aws cloudformation describe-stacks --stack-name stack_name 

當堆疊建立完成後，請前往下一節使用入門套件設定 Puppet 主伺服器。如果堆疊建立失敗，則檢閱顯示在主控台中的錯誤訊息，以協助您解決問題。如需疑難排解 AWS CloudFormation 堆疊中錯誤的詳細資訊，請參閱AWS CloudFormation 使用者指南中的疑難排解錯誤。