🥇 ცვლადების გამოყენება Azure DevOps მილსადენებში

ჩვენ ვაგრძელებთ მიმოხილვას Windows-ისთვის და სხვათა განვითარების შესანიშნავი ინსტრუმენტის, Azure DevOps-ის შესახებ. ამჯერად, რადგან ბევრი ვიტანჯე გარემოს ცვლადებით, გადავწყვიტე მთელი გამოცდილება ერთ სტატიაში მომეტანა.

დაწყებული იქიდან, რომ მათ აქვთ განსხვავებული სინტაქსი თითოეული აღსრულების გარემოსთვის, დამთავრებული მილსადენის ერთი ეტაპიდან მეორეზე ცვლადების გადაცემის სტანდარტული შესაძლებლობის არარსებობით.

მე გავაკეთებ დათქმას, რომ ძირითადი მაგალითები იქნება Release Pipelines-ზე, რადგან 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)  )

ჩვენ ვაყენებთ ცვლადის ცარიელ მნიშვნელობას, რომლის გადატანა გვინდა, ვაყენებთ Scope - Release

მაგალითად, ჩვენ ვქმნით შემთხვევითი მნიშვნელობის გენერატორს. ყურადღება მიაქციეთ ამ ეტაპის შიგნით ცვლადის გამოცხადების სინტაქსს; ეს ფუნქცია დაინერგა.

შემდეგ ეტაპზე ჩვენ გადავცემთ ცვლადს სკრიპტს, დიახ, დიახ, ეს პირდაპირ შეუძლებელია, ეს უნდა იყოს არგუმენტის საშუალებით.

სკრიპტი სპოილერის ქვეშ

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

ან

Bash

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 მილსადენებზე, ბოლო დროს იქ საკმაოდ ბევრი საინტერესო სიახლეა.

წყარო: www.habr.com

ცვლადების გამოყენება Azure DevOps მილსადენებში

შენახვა და გამოყენება

დინამიური ცვლადები

ახალი კომენტარის დამატება პასუხის გასაუქმებლად

ახალი კომენტარის დამატება