Azure Pipeline部署Python项目遇共享目录访问问题及咨询

我有一个托管在Git仓库中的Python项目，正在创建Azure Pipeline完成以下任务：

1. 若共享目录路径中无该Git仓库则克隆，否则拉取最新代码；
2. 若共享目录中无.venv虚拟环境则创建并激活，否则激活现有环境；
3. 安装requirements.txt中的Python包。

当前使用的YAML配置如下：

trigger:
- main

pool:
  vmImage: 'windows-latest'
  name: 'On Premise Windows'
  demands: Agent.Name -equals [Agent_name]

variables:
- group: Variable_Group
- name: PAT
  value: $[variables.PAT]

steps:
- checkout: self
  displayName: 'Checkout Repository'

- powershell: |
    $parent_folder = '\\server\my\shared\folder\path'
    $target_folder = Join-Path -Path $parent_folder -ChildPath '[project_name]'
    $target_folder_exists = Test-Path -Path $target_folder
    if ($target_folder_exists) {
      cd $target_folder
      git pull
    } else {
      git clone 'https://$(PAT)@dev.azure.com/my/git/project' $parent_folder
    }
  enabled: True
  displayName: 'Clone or Pull Git repository'

- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.11'

- powershell: |
    $parent_folder = '\\server\my\shared\folder\path\[project_name]'
    $target_folder = Join-Path -Path $parent_folder -ChildPath '.venv'
    &requirements_path = Join-Path -Path $parent_folder -ChildPath 'requirements.txt'
    $target_folder_exists = Test-Path -Path $target_folder
    if ($target_folder_exists) {
      cd &parent_folder
      & C:\"Program Files"\Python311\python.exe -m venv .venv
    }
    pip install -r $requirements_path
  displayName: 'Setup Python Environment and Install Dependencies'

所使用的代理部署在本地（On-Premise）服务器，共享目录位于Azure VM中，运行时出现以下错误：

========================== Starting Command Output =========================== "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" -NoLogo
-NoProfile -NonInteractive -ExecutionPolicy Unrestricted -Command ". '....'" fatal:
could not create leading directories of
'\server\my\shared\folder\path':
No such file or directory
##[error]PowerShell exited with code '1'. Finishing: Clone or Pull Git repository

由此产生两个问题：

1. 能否通过赋予有权限的用户让本地服务器访问该共享目录？若可以，如何传递用户账号和密码？若不行，正确的实现方案是什么？
2. 使用PowerShell完成Git克隆及Python包安装是否为合适方案？若不合适，正确的方式是什么？

问题1：共享目录权限与访问方案 #

可以通过有权限的用户让本地代理服务器访问Azure VM上的共享目录，有两种常用实现方式，也有备选简化方案：

方式1：Pipeline内临时映射网络驱动器并传递凭据 #

在执行Git操作前，添加PowerShell步骤完成共享目录的权限验证与映射，使用Azure Pipeline变量组存储保密凭据：

$sharedPath = "\\server\my\shared\folder\path"
# 从Pipeline变量组中读取保密凭据
$username = "$(SharedFolderUser)"
$password = ConvertTo-SecureString "$(SharedFolderPassword)" -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($username, $password)

# 映射网络驱动器（Z:为示例盘符，可自定义）
New-PSDrive -Name Z -PSProvider FileSystem -Root $sharedPath -Credential $credential -Persist

# 验证路径可达性
if (-not (Test-Path Z:\)) {
    throw "无法访问共享目录，请检查凭据与权限"
}

注意：

• 将SharedFolderUser和SharedFolderPassword添加到Azure Pipeline的变量组中，并标记为保密变量，避免明文泄露。
• 映射完成后，后续操作可直接使用Z:\替代原UNC路径，或继续使用UNC路径（凭据已在当前会话缓存）。

方式2：修改代理服务的运行账号权限 #

如果本地代理以Windows服务形式运行，可直接将服务运行账号替换为拥有共享目录访问权限的账号：

1. 打开本地代理服务器的服务管理器，找到Azure Pipeline代理服务（通常名为Azure Pipelines Agent）。
2. 右键选择「属性」→「登录」选项卡，输入有权限访问Azure VM共享目录的域账号或本地账号及密码。
3. 重启代理服务，后续Pipeline执行时会自动使用该账号权限访问共享目录。

备选简化方案：在Azure VM上部署代理 #

如果权限配置过于繁琐，最直接的方案是在Azure VM上部署Azure Pipeline代理，此时共享目录变为本地路径，无需跨机器权限验证，彻底解决UNC路径访问问题。

问题2：PowerShell实现方案的合理性与优化 #

使用PowerShell完成Git克隆和Python包安装是可行的，但你的现有脚本存在语法错误和逻辑偏差，同时也可以通过Azure Pipeline内置任务简化流程：

现有脚本的核心问题 #

1. Git克隆步骤：git clone的目标路径错误，应该克隆到$target_folder（项目子文件夹）而非$parent_folder（共享根目录）。
2. 虚拟环境步骤：
   • 语法错误：&requirements_path = ...是错误的赋值写法，需去掉&。
   • 逻辑错误：现有代码是虚拟环境存在时才创建，与需求完全相反，应该是不存在时才创建。
   • 未激活虚拟环境：直接使用全局pip安装包，会导致包安装到全局环境而非项目虚拟环境。

优化后的PowerShell脚本示例 #

Git克隆/拉取步骤

$parent_folder = '\\server\my\shared\folder\path'
$target_folder = Join-Path -Path $parent_folder -ChildPath '[project_name]'

# 确保父目录存在
if (-not (Test-Path -Path $parent_folder)) {
    New-Item -ItemType Directory -Path $parent_folder -Force
}

if (Test-Path -Path $target_folder) {
    Set-Location $target_folder
    git pull origin main
} else {
    git clone 'https://$(PAT)@dev.azure.com/my/git/project' $target_folder
}

虚拟环境与依赖安装步骤

$project_folder = '\\server\my\shared\folder\path\[project_name]'
$venv_path = Join-Path -Path $project_folder -ChildPath '.venv'
$requirements_path = Join-Path -Path $project_folder -ChildPath 'requirements.txt'

# 创建虚拟环境（不存在时）
if (-not (Test-Path -Path $venv_path)) {
    python -m venv $venv_path
}

# 激活虚拟环境（Windows PowerShell）
& "$venv_path\Scripts\Activate.ps1"

# 安装依赖
pip install -r $requirements_path

更优方案：使用Azure Pipeline内置任务 #

可以结合内置任务减少自定义脚本的维护成本：

1. 代码同步：先用Checkout任务拉取代码到代理工作目录，再用CopyFiles任务同步到共享目录，避免手动处理Git权限问题。
2. Python环境：用UsePythonVersion@0指定版本后，配合PowerShell完成虚拟环境创建与依赖安装。

示例简化步骤：

steps:
- checkout: self
  displayName: '拉取代码到代理工作目录'

- task: CopyFiles@2
  inputs:
    SourceFolder: '$(Build.SourcesDirectory)'
    TargetFolder: '\\server\my\shared\folder\path\[project_name]'
    CleanTargetFolder: false # 保留历史文件设为false，全量覆盖设为true
  displayName: '同步代码到共享目录'

- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.11'

- powershell: |
    $project_folder = '\\server\my\shared\folder\path\[project_name]'
    $venv_path = Join-Path $project_folder '.venv'
    if (-not (Test-Path $venv_path)) {
        python -m venv $venv_path
    }
    & "$venv_path\Scripts\Activate.ps1"
    pip install -r "$project_folder\requirements.txt"
  displayName: '配置虚拟环境并安装依赖'

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