Deploy 配方

Deploy 配方分配给层的 Deploy 生命周期事件。通常，每当您部署应用程序时，堆栈的所有实例上就会发生此事件，不过，您可以选择性地限制事件仅在指定实例上发生。 AWS OpsWorks Stacks 还会在 Setup 配方完成后在新实例上运行 Deploy 配方。Deploy 配方的主要目的是将存储库中的代码和相关文件部署到应用程序服务器层的实例。不过，您通常还可以在其他层上运行 Deploy 配方。这使这些层的实例可以执行更新，例如，更新它们的配置以适应新部署的应用程序。当您实施 Deploy 配方时，请记住，Deploy 事件并不一定意味着会将应用程序部署到实例。它只是一个通知，说明应用程序将部署到堆栈中的其他实例，以允许对实例进行任何必要的更新。该配方必须能够作出相应的响应，这种响应可能不需要执行任何操作。

AWS OpsWorks Stacks 会自动将标准应用程序类型的应用程序部署到相应的内置应用程序服务器层。要将应用程序部署到自定义层，您必须实施自定义 Deploy 配方，该配方可将存储库中的应用程序的文件下载到实例上的适当位置。但是，您通常可以通过使用内置部署说明书处理某些方面的部署来限制您必须编写的代码量。例如，如果您将文件存储到某个受支持的存储库中，则内置说明书可以处理关于从存储库将文件下载到层的实例的详细信息。

tomcat::deploy 配方旨在被分配给 Deploy 生命周期事件。

include_recipe 'deploy'

node[:deploy].each do |application, deploy|
  opsworks_deploy_dir do
    user deploy[:user]
    group deploy[:group]
    path deploy[:deploy_to]
  end

  opsworks_deploy do
    deploy_data deploy
    app application
  end
...

tomcat::deploy 配方使用内置部署说明书来完成部署的非特定于应用程序的方面。deploy 配方 (内置 deploy::default 配方的简写) 是一个可根据 deploy 属性的数据处理关于设置用户、组等的详细信息的内置配方。

该配方使用两个内置 Chef 定义 (opsworks_deploy_dir 和 opworks_deploy) 来安装应用程序。

该opsworks_deploy_dir定义根据应用程序部署中的数据来设置目录结构JSON。从根本上说，定义是对资源定义进行打包的简便的方式，位于说明书的 definitions 目录中。配方使用定义的方式与使用资源很像，但定义本身并没有关联的提供程序，只是资源包括在定义中。您可以定义配方中的变量，这些变量将传递到基础资源定义。基于部署数据的tomcat::deploy配方集usergroup、和path变量JSON。它们将传递到定义的 directory 资源，该资源用于管理目录。

另一个定义 opsworks_deploy 可根据 deploy 属性中的数据来处理关于查看存储库中的应用程序的代码和相关文件以及将其部署到实例的详细信息。您可以将此定义用于任何应用程序类型；部署详细信息（例如目录名称）可以在控制台中指定，也可以通过API并在deploy属性中输入。但是，仅opsworks_deploy适用于四种支持的存储库类型：Git、Subversion、S3 和HTTP。如果您希望使用不同的存储库类型，您必须自己实施此代码。

您将应用程序的文件安装在 Tomcat webapps 目录中。通常的做法是直接将文件复制到 webapps。但是， AWS OpsWorks Stacks 部署旨在在一个实例上保留多达五个版本的应用程序，因此如有必要，您可以回滚到较早的版本。 AWS OpsWorks 之后，Stacks 将执行以下操作：

如果您需要回滚到早期版本，可修改 current 符号链接以指向包含相应时间戳的不同目录，例如，通过更改 /srv/www/my_1st_jsp/current 的链接目标。

tomcat::deploy 的中间部分可设置符号链接。

  ...
  current_dir = ::File.join(deploy[:deploy_to], 'current')
  webapp_dir = ::File.join(node['tomcat']['webapps_base_dir'], deploy[:document_root].blank? ? application : deploy[:document_root])

  # opsworks_deploy creates some stub dirs, which are not needed for typical webapps
  ruby_block "remove unnecessary directory entries in #{current_dir}" do
    block do
      node['tomcat']['webapps_dir_entries_to_delete'].each do |dir_entry|
        ::FileUtils.rm_rf(::File.join(current_dir, dir_entry), :secure => true)
      end
    end
  end

  link webapp_dir do
    to current_dir
    action :create
  end
  ...

该配方首先创建两个变量 (current_dir 和 webapp_dir) 以分别表示 current 和 webapp 目录。然后，它使用 link 资源将 webapp_dir 链接到 current_dir。这些区域有： AWS OpsWorks Stacks deploy::default 配方创建了一些本示例不需要的存根目录，因此摘录的中间部分将其删除。

tomcat::deploy 的最后部分可在必要时重新启动 Tomcat 服务。

  ...
  include_recipe 'tomcat::service'

  execute 'trigger tomcat service restart' do
    command '/bin/true'
    not_if { node['tomcat']['auto_deploy'].to_s == 'true' }
    notifies :restart, resources(:service => 'tomcat')
  end
end

include_recipe 'tomcat::context'

该配方首先运行 tomcat::service 以确保为此 Chef 运行定义了服务。然后，它使用 execute 资源通知服务重新启动，但前提是 ['tomcat']['auto_deploy'] 被设置为 'true'。否则，Tomcat 将侦听其 webapps 目录中的变化，这会使 Tomcat 服务执行一次不必要的显式重新启动。

最后，tomcat::deploy 运行 tomcat::context，如果您已经更改了后端数据库，这会更新 Web 应用程序上下文配置文件。