Azure ADO流水线跨阶段传递SSH私钥变量被截断问题

问题根源 #

跨阶段传递多行字符串变量时，换行符会被Azure ADO默认处理为分隔符，导致仅保留第一行内容。Base64编码是可行方案，但需注意编码/解码的字符编码一致性，以及变量传递的正确配置。

解决步骤 #

1. 在Windows代理的RetrieveSSHkeys阶段编码私钥 #

获取到完整SSH私钥后，用UTF-8无BOM编码为Base64字符串，并设置为输出变量（供后续阶段引用）：

# 假设$sshKey是从Cyberark获取的完整私钥内容
$utf8Bytes = [System.Text.Encoding]::UTF8.GetBytes($sshKey)
$base64Key = [System.Convert]::ToBase64String($utf8Bytes)
# 将Base64字符串设为流水线输出变量
Write-Host "##vso[task.setvariable variable=base64SshKey;isOutput=true;]$base64Key"

注意：必须使用isOutput=true标记变量，否则后续阶段无法引用。

2. 在Linux代理的AnsibleRoles阶段解码并使用 #

引用前一阶段的输出变量，解码后写入临时文件，并设置正确权限：

# 引用RetrieveSSHkeys阶段的输出变量（假设阶段内任务名为RetrieveKeys）
echo "$(RetrieveKeys.base64SshKey)" | base64 -d > /tmp/temp-sshkey
# 设置私钥文件权限（Ansible要求严格权限）
chmod 600 /tmp/temp-sshkey

关键：用echo+管道传递Base64字符串，避免shell将换行符解析为命令分隔符，确保解码完整。

常见问题排查 #

• 若解码后仍不完整：检查PowerShell编码是否为UTF-8无BOM，避免使用[System.Text.Encoding]::Default（Windows默认是GBK）。
• 变量引用失败：确认后续阶段已正确关联前一阶段的输出变量，语法为$(阶段名.任务名.变量名)或$(任务名.变量名)（若阶段内只有一个任务）。

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