如何在Bitbucket Pipelines中填充生成parameters.yml参数配置文件

Bitbucket Pipelines的YAML解析器会优先识别行内的特殊字符（冒号+空格、双引号、$等），你逐行写的echo语句里包含大量YAML本身的结构特征字符，会被解析器误判为YAML配置项而非Shell命令，所以触发了「必须使用字符串或管道符」的报错。

方案1：使用Here Document一次性写入多行内容 #

直接用Shell的 heredoc 特性一次性写入所有配置，配合YAML的多行字符串标记|避免解析报错，不用再写几十条echo语句，修改配置也更方便：

pipelines:
  default:
    - step:
        name: install and test
        caches:
          - composer
          - node
          - vendor
        script:
          - npm install
          - npm install -g gulp
          - |
            cat << EOF > app/config/parameters.yml
            parameters:
                database_driver: pdo_mysql
                database_host: $DB_HOST
                database_port: $DB_PORT
                database_name: $DB_NAME
                database_user: $DB_USER
                database_password: $DB_PASS
                redis.dsn.cache: "$REDIS"/0
                redis.dsn.doctrine: "$REDIS/1"
                redis.dsn.session: "$REDIS/2"
                mailer_transport: $MAIL_TRANSPORT
                mailer_host: $MAIL_HOST
                mailer_user: $MAIL_USER
                mailer_password: $MAIL_PASS
                mailer_port: $MAIL_PORT
                # 剩余的几十行配置直接按格式往下追加即可
            EOF

说明：

• 需要解析流水线环境变量直接用<< EOF即可，如果不需要解析变量可改为<< 'EOF'
• 如果希望内容可以缩进更美观，可改为<<- EOF，后续内容和结束的EOF都可以用Tab键缩进，不影响输出结果

方案2：模板文件+envsubst变量替换（配置较多时更易维护） #

如果你的配置后续调整频率高，建议把配置模板直接存到代码仓库中，流水线只做变量替换，完全避免YAML解析冲突：

1. 仓库中新增模板文件 app/config/parameters.yml.tpl，内容和最终的parameters.yml格式完全一致，需要填充的位置直接写对应环境变量名：

parameters:
    database_driver: pdo_mysql
    database_host: $DB_HOST
    database_port: $DB_PORT
    database_name: $DB_NAME
    database_user: $DB_USER
    database_password: $DB_PASS
    redis.dsn.cache: "$REDIS"/0
    redis.dsn.doctrine: "$REDIS/1"
    redis.dsn.session: "$REDIS/2"
    mailer_transport: $MAIL_TRANSPORT
    mailer_host: $MAIL_HOST
    mailer_user: $MAIL_USER
    mailer_password: $MAIL_PASS
    mailer_port: $MAIL_PORT
    # 剩余配置直接写即可

2. 流水线script中新增一行替换命令即可生成正式配置文件：

envsubst < app/config/parameters.yml.tpl > app/config/parameters.yml

说明：如果配置中有需要保留的原生$字符，在模板中写为\$转义即可。

可选兼容方案（坚持用echo逐行写入时使用） #

如果一定要保留原来的逐行echo写法，只需要给每个echo命令外层包上单引号，告诉YAML解析器整行是字符串即可：

- 'echo "    database_host: $DB_HOST" >> app/config/parameters.yml'

该方案需要修改所有echo行，维护成本高，不推荐。

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