Ubuntu 18.04私有Azure DevOps代理安装azureps与sqlpackage问题求助

问题1：已安装Azure PowerShell但流水线提示无满足azureps需求的代理 #

错误原因 #

Azure DevOps代理的azureps是预定义的能力标签，不是仅安装Az模块就能自动识别，同时报错还提示要求代理版本高于2.182.1，两个条件需要同时满足。

解决方案 #

1. 首先校验私有代理版本：进入DevOps项目设置-代理池-对应代理的详情页，确认版本号是否符合要求，低于要求版本先完成代理更新。
2. 修正Azure PowerShell安装逻辑，默认Install-Module仅为当前用户安装模块，代理运行用户可能无权限访问，修改Dockerfile配置如下：

RUN wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb &&\
    dpkg -i packages-microsoft-prod.deb &&\
    apt-get update &&\
    add-apt-repository universe &&\
    apt-get install -y powershell &&\
    # 全局安装模块，所有运行代理的用户都可访问
    pwsh -c 'Install-Module -Name Az -Force -Scope AllUsers -AllowClobber' &&\
    pwsh -c 'Install-Module -Name PowerShellGet -Force -Scope AllUsers'

3. 手动补充代理能力标签：在代理配置的.env文件中添加AZUREPS_PATH=/usr/bin/pwsh，或直接进入代理详情页的「能力」 tab 手动新增键为azureps、值为pwsh可执行文件路径的记录，刷新后流水线即可识别到对应能力。

问题2：安装sqlpackage时提示unzip找不到文件 #

错误原因 #

Dockerfile中每个RUN指令都是独立的镜像层，第一个RUN下载的zip包存放在当时的工作目录，第二个RUN执行cd ~后工作目录切换，两个层的文件路径不互通，所以找不到zip包。

解决方案 #

合并安装逻辑为同一RUN层，同时改为全局安装避免用户权限问题，修正后的Dockerfile配置如下：

RUN apt-get update && apt-get install -y unzip libunwind8 libicu60 && \
    # 全局路径安装，所有用户可调用
    mkdir -p /opt/sqlpackage && \
    wget -q https://download.microsoft.com/download/0/2/0/020aa2fa-f3f2-41ba-bacd-ff15557890d3/sqlpackage-linux-x64-en-US-15.0.5084.2.zip -P /tmp && \
    unzip /tmp/sqlpackage-linux-x64-en-US-15.0.5084.2.zip -d /opt/sqlpackage && \
    chmod a+x /opt/sqlpackage/sqlpackage && \
    # 全局配置PATH，不依赖单用户.bashrc
    echo "export PATH=\$PATH:/opt/sqlpackage" >> /etc/profile.d/sqlpackage.sh && \
    rm -rf /tmp/*.zip

最终验证步骤 #

镜像构建完成后启动容器执行以下命令验证配置生效：

• 执行pwsh -c "Get-Module Az -ListAvailable"确认Az模块正常加载
• 执行sqlpackage /version确认sqlpackage可正常调用
• 重启代理服务，刷新代理能力列表确认azureps标签已被识别

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