Azure DevOps 파이프라인에서 변수 사용

우리는 Windows 및 기타 개발을 위한 훌륭한 도구인 Azure DevOps에 대한 검토를 계속합니다. 이번에는 환경변수로 인해 많은 고민을 하다가 그 모든 경험을 한 글에 담기로 했습니다.

각 실행 환경에 대해 서로 다른 구문을 가지고 있다는 사실에서 시작하여 파이프라인의 한 단계에서 다른 단계로 변수를 전송하는 표준 기능이 부족하다는 사실로 끝납니다.

YAML이 아직 릴리스 파이프라인에 도달하지 않았고 많은 단계와 많은 아티팩트의 기능이 필요하기 때문에 주요 예제는 릴리스 파이프라인에 있도록 예약하겠습니다. 이는 일반 파이프라인에서 사용할 수 있게 된 것으로 보이며 기능면에서 거의 동일합니다. Pipelines YAML에서는 설정할 수 있는 매개변수가 포함된 텍스트 표현에 작은 그래픽 도구 설명을 추가했습니다. 각 모듈에 대한 문서를 검토할 필요가 없어 매우 편리합니다. 하지만 이에 대해서는 다음 기사에서 설명하겠지만 지금은 혁신 자체에 대한 그림이 나와 있습니다.

보관 및 사용

시스템에 기본 변수가 있다는 사실부터 시작해 보겠습니다. 출처에 따라 릴리스(Release), 시스템(System) 등의 단어로 시작됩니다. 전체 목록(알고보니 그렇지 않음)은 다음에서 확인할 수 있습니다. 선적 서류 비치. 구문이 포함된 모든 정신분열증은 아래 문서의 예를 통해 설명됩니다. 동일한 변수는 호출 위치에 따라 세 가지 표현을 갖습니다.

steps:
 - bash: echo This script could use $SYSTEM_ACCESSTOKEN
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)
  - powershell: Write-Host "This is a script that could use $env:SYSTEM_ACCESSTOKEN"
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)

작업이 실행되는 에이전트에 변수를 설정하면 $(System.AccessToken)입니다. 동일한 에이전트의 powershell 스크립트 내에서 사용하려는 경우 이미 $env:SYSTEM_ACCESSTOKEN입니다. 신이시여, 대상 머신 작업에서 PowerShell을 사용하여 일부 원격 호스트에서 이 변수를 사용하려면 이를 인수를 통해 스크립트에 전달해야 합니다. 내 돈. Bash를 사용하면 더 간단합니다. $SYSTEM_ACCESSTOKEN 인수와 구문을 사용하여 내부에 간단히 전달할 수 있습니다.

동일한 법칙이 자신의 변수에 적용되지 않습니다. 여기서는 이미 구문에 대한 책임이 있습니다. 변수는 각 작업에서 로컬로 설정할 수 있습니다.

또는 전역적으로 변수 저장소에 연결한 다음 저장소에서 연결합니다. 매우 편안합니다.

보너스로 변수가 매우 비밀스러운 경우 Azure 클라우드의 Azure Vault라는 저장소에 저장할 수 있으며 Vault를 라이브러리의 프로젝트에 연결할 수 있습니다.

일반적으로 변수를 사용하면 모든 것이 명확합니다. 파이프라인에서는 실행할 때마다 수동으로 설정할 수 있지만 릴리스에는 그러한 기능이 없습니다. 에이전트 초기화 로그에서 파이프라인으로 전송 중인 내용을 다시 확인할 수 있지만 이미 변환된 형식으로 존재한다는 점을 명심하세요.

동적 변수

재미는 한 단계에서 어떤 가치를 받고 다음 단계로 전달하고 싶을 때 시작됩니다.

우리는 그러한 기능을 제공받지 못했습니다. 그러나 우리 손은 지루하지 않으며 Google의 도움으로 해결책을 찾았습니다. 감사하게도 Azure DevOps에는 인터페이스에 표시된 것보다 조금 더 많은 작업을 수행할 수 있는 API가 있습니다.

따라서 파이프라인 내에서 직접 수행할 전역 변수를 업데이트하기 위한 호출이 필요합니다. 주소는 앞에서 언급한 것처럼 설명서에 언급되지 않은 것과 동일한 환경 변수에서 가져옵니다. 직접 설정할 수도 있고, 상점이 문을 닫을 경우 하드코딩할 수도 있습니다.

$releaseurl = ('{0}{1}/_apis/release/releases/{2}?api-version=5.0' -f $($env:SYSTEM_TEAMFOUNDATIONSERVERURI), $($env:SYSTEM_TEAMPROJECTID), $($env:RELEASE_RELEASEID)  )

전송하려는 변수의 빈 값을 설정하고 범위 - 릴리스를 설정합니다.

예를 들어, 임의의 값 생성기를 만듭니다. 이 단계 내에서 변수를 선언하는 구문에 주의하세요. 이 기능이 도입되었습니다.

다음 단계에서는 변수를 스크립트에 전달합니다. 예, 예, 직접적으로는 불가능하며 인수를 통해 전달되어야 합니다.

스포일러 있는 스크립트

PowerShell을

#Script requires stageVar variable in release variables set to Release scope

param ( [string] $expVar )
#region variables
$ReleaseVariableName = 'StageVar'
$releaseurl = ('{0}{1}/_apis/release/releases/{2}?api-version=5.0' -f $($env:SYSTEM_TEAMFOUNDATIONSERVERURI), $($env:SYSTEM_TEAMPROJECTID), $($env:RELEASE_RELEASEID)  )
#endregion


#region Get Release Definition
Write-Host "URL: $releaseurl"
$Release = Invoke-RestMethod -Uri $releaseurl -Headers @{
    Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN"
}
#endregion

#region Output current Release Pipeline
Write-Output ('Release Pipeline variables output: {0}' -f $($Release.variables | ConvertTo-Json -Depth 10))
#endregion


#region Update StageVar with new value
$release.variables.($ReleaseVariableName).value = "$expVar"
#endregion

#region update release pipeline
Write-Output ('Updating Release Definition')
$json = @($release) | ConvertTo-Json -Depth 99
Invoke-RestMethod -Uri $releaseurl -Method Put -Body $json -ContentType "application/json" -Headers @{Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN" }
#endregion

#region Get updated Release Definition
Write-Output ('Get updated Release Definition')
Write-Host "URL: $releaseurl"
$Release = Invoke-RestMethod -Uri $releaseurl -Headers @{
    Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN"
}
#endregion

#region Output Updated Release Pipeline
Write-Output ('Updated Release Pipeline variables output: {0}' -f $($Release.variables | ConvertTo-Json -Depth 10))
#endregion

또는

강타

INPUT_VAR=$1
RELEASE_VAR=$2

echo Test ID: ${INPUT_VAR}

RELEASE_URL="${SYSTEM_TEAMFOUNDATIONSERVERURI}${SYSTEM_TEAMPROJECTID}/_apis/release/releases/${RELEASE_RELEASEID}?api-version=5.0"

echo release url: $RELEASE_URL

RELEASE_JSON=$(curl -H "Authorization: Bearer $SYSTEM_ACCESSTOKEN" $RELEASE_URL)

OUTPUT=`jq ''.variables.${RELEASE_VAR}.value' = '"${INPUT_VAR}"'' <<< $RELEASE_JSON`

curl -H "Authorization: Bearer $SYSTEM_ACCESSTOKEN" -H "Content-Type: application/json" -X PUT -d "$OUTPUT" $RELEASE_URL

간단히 말해서, 우리 스크립트는 myVar 변수를 입력으로 사용하고 API를 사용하여 이 변수의 값을 stageVar에 넣습니다. 다음 단계에서는 시스템 변수 구문을 사용하여 이를 살펴볼 수 있습니다.

예제는 매우 간단하지만 이 기능은 이전에 설명한 것 외에도 우리에게 좋은 기회를 열어줍니다. 조, 테스트의 첫 번째 단계에서 가상 머신을 생성할 수 있으면 이를 사용하여 몇 가지 추가 조작을 수행하고 여러 작업을 병렬로 수행합니다. 그리고 마지막 단계는 그것을 파괴하는 것입니다. 이제는 새로운 가상 머신에서 매번 제품의 자동 테스트를 실행합니다. 10분 정도 산다는 점을 고려하면 한 푼도 안 든다.

필요한 경우 다음 기사에서는 YAML 파이프라인에 대해 이야기하겠습니다. 최근에는 흥미로운 혁신이 많이 있었습니다.

출처 : habr.com