跳到主要内容

Taskfile 版本

Taskfile 语法和功能随着时间的推移而改变。 本文档解释了每个版本的变化以及如何升级您的任务文件。

Taskfile 版本的含义​

Taskfile 版本遵循 Task 版本。 例如， taskfile version 2 意味着应该切换为 Task v2.0.0 以支持它。

Taskfile 文件的 version: 关键字接受语义化字符串， 所以 2, 2.0 或 2.0.0 都可以。 如果使用版本号 2.0，那么 Task 就不会使用 2.1 的功能， 但如果使用版本号 2, 那么任意 2.x.x 版本中的功能都是可用的， 但 3.0.0+ 的功能不可用。

版本 1​

注意：Task v3.0.0 以后就不再支持 Taskfiles 的 1 版本了。

最初的 Taskfile 并不支持 version: 关键字，因为 YAML 文档中的根属性都是 task。 就像这样：

echo:
  cmds:
    - echo "Hello, World!"

变量的优先级也不同：

  1. 调用变量
  2. 环境变量
  3. Task 变量
  4. Taskvars.yml 定义变量

版本 2.0​

到了 2.0 版本，我们引入了 version: 字段， 在不破坏已存在的 Taskfiles 的前提下，在 Task 中引入新功能。 新语法如下：

version: '2'

tasks:
  echo:
    cmds:
      - echo "Hello, World!"

如果您不想创建 Taskvars.yml，版本 2 允许您直接在任务文件中写入全局变量：

version: '2'

vars:
  GREETING: Hello, World!

tasks:
  greet:
    cmds:
      - echo "{{.GREETING}}"

变量的优先级调整为：

  1. Task 变量
  2. 调用变量
  3. Taskfile 定义变量
  4. Taskvars 文件定义变量
  5. 环境变量

添加了一个新的全局配置项来配置变量扩展的数量（默认为 2）：

version: '2'

expansions: 3

vars:
  FOO: foo
  BAR: bar
  BAZ: baz
  FOOBAR: "{{.FOO}}{{.BAR}}"
  FOOBARBAZ: "{{.FOOBAR}}{{.BAZ}}"

tasks:
  default:
    cmds:
      - echo "{{.FOOBARBAZ}}"

版本 2.1​

2.1 版包括一个全局 output 选项，以允许更好地控制如何将命令输出打印到控制台（有关更多信息，请参阅 文档）：

version: '2'

output: prefixed

tasks:
  server:
    cmds:
      - go run main.go
  prefix: server

从这个版本开始，也可以忽略命令或 task 的错误（在 此处 查看文档）：

version: '2'

tasks:
  example-1:
    cmds:
      - cmd: exit 1
        ignore_error: true
      - echo "This will be print"

  example-2:
    cmds:
      - exit 1
      - echo "This will be print"
    ignore_error: true

版本 2.2​

2.2 版带有全局 includes 选项来包含其他 Taskfiles：

version: '2'

includes:
  docs: ./documentation # will look for ./documentation/Taskfile.yml
  docker: ./DockerTasks.yml

版本 2.6​

2.6 版本增加任务的先决条件字段 preconditions。

version: '2'

tasks:
  upload_environment:
    preconditions:
      - test -f .env
    cmds:
      - aws s3 cp .env s3://myenvironment

请检查 文档

版本 3​

以下是 v3 所做的一些主要变更：

  • Task 的日志使用彩色输出
  • 支持类 .env 文件
  • 添加 label: 设置后可以覆盖任务名称在日志中的显示方式
  • 添加了全局 method: 允许设置默认方法，Task 的默认值更改为 checksum
  • 使用 status:: CHECKSUM 和 TIMESTAMP 时新增了两个魔术变量，分别包含 sources: 列出的文件的 md5 checksum 和最大修改时间戳
  • 另外，TASK 变量总是可以使用当前的任务名称
  • CLI 变量始终被视为全局变量
  • 向 includes 添加了 dir: 选项，以允许选择包含的任务文件将在哪个目录上运行：
includes:
  docs:
    taskfile: ./docs
    dir: ./docs
  • 实现短任务语法。 以下所有语法都是等效的：
version: '3'

tasks:
  print:
    cmds:
      - echo "Hello, World!"
version: '3'

tasks:
  print:
    - echo "Hello, World!"
version: '3'

tasks:
  print: echo "Hello, World!"
  • 对变量的处理方式进行了重大重构。 现在它们更容易理解了。 expansions: 设置被删除了，因为它变得不必要。 这是 Task 处理变量的顺序，每一层都可以看到前一层设置的变量并覆盖这些变量。
    • 环境变量
    • 全局或 CLI 变量
    • 调用变量
    • Task 内的变量