Tekton为何自动换行YAML命令？如何阻止该行为？

一、为什么Tekton会转换格式？ #

Tekton在处理任务定义中的多行脚本时，会对输入的YAML进行重新序列化：

• 原本使用|（字面块标量）的脚本，会被转换为>（折叠块标量）格式，这是因为Tekton内部的YAML处理逻辑会统一格式化输出，以符合YAML的行长度规范。
• 长命令行被自动拆分，是为了避免单行内容过长超出YAML的最佳实践长度（通常为80-120字符），但这种拆分仅存在于YAML的表示层面，实际执行时会被拼接为完整的命令，不影响脚本功能。

二、如何阻止自动换行和格式转换？ #

方法1：使用命令数组替代多行脚本 #

将每个命令拆分为独立的数组项，Tekton会原样保留每个命令的格式，不会进行换行或标量类型转换：

steps:
  - name: setup-tests
    image: node:latest
    script:
      - npm install playwright
      - mkdir tests
      - echo "import { test, expect } from '@playwright/test'" >> tests/chat.spec.js;
      - echo "" >> tests/chat.spec.js;
      - echo "test('Chat only for logged in users', async ({ page }) => {" >> tests/chat.spec.js;

方法2：控制脚本行长度 #

如果坚持使用多行脚本（|格式），确保每个命令行的长度不超过Tekton内部的阈值（建议控制在80字符以内），这样就不会触发自动换行逻辑。例如通过shell行尾反斜杠拆分过长的echo命令：

steps:
  - name: setup-tests
    image: node:latest
    script: |
      npm install playwright

      mkdir tests

      echo "import { test, expect } from '@playwright/test'" \
      >> tests/chat.spec.js;
      echo "" >> tests/chat.spec.js;
      echo "test('Chat only for logged in users', async ({ page }) => {" \
      >> tests/chat.spec.js;

注：这里的行尾反斜杠是shell层面的换行标记，确保脚本执行时命令会被拼接为完整的一行。

补充说明 #

Tekton的格式转换仅改变YAML的显示形式，不会影响脚本的实际执行效果。如果无需严格保留YAML格式，可无需干预；若需要精确控制格式，优先选择命令数组的方式。

内容的提问来源于stack exchange，提问作者Cees Timmerman