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

自定义 Linux 服务器上的软件

本节介绍您可以在配置文件中包含的信息类型，以便在运行 Linux 的EC2实例上自定义软件。有关自定义和配置 Elastic Beanstalk 环境的一般信息，请参阅配置 Elastic Beanstalk 环境。有关在运行 Windows 的EC2实例上自定义软件的信息，请参阅自定义 Windows Server 上的软件。

建议自定义和配置您的应用程序所依赖的软件。您可以添加要在实例预置期间执行的命令；定义 Linux 用户和组；以及下载文件或直接在环境实例上创建文件。这些文件可能是应用程序所需的依赖项（例如 yum 存储库中的其他包），也可能是配置文件（例如代理配置的替代项，用于覆盖 Elastic Beanstalk 默认的特定设置）。

配置文件支持以下键，它们影响运行您的应用程序的 Linux 服务器。

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

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

软件包

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

语法

packages: 
  name of package manager:
    package name: version
    ...
  name of package manager:
    package name: version
    ...
  ...

您可以在每个程序包管理器密钥下指定多个软件包。

支持的软件包格式

目前，Elastic Beanstalk 支持以下包管理器：yum、rubygems、python 和 rpm。包的处理顺序如下：rpm、yum、rubygems 和 python。rubygems 和 python 之间没有处理顺序。在每个包管理器内，不保证包安装顺序。请使用您的操作系统支持的包管理器。

指定版本

在每个包管理器内，会使用包名和一系列版本对每个包进行指定。版本可以是字符串、一系列版本、空字符串或者空列表。空字符串或者空列表表示您需要最新的版本。对于 rpm 管理器，版本被指定为磁盘上文件的路径或URL。不支持相对路径。

如果您指定包的版本，Elastic Beanstalk 会尝试安装该版本，即使实例上已经安装了较新的包版本。如果已经安装了较新的版本，那么部署会失败。一些包管理器支持多个版本，但其他的包管理器可能不支持。有关更多信息，请查看相关的包管理器文档。如果您没有指定版本且已安装了某种版本的包，那么 Elastic Beanstalk 不会安装新的版本，因为它会认为您希望保留并使用现有的版本。

示例代码段

以下片段指定了 rpm 的版本URL，从 yum 请求最新版本，从 rubygems 请求最新版本的 chef 0.10.2。

packages: 
  yum:
    libmemcached: [] 
    ruby-devel: []
    gcc: []
  rpm:
    epel: http://download.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm
  rubygems: 
    chef: '0.10.2'

组

您可以使用groups密钥创建 Linux/ UNIX 群组和分配群组。IDs要创建组，请添加新的密钥值对，将新的组名映射到可选组 ID。组键可以包含一个或多个组名。下表列出了可用的密钥。

语法

groups:
  name of group: {}
  name of group:
    gid: "group id"

Options

示例代码段

以下代码段指定了一个名为 groupOne 但未分配群组 ID 的群组，以及指定群组 ID 值为 groupTwo 45 的名为的群组。

groups:
  groupOne: {}
  groupTwo:
    gid: "45"

用户

您可以使用该users密钥在实例上创建 Linux/ UNIX 用户。EC2

语法

users:
  name of user:
    groups:
      - name of group
    uid: "id of the user"
    homeDir: "user's home directory"

Options

创建的用户属于非交互式系统用户，带有 /sbin/nologin 外壳。这是特意设计的，无法修改。

示例代码段

users:
  myuser:
    groups:
      - group1
      - group2
    uid: "50"
    homeDir: "/tmp"

源

您可以使用sources密钥从公共服务器下载存档文件，URL然后将其解压缩到EC2实例的目标目录中。

语法

sources:
  target directory: location of archive file

支持的格式

支持的格式有 tar、tar+gzip、tar+bz2 和 Zip。只要亚马逊简单存储服务 (Amazon S3) Simple Storage Service（例如）可以https://amzn-s3-demo-bucket.s3.amazonaws.com/myobject公开访问，您就可以引用外部位置。URL

示例代码段

以下示例会从 Amazon S3 存储桶下载一个公有 .zip 文件并将其解压到 /etc/myapp 中：

sources:  
  /etc/myapp: https://amzn-s3-demo-bucket.s3.amazonaws.com/myobject

文件

您可以使用files密钥在EC2实例上创建文件。内容可以是内联在配置文件中，也可以从中提取内容URL。这些文件会按词典顺序写入磁盘。

您可以提供一个用于授权的实例配置文件，从而使用 files 密钥从 Amazon S3 下载私有文件。

如果您指定的文件路径已在实例上存在，则将保留现有文件，并在其名称后附加扩展名 .bak。

语法

files:  
  "target file location on disk": 
     mode: "six-digit octal value"
     owner: name of owning user for file
     group: name of owning group for file
     source: URL
     authentication: authentication name:

  "target file location on disk": 
     mode: "six-digit octal value"
     owner: name of owning user for file
     group: name of owning group for file
     content: |
      # this is my
      # file content
     encoding: encoding format
     authentication: authentication name:

Options

示例代码段

files:
  "/home/ec2-user/myfile" :
    mode: "000755"
    owner: root
    group: root
    source: http://foo.bar/myfile
 
  "/home/ec2-user/myfile2" :
    mode: "000755"
    owner: root
    group: root
    content: |
      this is my
      file content

使用符号链接的示例。这会创建指向现有文件 /tmp/myfile2.txt 的链接 /tmp/myfile1.txt。

files:
  "/tmp/myfile2.txt" :
    mode: "120400"
    content: "/tmp/myfile1.txt"

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

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

files:
  "/tmp/data.json" :
    mode: "000755"
    owner: root
    group: root
    authentication: "S3Auth"
    source: https://elasticbeanstalk-us-west-2-123456789012.s3-us-west-2.amazonaws.com/data.json

命令

您可以使用该commands密钥在EC2实例上执行命令。这些命令在应用程序之前运行，设置 Web 服务器以及提取应用程序版本文件。

指定的命令以根用户身份运行且按名称的字母顺序进行处理。默认情况下，该命令在根目录中运行。要从另一个目录运行命令，请使用 cwd 选项。

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

语法

commands:
  command name: 
    command: command to run
    cwd: working directory
    env: 
      variable name: variable value
    test: conditions for command 
    ignoreErrors: true

Options

示例代码段

以下示例代码段运行 Python 脚本。

commands:
  python_install:
    command: myscript.py
    cwd: /home/ec2-user
    env:
      myvarname: myvarvalue
    test: "[ -x /usr/bin/python ]"

服务

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

语法

services:
  sysvinit:
    name of service:
      enabled: "true"
      ensureRunning: "true"
      files: 
        - "file name"
      sources: 
        - "directory"	
      packages: 
        name of package manager:
          "package name[: version]"
      commands: 
        - "name of command"

Options

示例代码段

以下是示例代码段：

services: 
  sysvinit:
    myservice:
      enabled: true
      ensureRunning: true

容器命令

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

指定的命令以根用户身份运行且按名称的字母顺序进行处理。容器命令从暂存目录运行，您的源代码在部署到应用程序服务器前在这里提取。当源部署到其最终位置时，将包含您在暂存目录中使用容器命令对源代码所做的任何更改。

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

语法

container_commands:
  name of container_command:
    command: "command to run"
    leader_only: true
  name of container_command:
    command: "command to run"

Options

示例代码段

以下是示例代码段。

container_commands:
  collectstatic:
    command: "django-admin.py collectstatic --noinput"
  01syncdb:
    command: "django-admin.py syncdb --noinput"
    leader_only: true
  02migrate:
    command: "django-admin.py migrate"
    leader_only: true
  99customize:
    command: "scripts/customize.sh"