Elastic Beanstalk 自定义平台

从很多方面而言，自定义平台都是比自定义映像更高级的自定义方式。您可通过自定义平台从头开始开发整个新平台，自定义 Elastic Beanstalk 在平台实例上运行的操作系统、附加软件和脚本。如果 Elastic Beanstalk 并未针对应用程序使用的语言或其他基础设施软件提供托管平台，您也可以灵活地为应用程序构建一个平台。自定义映像是由您修改 Amazon Machine Image (AMI) 以便与现有 Elastic Beanstalk 平台结合使用，而 Elastic Beanstalk 仍旧提供平台脚本，并控制平台的软件堆栈。此外，对于自定义平台，您使用自动化、脚本化的方式创建自定义并进行维护；而自定义映像是您对正在运行的实例进行手动更改。

要创建自定义平台，您需要基于所支持的操作系统 Ubuntu、RHEL 或 Amazon Linux（有关确切版本号，请参阅 Platform.yaml 文件格式中的 flavor 条目）之一构建 AMI 并进一步添加自定义。您可使用 Packer（一种开源工具，用于为多种平台创建系统映像，包括用于 Amazon Elastic Compute Cloud (Amazon EC2) 的 AMI）创建您自己的 Elastic Beanstalk 平台。Elastic Beanstalk 平台包括被配置为运行一组软件以支持应用程序的 AMI，以及可以包含自定义配置选项和默认配置选项设置的元数据。

Elastic Beanstalk 将 Packer 作为单独的内置平台进行管理，您无需担心 Packer 的配置和版本。

您可以通过为 Elastic Beanstalk 提供 Packer 模板、脚本及供模板调用以构建 AMI 的文件来创建平台。这些组件使用指定模板和元数据的平台定义文件打包成一个称作平台定义存档的 ZIP 存档。

在创建自定义平台时，您可以启动单一实例环境，无需运行 Packer 的弹性 IP。Packer 可以随即启动另一个实例来构建映像。您可以对多个平台及每个平台的多个版本重用此环境。

您账户中的用户可以通过在创建环境期间指定平台 ARN 来使用您的自定义平台。这些 ARN 由您用于创建自定义平台的 eb platform create 命令返回。

您每次构建自定义平台时，Elastic Beanstalk 都会创建新的平台版本。用户可以通过名称指定平台以只获取此平台的最新版本，也可以包含版本号来获取特定的版本。

例如，要部署 ARN 为 MyCustomPlatformARN 的自定义平台的最新版本（可以是 3.0 版），您的 EB CLI 命令行将如下所示：

eb create -p MyCustomPlatformARN

要部署 2.1 版，您的 EB CLI 命令行将如下所示：

eb create -p MyCustomPlatformARN --version 2.1

您可以在创建自定义平台版本和编辑现有自定义平台版本的标签时向其应用标签。有关详细信息，请参阅 标记自定义平台版本。

创建自定义平台

要创建自定义平台，应用程序的根目录必须包含一个平台定义 platform.yaml，定义用于创建自定义平台的生成器的类型。此文件的格式在Platform.yaml 文件格式中描述。您可以从头开始创建自定义平台，或使用某个示例自定义平台作为起始点。

使用示例自定义平台

创建您自己的自定义平台的一个替代方法是使用一个平台定义存档示例来引导您的自定义平台。您必须先在示例中配置然后才能使用的唯一项目是源 AMI 和区域。

下载示例平台定义存档：NodePlatform_Ubuntu.zip。此文件包含平台定义文件、Packer 模板、Packer 在映像创建期间运行的脚本以及 Packer 在平台创建期间复制到生成器实例上的脚本和配置文件。

|-- builder                 Contains files used by Packer to create the custom platform
|-- custom_platform.json    Packer template
|-- platform.yaml           Platform definition file
|-- ReadMe.txt              Briefly describes the sample

平台定义文件 platform.yaml 告知 Elastic Beanstalk Packer 模板 custom_platform.json 的名称。

version: "1.0"

provisioner:
  type: packer
  template: custom_platform.json
  flavor: ubuntu1604

Packer 模板告诉 Packer 如何针对平台构建 AMI，而且要使用 Ubuntu AMI 作为 HVM 实例类型的平台映像的基础。provisioners 部分告知 Packer 将存档中 builder 文件夹内的所有文件复制到实例，并在实例上运行 builder.sh 脚本。脚本完成后，Packer 从修改的实例创建映像。

Elastic Beanstalk 创建三个可用于在 Packer 中标记 AMI 的环境变量：

示例 custom_platform.json 文件使用这些变量来定义它在脚本中使用的以下值：

custom_platform.json 文件包含两个您必须为其提供值的属性：source_ami 和 region。有关选择正确的 AMI 和区域值的详细信息，请参阅 eb-custom-platforms-samples GitHub 存储库中的更新 Packer 模板。

{
  "variables": {
    "platform_name": "{{env `AWS_EB_PLATFORM_NAME`}}",
    "platform_version": "{{env `AWS_EB_PLATFORM_VERSION`}}",
    "platform_arn": "{{env `AWS_EB_PLATFORM_ARN`}}"
  },
  "builders": [
    {
      ...
      "region": "",
      "source_ami": "",
      ...
    }
  ],
  "provisioners": [
    {...},
    {
      "type": "shell",
      "execute_command": "chmod +x {{ .Path }}; {{ .Vars }} sudo {{ .Path }}",
      "scripts": [
        "builder/builder.sh"
      ]
    }
  ]
}

根据要对实例进行的修改，您在平台定义存档中包含的脚本和其他文件将大不相同。示例平台包含以下脚本：

通过 EB CLI 使用示例平台定义存档创建您的第一个自定义平台。

操作完成后，您就拥有了一个可以用于启动 Elastic Beanstalk 环境的平台。

在从控制台创建环境时，可以使用自定义平台。请参阅创建新环境向导。

平台定义存档内容

平台定义存档是相当于应用程序源包的平台。平台定义存档是一种 ZIP 文件，其中包含平台定义文件、Packer 模板以及 Packer 模板用来创建平台的脚本和文件。

平台定义文件是 YAML 格式的文件，名称必须为 platform.yaml 并且位于平台定义存档的根目录中。有关平台定义文件中支持的必需和可选键的列表，请参阅 创建自定义平台。

您不必以特定方式命名 Packer 模板，但文件的名称必须与平台定义文件中指定的配置器模板匹配。有关创建 Packer 模板的说明，请参阅官方 Packer 文档。

您的平台定义存档中的其他文件是模板在创建 AMI 之前自定义实例所要使用的脚本和文件。

自定义平台挂钩

Elastic Beanstalk 在自定义平台上为挂钩使用了标准化的目录结构。挂钩是在生命周期事件期间运行以响应管理操作的脚本，如启动环境中的实例时、当用户启动部署或使用重新启动应用程序服务器功能时。

将您希望挂钩触发的脚本置于 /opt/elasticbeanstalk/hooks/ 文件夹的一个子文件夹中。

挂钩组织到以下文件夹中：

appdeploy、configdeploy 和 restartappserver 文件夹包含 pre、enact 和 post 子文件夹。在操作的每个阶段，pre 文件夹、enact 文件夹和 post 文件夹中的所有脚本依次按字母顺序运行。

在启动实例时，Elastic Beanstalk 会按顺序运行 preinit、appdeploy 和 postinit。在到正在运行的实例的后续部署中，Elastic Beanstalk 会运行 appdeploy 挂钩。configdeploy 挂钩在用户更新实例软件配置设置时运行。restartappserver 挂钩只在用户执行应用程序服务器重新启动时运行。

当脚本遇到错误时，它们能以非零状态退出并写入 stderr，以使操作失败。写入 stderr 的消息将显示在操作失败时输出的事件中。Elastic Beanstalk 还会将此信息捕获到日志文件 /var/log/eb-activity.log 中。如果您不想使操作失败，请返回 0（零）。写入 stderr 或 stdout 的消息会显示在部署日志中，但除非操作失败，否则不会显示在事件流中。

Packer 实例清理

在某些情况下，例如在 Packer 生成器进程完成之前将其停止，Packer 启动的实例将不会被清理。这些实例不是 Elastic Beanstalk 环境的一部分，只能使用 Amazon EC2 服务查看和终止。

Platform.yaml 文件格式

platform.yaml 文件采用以下格式。

version: "version-number"

provisioner:
   type: provisioner-type
   template: provisioner-template
   flavor: provisioner-flavor
        
metadata:
   maintainer: metadata-maintainer
   description: metadata-description
   operating_system_name: metadata-operating_system_name
   operating_system_version: metadata-operating_system_version
   programming_language_name: metadata-programming_language_name
   programming_language_version: metadata-programming_language_version
   framework_name: metadata-framework_name
   framework_version: metadata-framework_version

option_definitions:
   - namespace: option-def-namespace
     option_name: option-def-option_name
     description: option-def-description
     default_value: option-def-default_value

option_settings:
   - namespace: "option-setting-namespace"
     option_name: "option-setting-option_name"
     value: "option-setting-value"

使用以下值替换占位符：

标记自定义平台版本

您可以将标签应用到 Amazon Elastic Beanstalk 自定义平台版本。标签是与Amazon资源关联的键/值对。有关 Elastic Beanstalk 资源标记、使用案例、标签键和值约束以及支持的资源类型的信息，请参阅标记 Elastic Beanstalk 应用程序资源。

您可以在创建自定义平台版本时指定标签。在现有自定义平台版本中，您可以添加或删除标签，以及更新现有标签的值。您最多可以为每个自定义平台版本添加 50 个标签。

在自定义平台版本创建期间添加标签

如果使用 EB CLI 创建自定义平台版本，则可以使用 eb platform create 的 --tags 选项添加标签。

~/workspace/my-app$ eb platform create --tags mytag1=value1,mytag2=value2

对于 Amazon CLI 或其他基于 API 的客户端，可以使用 create-platform-version 命令的 --tags 参数添加标签。

$ aws elasticbeanstalk create-platform-version \
      --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
      --platform-name my-platform --platform-version 1.0.0 --platform-definition-bundle S3Bucket=DOC-EXAMPLE-BUCKET,S3Key=sample.zip

管理现有自定义平台版本的标签

您可以在现有 Elastic Beanstalk 自定义平台版本中添加、更新和删除标签。

如果使用 EB CLI 更新自定义平台版本，则可使用 eb tags 来添加、更新、删除或列出标签。

例如，以下命令会列出自定义平台版本中的标签。

~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

以下命令会更新标签 mytag1 并删除标签 mytag2。

~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

有关选项和更多示例的完整列表，请参阅 eb tags。

对于 Amazon CLI 或其他基于 API 的客户端，可使用 list-tags-for-resource 命令列出自定义平台版本的标签。

$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

使用 update-tags-for-resource 命令可在自定义平台版本中添加、更新或删除标签。

$ aws elasticbeanstalk update-tags-for-resource \
      --tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 \
      --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

在 --tags-to-add 的 update-tags-for-resource 参数中指定要添加的标签和要更新的标签。添加了一个不存在的标签，更新了现有标签的值。

$ aws elasticbeanstalk list-platform-versions