AppSpec “文件” 部分(仅限 EC2/本地部署) - Amazon CodeDeploy
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

AppSpec “文件” 部分(仅限 EC2/本地部署)

提供 CodeDeploy 有关在部署的 In stall 事件期间应在实例上安装应用程序修订版中的哪些文件的信息。仅当您要在部署期间将修订中的文件复制到实例上的位置时,才需要此部分。

此部分具有以下结构:

files: - source: source-file-location-1 destination: destination-file-location-1 file_exists_behavior: DISALLOW|OVERWRITE|RETAIN

可以设置多个 destinationsource 对。

source 指令标识要从修订复制到实例的文件或目录:

  • 如果 source 指的是文件,则仅将指定的文件复制到实例。

  • 如果 source 指的是目录,则将该目录中的所有文件都复制到实例。

  • 如果 source 是一个单斜杠(对于 Amazon Linux、RHEL 和 Ubuntu Server 实例,为“/”;对于 Windows Server 实例,为“\”),则将修订中的所有文件都复制到实例。

source 中使用的路径是相对于 appspec.yml 文件的路径,该文件应位于修订的根目录。有关修订文件结构的详细信息,请参阅计划 CodeDeploy 的修订

destination 指令标识应将文件复制到的实例上的位置。这必须是完全限定的路径,例如 /root/destination/directory(在 Linux、RHEL 和 Ubuntu 上)或 c:\destination\folder(在 Windows 上)。

sourcedestination 分别使用字符串指定。

file_exists_behavior指令是可选的,它指定如何 CodeDeploy处理已存在于部署目标位置但不属于先前成功部署的文件。此设置可以是以下值之一:

  • DISALLOW:部署失败。这也是未指定选项时的默认行为。

  • OVERWRITE:当前正在部署的应用程序修订的文件版本将替换实例上已有的版本。

  • RETAIN:保留实例上已有的文件版本,并将其用作新部署的一部分。

使用 file_exists_behavior 设置时,请了解此设置:

  • 只能指定一次,并且适用于 files: 下列出的所有文件和目录。

  • 优先于 --file-exists-behavior Amazon CLI 选项和 fileExistsBehavior API 选项(这两者也是可选的)。

以下是 Amazon Linux、Ubuntu Server 或 RHEL 实例的示例 files 部分。

files: - source: Config/config.txt destination: /webapps/Config - source: source destination: /webapps/myApp

在此示例中,将在 Install 事件期间执行下面两个操作:

  1. 将修订中的 Config/config.txt 文件复制到实例上的 /webapps/Config/config.txt 路径中。

  2. 以递归方式将修订的 source 目录中的所有文件复制到实例上的 /webapps/myApp 目录中。

“files”部分示例

以下示例显示了如何指定 files 部分。尽管这些示例描述的是 Windows Server 文件和目录(文件夹)结构,但是它们可轻松适合于 Amazon Linux、Ubuntu Server 和 RHEL 实例。

注意

只有 EC2/本地部署使用 files 部分。它不适用于 Amazon Lambda 部署。

对于以下示例,我们假设这些文件出现在 source 的根的捆绑包中:

  • appspec.yml

  • my-file.txt

  • my-file-2.txt

  • my-file-3.txt

# 1) Copy only my-file.txt to the destination folder c:\temp. # files: - source: .\my-file.txt destination: c:\temp # # Result: # c:\temp\my-file.txt # # --------------------- # # 2) Copy only my-file-2.txt and my-file-3.txt to the destination folder c:\temp. # files: - source: my-file-2.txt destination: c:\temp - source: my-file-3.txt destination: c:\temp # # Result: # c:\temp\my-file-2.txt # c:\temp\my-file-3.txt # # --------------------- # # 3) Copy my-file.txt, my-file-2.txt, and my-file-3.txt (along with the appspec.yml file) to the destination folder c:\temp. # files: - source: \ destination: c:\temp # # Result: # c:\temp\appspec.yml # c:\temp\my-file.txt # c:\temp\my-file-2.txt # c:\temp\my-file-3.txt

对于以下示例,我们假设 appspec.yml 与包含三个文件的名为 my-folder 的文件夹一起出现在 source 的根的捆绑包中:

  • appspec.yml

  • my-folder\my-file.txt

  • my-folder\my-file-2.txt

  • my-folder\my-file-3.txt

# 4) Copy the 3 files in my-folder (but do not copy my-folder itself) to the destination folder c:\temp. # files: - source: .\my-folder destination: c:\temp # # Result: # c:\temp\my-file.txt # c:\temp\my-file-2.txt # c:\temp\my-file-3.txt # # --------------------- # # 5) Copy my-folder and its 3 files to my-folder within the destination folder c:\temp. # files: - source: .\my-folder destination: c:\temp\my-folder # # Result: # c:\temp\my-folder\my-file.txt # c:\temp\my-folder\my-file-2.txt # c:\temp\my-folder\my-file-3.txt # # --------------------- # # 6) Copy the 3 files in my-folder to other-folder within the destination folder c:\temp. # files: - source: .\my-folder destination: c:\temp\other-folder # # Result: # c:\temp\other-folder\my-file.txt # c:\temp\other-folder\my-file-2.txt # c:\temp\other-folder\my-file-3.txt # # --------------------- # # 7) Copy only my-file-2.txt and my-file-3.txt to my-folder within the destination folder c:\temp. # files: - source: .\my-folder\my-file-2.txt destination: c:\temp\my-folder - source: .\my-folder\my-file-3.txt destination: c:\temp\my-folder # # Result: # c:\temp\my-folder\my-file-2.txt # c:\temp\my-folder\my-file-3.txt # # --------------------- # # 8) Copy only my-file-2.txt and my-file-3.txt to other-folder within the destination folder c:\temp. # files: - source: .\my-folder\my-file-2.txt destination: c:\temp\other-folder - source: .\my-folder\my-file-3.txt destination: c:\temp\other-folder # # Result: # c:\temp\other-folder\my-file-2.txt # c:\temp\other-folder\my-file-3.txt # # --------------------- # # 9) Copy my-folder and its 3 files (along with the appspec.yml file) to the destination folder c:\temp. If any of the files already exist on the instance, overwrite them. # files: - source: \ destination: c:\temp file_exists_behavior: OVERWRITE # # Result: # c:\temp\appspec.yml # c:\temp\my-folder\my-file.txt # c:\temp\my-folder\my-file-2.txt # c:\temp\my-folder\my-file-3.txt