Azure YAML Pipeline部署Job中SchemaChange路径失效求助

问题原因 #

Azure Pipeline的Deployment Job和普通Job的核心差异在于：Deployment Job默认不会自动拉取仓库源代码，它的设计初衷是依赖上游阶段传递的Artifact来部署。而你之前的普通Job会自动执行代码Checkout步骤，所以能正常访问/migrations目录。当迁移到Deployment Job后，没有代码拉取操作，导致$(PROJECT_FOLDER)/migrations路径不存在，触发SchemaChange的"Invalid root folder"错误。

解决方案 #

在Deployment Job的步骤中显式添加代码Checkout任务，强制拉取当前仓库的源代码。修改后的完整Pipeline代码如下：

# Deploy database changes using schemachange
# https://github.com/Snowflake-Labs/schemachange
# (see https://aka.ms/yaml for the YAML schema reference)
trigger:
  branches:
    include:
    - development
  paths:
    include:
    - /migrations

stages:
- stage: 'dev_stage'
  variables:
    - group: Snowflake_Variables_Dev
    - name: env
      value: "dev"
  jobs:
  - deployment: DeployStage
    displayName: 'Dev Stage Test'
    pool:
      vmImage: 'ubuntu-latest'
    environment: 
      name: 'Snowflake_Development'
    strategy:
      runOnce:
        deploy:
          steps:
          # 新增：显式拉取当前仓库代码
          - checkout: self
            displayName: 'Checkout repository code'
          - task: UsePythonVersion@0
            displayName: 'Use Python 3.8.x'
            inputs:
              versionSpec: '3.8.x'
          - task: Bash@3
            inputs:
              targetType: 'inline'
              script: |
                echo 'Starting bash task'
                echo "PROJECT_FOLDER $(PROJECT_FOLDER)"
                echo "System DefaultWorkingDirectory $(System.DefaultWorkingDirectory)"
                # 新增：验证migrations目录是否存在
                ls -la $(PROJECT_FOLDER)
                python --version
                echo 'Step 1: Installing schemachange'
                pip install schemachange --upgrade
                echo 'Step 2: Running schemachange'
                schemachange -f $(PROJECT_FOLDER)/migrations -a $(SF_ACCOUNT) -u $(SF_USERNAME) -r $(SF_ROLE) -w $(SF_WAREHOUSE) -d $(SF_DATABASE) -c $(SF_DATABASE).DEVOPS_CONTROL.CHANGE_HISTORY --config-folder $(System.DefaultWorkingDirectory)/schemachangeconfigs/development --create-change-history-table
            env:
              SNOWFLAKE_PASSWORD: $(SF_PASSWORD)

关键修改说明 #

1. 添加- checkout: self步骤：该步骤会自动拉取当前触发Pipeline的仓库代码到Agent的工作目录，确保$(PROJECT_FOLDER)和$(System.DefaultWorkingDirectory)下包含完整的项目文件。
2. 可选添加ls -la $(PROJECT_FOLDER)命令：用于验证代码拉取后，migrations目录是否存在，方便快速排查路径类问题。

扩展方案（多阶段流水线场景） #

如果你的流水线包含Build和Deploy多个阶段，更规范的做法是：

• 在Build阶段打包包含migrations目录的Artifact
• 在Deployment Job中通过download步骤获取该Artifact
  这种方式避免重复拉取代码，更适合大型项目的流水线设计。

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