Backstage脚手架模板：repoUrl加前缀后预览无效果的问题解决

核心原因 #

Backstage 脚手架的「Review and create」环节默认仅展示用户输入的原始参数，不会自动渲染你在fetch:template中处理后的repoUrl值。你需要手动配置 Review 面板，或者将处理后的值通过outputs暴露并展示。

具体解决方案 #

方案1：自定义Review面板展示处理后的值 #

在模板的review字段中，添加自定义内容来展示带前缀的仓库名：

apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: your-template-name
  title: Your Template
spec:
  parameters:
    - title: Repository Info
      properties:
        repoUrl:
          title: Repository URL
          type: string
          ui:field: RepoUrlPicker
          ui:options:
            allowedHosts:
              - github.com
  # 自定义Review面板
  review:
    fields:
      - title: Repository Details
        content: |
          **Original Repository URL**: ${{ parameters.repoUrl }}
          **Prefixed Repository Name**: `prefix-${{ parameters.repoUrl | parseRepoUrl }}`
  steps:
    - id: fetch-template
      name: Fetch Template
      action: fetch:template
      input:
        url: ./skeleton
        values:
          repoUrl: 'prefix-${{ parameters.repoUrl | parseRepoUrl }}'
    # 后续步骤...

方案2：通过Outputs暴露处理后的值并展示 #

先在模板中定义outputs存储处理后的仓库名，再在Review面板引用：

apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: your-template-name
  title: Your Template
spec:
  parameters:
    - title: Repository Info
      properties:
        repoUrl:
          title: Repository URL
          type: string
          ui:field: RepoUrlPicker
  outputs:
    - name: prefixedRepoUrl
      value: 'prefix-${{ parameters.repoUrl | parseRepoUrl }}'
  review:
    fields:
      - title: Final Repository Name
        content: '${{ outputs.prefixedRepoUrl }}'
  steps:
    - id: fetch-template
      name: Fetch Template
      action: fetch:template
      input:
        url: ./skeleton
        values:
          repoUrl: '${{ outputs.prefixedRepoUrl }}'
    # 发布等后续步骤也可以直接引用outputs的值
    - id: publish
      name: Publish to GitHub
      action: publish:github
      input:
        repoUrl: '${{ outputs.prefixedRepoUrl }}'
        # 其他配置...

额外验证点 #

1. 确认parseRepoUrl转换器工作正常：可以在模板中临时添加一个debug步骤，输出转换后的值，比如：

steps:
  - id: debug
    name: Debug Repo Name
    action: debug:log
    input:
      message: 'Parsed repo name: ${{ parameters.repoUrl | parseRepoUrl }}'

执行模板时查看日志，确认转换器能正确提取仓库名称部分。

2. 检查fetch:template中的values是否正确传递：确保模板文件（如skeleton目录下的文件）确实在使用传入的repoUrl值，避免模板内部硬编码或使用其他变量。

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