步骤 2.5：部署应用程序 - AWS OpsWorks
创建应用程序并将它存储在存储库中实施配方以部署应用程序更新实例的说明书将配方添加到自定义 IIS 层添加应用程序部署应用程序和打开应用程序

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

步骤 2.5：部署应用程序

重要

该 AWS OpsWorks Stacks 服务于 2024 年 5 月 26 日终止，新客户和现有客户均已禁用。我们强烈建议客户尽快将其工作负载迁移到其他解决方案。如果您对迁移有疑问，请通过 re AWS : Post 或通过 Pre mium Su AWS pp ort 与 AWS Support 团队联系。

IIS 安装将为应用程序的代码和相关文件创建一个 C:\inetpub\wwwroot 目录。下一步是将应用程序安装在此目录中。在本示例中，您将在 default.html中安装静态 HTML 主页 C:\inetpub\wwwroot。您可轻松扩展常规方法以处理更复杂的方案，如 ASP.NET 应用程序。

您可在您的说明书中包含应用程序的文件并让 install.rb 将这些文件复制到 C:\inetpub\wwwroot。有关如何执行此操作的示例，请参阅示例 6：创建文件。但是，这种方法不是很灵活或高效，通常更好的方法是将说明书开发与应用程序开发分隔开。

首选解决方案是实施从存储库 (任何你喜欢的资源库，而不仅仅是说明书存储库) 检索应用程序的代码和相关文件的单独部署配方，并将此配方安装在每个 IIS 服务器实例上。此方法将说明书开发与应用程序开发分隔开，当您需要更新应用程序时，它允许您仅运行部署配方，而不必更新说明书。

本主题演示如何实施将 default.htm 部署到 IIS 服务器的简单部署配方。您可随时将此示例扩展到更复杂的应用程序。

创建应用程序并将它存储在存储库中

您可对应用程序使用您更喜欢的任何存储库。为简便起见，此示例将 default.htm 存储在公有 S3 存储桶中。

创建应用程序

  1. 在您的工作站上的方便位置创建一个名为 iis-application 的目录。

  2. 将包含以下内容的 default.htm 文件添加到 iis-application。

    <!DOCTYPE html>
<html>
  <head>
    <title>IIS Example</title>
  </head>
  <body>
    <h1>Hello World!</h1>
  </body>
</html>

  3. 创建 S3 存储桶，将 default.htm 上传到此存储桶，并记录此 URL 供以后使用。为简单起见，请将此文件设置为公用。

    注意

    这是一个非常简单的应用程序，但您可扩展基本准则以处理生产级应用程序。

    • 对于具有多个文件的更复杂的应用程序，为 iis-application 创建 .zip 存档并将其上传至您的 S3 存储桶通常会更简单。

      随后，您可下载此 .zip 文件并将其内容提取到相应目录。无需下载多个文件，创建一个目录结构等。

    • 对于生产应用程序，您可能希望保持您的文件私有。有关如何让配方从私有 S3 存储桶下载文件的示例，请参阅在 AWS OpsWorks Stacks Windows 实例上使用适用于 Ruby 的 SDK。

    • 您可将应用程序存储在任何适当的存储库中。

      通常，您使用存储库的公用 API 下载应用程序。此示例使用 Amazon S3 API。例如，如果您在上存储应用程序 GitHub，则可以使用 GitHub API。

实施配方以部署应用程序

将名为 deploy.rb 的包含以下内容的配方添加到 iis-cookbook recipes 目录。

chef_gem "aws-sdk-s3" do
  compile_time false
  action :install
end

ruby_block "download-object" do
  block do
    require 'aws-sdk-s3'

    #1  
    # Aws.config[:ssl_ca_bundle] = 'C:\ProgramData\Git\bin\curl-ca-bundle.crt'
    Aws.use_bundled_cert!

    #2  
    query = Chef::Search::Query.new
    app = query.search(:aws_opsworks_app, "type:other").first
    s3region = app[0][:environment][:S3REGION]
    s3bucket = app[0][:environment][:BUCKET]
    s3filename = app[0][:environment][:FILENAME]

    #3  
    s3_client = Aws::S3::Client.new(region: s3region)
    s3_client.get_object(bucket: s3bucket,
                         key: s3filename,
                         response_target: 'C:\inetpub\wwwroot\default.htm')
  end 
  action :run
end

此示例使用 SDK for Ruby v2 下载文件。但是， AWS OpsWorks Stacks 不会在 Windows 实例上安装此 SDK，因此配方从处理该任务的chef_gem资源开始。

注意

chef_gem 资源将 gem 安装到 Chef 的专用 Ruby 版本 (配方使用的版本) 中。如果您要为系统范围的 Ruby 版本安装 gem，请使用 gem_package 资源。

大多数配方都是 ruby_block 资源，此资源运行使用 SDK for Ruby 下载 default.htm 的 Ruby 代码块。ruby_block 中的代码可分为下列各节，这些节对应于代码示例中的编号注释。

1：指定证书捆绑

Amazon S3 使用 SSL，因此您需要相应的证书来从 S3 存储桶下载对象。适用于 Ruby v2 的 SDK 不包含证书包，因此您必须提供一个证书包，然后配置适用于 Ruby 的 SDK 才能使用它。 AWS OpsWorks Stacks 不会直接安装证书包，但会安装 Git，其中包括证书包 (curl-ca-bundle.crt)。为方便起见，此示例将 SDK for Ruby 配置为使用 SSL 的 Git 证书捆绑。您也可以安装您自己的捆绑并相应地配置开发工具包。

2：检索存储库数据

要从 Amazon S3 下载对象，您需要 Amazon Web Services Region、存储桶名称和密钥名称。如下文所述，此示例通过将一组环境变量与应用程序关联来提供此信息。部署应用程序时， AWS OpsWorks Stacks 会向实例的节点对象添加一组属性。这些属性实际上是包含应用程序配置 (包括环境变量) 的哈希表。此应用程序的应用程序属性看上去将与以下内容类似 (JSON 格式)。

{
  "app_id": "8f71a9b5-de7f-451c-8505-3f35086e5bb3",
  "app_source": {
      "password": null,
      "revision": null,
      "ssh_key": null,
      "type": "other",
      "url": null,
      "user": null
  },
  "attributes": {
      "auto_bundle_on_deploy": true,
      "aws_flow_ruby_settings": {},
      "document_root": null,
      "rails_env": null
  },
  "data_sources": [{"type": "None"}],
  "domains": ["iis_example_app"],
  "enable_ssl": false,
  "environment": {
      "S3REGION": "us-west-2",
      "BUCKET": "windows-example-app",
      "FILENAME": "default.htm"
  },
  "name": "IIS-Example-App",
  "shortname": "iis_example_app",
  "ssl_configuration": {
      "certificate": null,
      "private_key": null,
      "chain": null
  },
  "type": "other",
  "deploy": true
}

应用程序的环境变量存储在 [:environment] 属性中。要检索它们，请使用 Chef 搜索查询检索应用程序的哈希表（在 aws_opsworks_app 节点下）。此应用程序将定义为 other 类型，因此查询将搜索此类型的应用程序。配方将利用此实例上只有一个应用程序的事实，因此相关哈希表为 app[0]。为方便起见，配方随后将向变量分配区域、存储桶和文件名。

有关如何使用 Chef 搜索的更多信息，请参阅使用 Chef 搜索获取属性值

3：下载文件

配方的第三部分创建一个 S3 客户端对象并使用其 get_object 方法将 default.htm 下载到实例的 C:\inetpub\wwwroot 目录。

注意

配方是 Ruby 应用程序，因此 Ruby 代码不一定必须位于 ruby_block 中。但是，配方正文中的代码先运行，然后再运行资源。在此示例中，如果您将下载代码放入配方正文，则下载将失败，因为 chef_gem 资源尚未安装 SDK for Ruby。在 chef_gem 资源安装 SDK for Ruby 后，ruby_block 资源中的代码将在资源执行时执行。

更新实例的说明书

AWS OpsWorks Stacks 会自动在新实例上安装自定义食谱。但是，您正在使用现有实例，因此必须手动更新您的说明书。

更新实例的说明书

  1. 创建 iis-cookbook 的 .zip 存档，然后将其传到 S3 存储桶。

    这会覆盖现有说明书，但 URL 保持不变，因此您无需更新堆栈配置。

  2. 如果您的实例未处于联机状态，请重新启动它。

  3. 在实例处于联机状态后，选择导航窗格中的 Stack，然后选择 Run Command。

  4. 对于 Command，选择 Update Custom Cookbooks。此命令将在实例上安装更新后的说明书。

  5. 选择 Update Custom Cookbooks。此命令可能需要几分钟才能完成。

将配方添加到自定义 IIS 层

与 install.rb 一样，处理部署的首选方式是将 deploy.rb 分配给相应的生命周期事件。通常，您将部署配方分配给部署事件，它们统称为部署配方。将配方分配给部署事件不会触发此事件。相反：

  • 对于新实例， AWS OpsWorks Stacks 会在安装配方完成后自动运行 Deploy 配方，因此新实例会自动使用当前的应用程序版本。

  • 对于联机实例，请使用部署命令手动安装新的或更新的应用程序。

    此命令将在堆栈实例上触发部署事件，该事件将运行部署配方。

将 deploy.rb 分配给层的部署事件

  1. 在导航窗格中选择 Layers，然后在 Layer IISExample 下选择 Recipes。

  2. 在 Custom Chef Recipes (自定义 Chef 配方) 下，将 iis-cookbook::deploy 添加到 Deploy (部署) 配方框并选择 + 以将配方添加到层。

  3. 选择 Save 以保存新配置。自定义部署配方现在应包含 iis-cookbook::deploy。

添加应用程序

最后一项任务是向堆栈中添加一个应用程序，以在 AWS OpsWorks Stacks 环境中代表您的应用程序。应用程序包含元数据 (如应用程序的显示名称) 和从存储库下载应用程序所需的数据。

将应用程序添加到堆栈

  1. 在导航窗格中选择 Apps，然后选择 Add an app。

  2. 使用以下设置配置应用程序。

    • 名称：IIIS-Example-App

    • 存储库类型：其他

    • 环境变量：添加以下三个环境变量：

      • S3REGION：存储桶的区域（在本例中为 us-west-1）。

      • BUCKET：存储桶名称，例如 windows-example-app。

      • FILENAME：文件名：default.htm。

  3. 接受剩余设置的默认值，然后选择 Add App (添加应用程序) 以将应用程序添加到堆栈。

注意

此示例使用环境变量来提供下载数据。另一种方法是使用 S3 存档存储库类型并提供文件的 URL。 AWS OpsWorks Stacks 会将信息以及可选数据（例如您的 AWS 证书）添加到应用程序的app_source属性中。您的部署配方必须从应用程序属性中获取 URL 并进行解析以提取区域、存储桶名称和文件名。

部署应用程序和打开应用程序

AWS OpsWorks Stacks 会自动将应用程序部署到新实例，但不会自动部署到在线实例。由于您的实例已在运行中，因此必须手动部署应用程序。

部署应用程序

  1. 选择导航窗格中的 Apps，然后选择应用程序的 Actions 列中的 deploy。

  2. Command (命令) 应设置为 Deploy (部署)。在部署应用程序页面右下角，选择部署。此命令可能需要几分钟才能完成。

    在部署完成后，您返回到 Apps (应用程序) 页面。Status (状态) 指示符显示绿色的 successful (成功)，并且应用程序名称旁会出现一个绿色对勾指示部署成功。

注意

Windows 应用程序始终为其他应用程序类型，因此部署应用程序将执行以下操作：

  • 将应用程序的数据添加到堆栈配置和部署属性，如上文所述。

  • 在堆栈的实例上触发部署事件，该事件将运行自定义部署配方。

注意

有关如何对失败的部署或应用程序执行故障排除的更多信息，请参阅调试配方。

应用程序现已安装。您可通过选择导航窗格中的实例，然后选择实例的公有 IP 地址来打开它。这将向实例发送 HTTP 请求，并且浏览器中应显示与以下内容类似的信息。