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

自定义 Windows Server 上的软件

建议自定义和配置您的应用程序所依赖的软件。这些文件可能是该应用程序所要求的依赖项，例如需要运行的其他软件包或服务。有关自定义和配置 Elastic Beanstalk 环境的一般信息，请参阅配置 Elastic Beanstalk 环境。

配置文件支持以下可对运行您的应用程序的 Windows 服务器产生影响的键。

将按键在此处列出的顺序对其进行处理。

观察您的环境的事件，同时开发和测试配置文件。Elastic Beanstalk 将忽略包含验证错误的配置文件（例如“密钥无效”），并且不会处理同一文件中的任何其他密钥。出现这种情况时，Elastic Beanstalk 将警告事件添加到事件日志中。

软件包

使用 packages 键下载并安装预先打包的应用程序和组件。

在 Windows 环境中，Elastic Beanstalk 支持下载和安装软件包。MSI（Linux 环境支持其他软件包管理器。有关详细信息，请参阅在 Linux 服务器上自定义软件页面上的 软件包。）

您可以引用任何外部位置，例如亚马逊简单存储服务 (Amazon S3) Service 对象，只要可以公开访问即URL可。

如果您指定了多个 msi: 程序包，则无法保证其安装顺序。

语法

将您选择的名称指定为软件包名称，并指定URL到MSI文件位置作为值。您可以在 msi: 密钥下指定多个程序包。

packages: 
  msi:
    package name: package url
    ...

示例

以下示例指定了URL要从中下载 mysql https://dev.mysql.com/ 的。

packages:
  msi:
    mysql: https://dev.mysql.com/get/Downloads/Connector-Net/mysql-connector-net-8.0.11.msi

以下示例将 Amazon S3 对象指定为MSI文件位置。

packages:
  msi:
    mymsi: https://amzn-s3-demo-bucket.s3.amazonaws.com/myobject.msi

源

使用sources密钥从公众那里下载存档文件，URL然后将其解压缩到EC2实例的目标目录中。

语法

sources:  
  target directory: location of archive file

支持的格式

在 Windows 环境中，Elastic Beanstalk 支持 .zip 格式。（Linux 环境支持其他格式。有关详细信息，请参阅在 Linux 服务器上自定义软件页面上的 源。）

您可以引用任何外部位置，例如亚马逊简单存储服务 (Amazon S3) Service 对象，只要可以公开访问即URL可。

示例

以下示例会从 Amazon S3 下载一个公有 .zip 文件并将其解压到 c:/myproject/myapp 中。

sources:  
  "c:/myproject/myapp": https://amzn-s3-demo-bucket.s3.amazonaws.com/myobject.zip

文件

使用files密钥在EC2实例上创建文件。内容可以内嵌在配置文件中，也可以来自URL。这些文件会按词典顺序写入磁盘。要从 Amazon S3 下载私有文件，请提供实例配置文件以进行授权。

语法

files:  
  "target file location on disk":
    source: URL
    authentication: authentication name:

  "target file location on disk":
    content: |
      this is my content
    encoding: encoding format

Options

示例

以下示例显示了两种提供文件内容的方法：从 a URL 或在配置文件中以内联方式提供。

files:
  "c:\\targetdirectory\\targetfile.txt":
    source: http://foo.bar/myfile
 
  "c:/targetdirectory/targetfile.txt":
    content: |
      # this is my file
      # with content

以下示例使用资源键添加名为 S3Auth 的身份验证方法并使用该方法从 Amazon S3 下载私有文件：

files:
  "c:\\targetdirectory\\targetfile.zip":
    source: https://elasticbeanstalk-us-east-2-123456789012.s3.amazonaws.com/prefix/myfile.zip
    authentication: S3Auth

Resources:
  AWSEBAutoScalingGroup:
    Metadata:
      AWS::CloudFormation::Authentication:
        S3Auth:
          type: "s3"
          s: ["amzn-s3-demo-bucket"]
          roleName:
            "Fn::GetOptionSetting":
              Namespace: "aws:autoscaling:launchconfiguration"
              OptionName: "IamInstanceProfile"
              DefaultValue: "aws-elasticbeanstalk-ec2-role"

命令

使用该commands键在EC2实例上执行命令。该命令是按名称的字母顺序处理的，它们会在安裝应用程序和 Web 服务器以及提取应用程序版本文件前运行。

管理员用户身份可运行指定的命令。

要使用您的命令排查问题，您可以在实例日志中查找其输出。

语法

commands:
  command name: 
    command: command to run

Options

示例

下面的示例将 set 命令的输出保存到指定的文件。如果有后续命令，Elastic Beanstalk 会在此命令完成后立即运行后续命令。如果命令需要重新启动，则 Elastic Beanstalk 会在命令完成后立即重新启动实例。

commands:
  test: 
    command: set > c:\\myapp\\set.txt
    waitAfterCompletion: 0

服务

使用 services 键定义哪些服务应该在实例启动时启动或者停止。services 键还可让您指定源、包和文件的依赖项，以便在由于文件安装而需要重启时，让 Elastic Beanstalk 负责服务的重启。

语法

services: 
  windows:
    name of service:
      files:
        - "file name"
      sources: 
        - "directory"	
      packages: 
        name of package manager:
            "package name[: version]"
      commands: 
        - "name of command"

Options

示例

services: 
  windows:
    myservice:
      enabled: true
      ensureRunning: true

容器命令

使用 container_commands 键执行将影响应用程序源代码的命令。容器命令将在设置应用程序和 Web 服务器并提取应用程序版本存档后，但在部署应用程序版本前运行。非容器命令和其他自定义操作将在提取应用程序源代码之前执行。

容器命令从暂存目录运行，您的源代码在部署到应用程序服务器前在这里提取。当源部署到其最终位置时，将包含您在暂存目录中使用容器命令对源代码所做的任何更改。

要使用您的容器命令排查问题，您可以在实例日志中查找其输出。

可以使用 leader_only 选项只对单个实例运行此命令，也可以配置 test 以只在测试命令的评估结果为 true 时运行此命令。仅领导容器命令只在创建和部署环境期间执行，而其他命令和服务器自定义操作将在预配置或更新实例时执行。由于启动配置的更改（例如 AMI ID 或实例类型的更改），不会执行仅限领导者的容器命令。

语法

container_commands:
  name of container_command:
    command: command to run

Options

示例

下面的示例将 set 命令的输出保存到指定的文件。Elastic Beanstalk 在一个实例上运行此命令，并在命令完成后立即重新启动实例。

container_commands:
  foo:
    command: set > c:\\myapp\\set.txt
    leader_only: true
    waitAfterCompletion: 0