Az Cli的az devops wiki命令--file-path参数各类传入方式咨询

核心规则说明 #

az devops wiki page create、az devops wiki page update 命令的 --file-path 参数原生不支持直接传入非本地文件系统路径，仅能读取当前命令执行环境下可直接访问的本地文件路径。以下三类场景均需要先将目标文件同步到执行环境本地，再传入路径调用命令：

场景1：传入远程HTTP/HTTPS URL对应的文件 #

需先通过文件下载工具将远程文件拉取到执行环境本地，再传入本地路径调用命令，Azure Pipeline 中参考实现如下：

# 下载远程文件到代理本地临时目录
curl -o ./local_wiki_content.md "http://你的远程文件访问地址"
# 调用Az Cli创建/更新Wiki页面
az devops wiki page create --path '远程内容同步页面' --wiki myprojectwiki --file-path ./local_wiki_content.md

若远程文件需要鉴权，可在curl命令中增加-u参数或Authorization请求头传入认证信息即可。

场景2：传入Azure Repo中的文件 #

需先在Pipeline中配置对应仓库的拉取步骤，将仓库代码拉取到代理本地后，直接传入本地文件路径即可，Pipeline YAML参考实现如下：

steps:
# 拉取目标仓库到代理本地
- checkout: git://你的项目名称/目标仓库名称@main
  path: 'repo_wiki_files'
- task: AzureCLI@2
  inputs:
    azureSubscription: '你的Azure服务连接名称'
    scriptType: 'bash'
    inlineScript: |
      az devops wiki page update \
        --path 'Repo内容同步页面' \
        --wiki myprojectwiki \
        --file-path $(Pipeline.Workspace)/repo_wiki_files/仓库内文件路径/wiki.md

场景3：传入共享文件夹UNC路径对应的文件 #

根据代理操作系统的不同，先完成共享目录的访问授权，再传入路径调用命令即可：

Windows代理参考实现 #

# （可选）若共享目录需要身份验证，先完成挂载认证
net use \\共享服务器地址\共享目录 /user:你的域名\你的账号 你的密码
# 直接传入UNC路径调用命令
az devops wiki page create --path '共享文件同步页面' --wiki myprojectwiki --file-path \\共享服务器地址\共享目录\target_wiki.md

Linux代理参考实现 #

# 先将UNC共享目录挂载到本地路径
mkdir -p /mnt/wiki_share
mount -t cifs //共享服务器地址/共享目录 /mnt/wiki_share -o username=你的账号,password=你的密码
# 传入挂载后的本地路径调用命令
az devops wiki page create --path '共享文件同步页面' --wiki myprojectwiki --file-path /mnt/wiki_share/target_wiki.md

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