Notikumi
Veidojiet inteliģentas lietotnes
17. marts 21 - 21. marts 10
Pievienojieties meetup sērijai, lai kopā ar citiem izstrādātājiem un ekspertiem izveidotu mērogojamus AI risinājumus, kuru pamatā ir reālas lietošanas gadījumi.
Reģistrēties tūlītLogging commands
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Logging commands are how tasks and scripts communicate with the agent. They cover actions like creating new variables, marking a step as failed, and uploading artifacts. Logging commands are useful when you're troubleshooting a pipeline.
Svarīgi
We make an effort to mask secrets from appearing in Azure Pipelines output, but you still need to take precautions. Never echo secrets as output. Some operating systems log command line arguments. Never pass secrets on the command line. Instead, we suggest that you map your secrets into environment variables.
We never mask substrings of secrets. If, for example, "abc123" is set as a secret, "abc" isn't masked from the logs. This is to avoid masking secrets at too granular of a level, making the logs unreadable. For this reason, secrets shouldn't contain structured data. If, for example, "{ "foo": "bar" }" is set as a secret, "bar" isn't masked from the logs.
| Type | Commands |
|---|---|
| Task commands | AddAttachment, Complete, LogDetail, LogIssue, PrependPath, SetEndpoint, SetProgress, SetVariable, SetSecret, UploadFile, UploadSummary |
| Artifact commands | Associate, Upload |
| Build commands | AddBuildTag, UpdateBuildNumber, UploadLog |
| Release commands | UpdateReleaseName |
The general format for a logging command is:
##vso[area.action property1=value;property2=value;...]message
There are also a few formatting commands with a slightly different syntax:
##[command]message
To invoke a logging command, echo the command via standard output.
Bash
#!/bin/bash
echo "##vso[task.setvariable variable=testvar;]testvalue"
File paths should be given as absolute paths: rooted to a drive on Windows, or beginning with / on Linux and macOS.
Piezīme
Note that you can't use the set -x command before a logging command when you're using Linux or macOS. See troubleshooting, to learn how to disable set -x temporarily for Bash.
Piezīme
Use UTF-8 encoding for logging commands.
These commands are messages to the log formatter in Azure Pipelines. They mark specific log lines as errors, warnings, collapsible sections, and so on.
The formatting commands are:
##[group]Beginning of a group
##[warning]Warning message
##[error]Error message
##[section]Start of a section
##[debug]Debug text
##[command]Command-line being run
##[endgroup]
You can use the formatting commands in a bash or PowerShell task.
YAML
steps:
- bash: |
echo "##[group]Beginning of a group"
echo "##[warning]Warning message"
echo "##[error]Error message"
echo "##[section]Start of a section"
echo "##[debug]Debug text"
echo "##[command]Command-line being run"
echo "##[endgroup]"
Those commands render in the logs like this:
That block of commands can also be collapsed, and looks like this:
##vso[task.logissue]error/warning message
Log an error or warning message in the timeline record of the current task.
type=errororwarning(Required)sourcepath= source file locationlinenumber= line numbercolumnnumber= column numbercode= error or warning code
Bash
#!/bin/bash
echo "##vso[task.logissue type=error]Something went very wrong."
exit 1
Padoms
exit 1 is optional, but is often a command you'll issue soon after an error is logged. If you select Control Options: Continue on error, then the exit 1 will result in a partially successful build instead of a failed build. As an alternative, you can also use task.logissue type=error.
Bash
#!/bin/bash
echo "##vso[task.logissue type=warning;sourcepath=consoleapp/main.cs;linenumber=1;columnnumber=1;code=100;]Found something that could be a problem."
##vso[task.setprogress]current operation
Set progress and current operation for the current task.
value= percentage of completion
Bash
echo "Begin a lengthy process..."
for i in {0..100..10}
do
sleep 1
echo "##vso[task.setprogress value=$i;]Sample Progress Indicator"
done
echo "Lengthy process is complete."
To see how it looks, save and queue the build, and then watch the build run. Observe that a progress indicator changes when the task runs this script.
##vso[task.complete]current operation
Finish the timeline record for the current task, set task result and current operation. When result not provided, set result to succeeded.
result=SucceededThe task succeeded.SucceededWithIssuesThe task ran into problems. The build will be completed as partially succeeded at best.FailedThe build will be completed as failed. (If the Control Options: Continue on error option is selected, the build will be completed as partially succeeded at best.)
Log a task as succeeded.
##vso[task.complete result=Succeeded;]DONE
Set a task as failed. As an alternative, you can also use exit 1.
YAML
- bash: |
if [ -z "$SOLUTION" ]; then
echo "##vso[task.logissue type=error;]Missing template parameter \"solution\""
echo "##vso[task.complete result=Failed;]"
fi
##vso[task.logdetail]current operation
Creates and updates timeline records. This is primarily used internally by Azure Pipelines to report about steps, jobs, and stages. While customers can add entries to the timeline, they won't typically be shown in the UI.
The first time we see ##vso[task.detail] during a step, we create a "detail timeline" record for the step. We can create and update nested timeline records base on id and parentid.
Task authors must remember which GUID they used for each timeline record. The logging system keeps track of the GUID for each timeline record, so any new GUID results a new timeline record.
id= Timeline record GUID (Required)parentid= Parent timeline record GUIDtype= Record type (Required for first time, can't overwrite)name= Record name (Required for first time, can't overwrite)order= order of timeline record (Required for first time, can't overwrite)starttime=Datetimefinishtime=Datetimeprogress= percentage of completionstate=Unknown|Initialized|InProgress|Completedresult=Succeeded|SucceededWithIssues|Failed
Create new root timeline record:
##vso[task.logdetail id=new guid;name=project1;type=build;order=1]create new timeline record
Create new nested timeline record:
##vso[task.logdetail id=new guid;parentid=exist timeline record guid;name=project1;type=build;order=1]create new nested timeline record
Update exist timeline record:
##vso[task.logdetail id=existing timeline record guid;progress=15;state=InProgress;]update timeline record
##vso[task.setvariable]value
Sets a variable in the variable service of taskcontext. The first task can set a variable, and following tasks are able to use the variable. The variable is exposed to the following tasks as an environment variable.
When isSecret is set to true, the value of the variable will be saved as secret and masked out from log. Secret variables aren't passed into tasks as environment variables and must instead be passed as inputs.
When isOutput is set to true the syntax to reference the set variable varies based on whether you're accessing that variable in the same job, a future job, or a future stage. Additionally, if isOutput is set to false the syntax for using that variable within the same job is distinct. See levels of output variables to determine the appropriate syntax for each use case.
For more information about output variables, see set variables in scripts and define variables.
variable= variable name (Required)isSecret= boolean (Optional, defaults to false)isOutput= boolean (Optional, defaults to false)isReadOnly= boolean (Optional, defaults to false)
Set the variables:
YAML
- bash: |
echo "##vso[task.setvariable variable=sauce;]crushed tomatoes"
echo "##vso[task.setvariable variable=secretSauce;isSecret=true]crushed tomatoes with garlic"
echo "##vso[task.setvariable variable=outputSauce;isOutput=true]canned goods"
name: SetVars
Read the variables:
YAML
- bash: |
echo "Non-secrets automatically mapped in, sauce is $SAUCE"
echo "Secrets are not automatically mapped in, secretSauce is $SECRETSAUCE"
echo "You can use macro replacement to get secrets, and they'll be masked in the log: $(secretSauce)"
Console output:
Non-secrets automatically mapped in, sauce is crushed tomatoes
Secrets are not automatically mapped in, secretSauce is
You can use macro replacement to get secrets, and they'll be masked in the log: ***
Future jobs can also see canned goods
Future jobs can also see canned goods
##vso[task.setsecret]value
The value is registered as a secret for the duration of the job. The value will be masked out from the logs from this point forward. This command is useful when a secret is transformed (for example, base64 encoded) or derived.
Note: Previous occurrences of the secret value won't be masked.
Set the variables:
YAML
- bash: |
NEWSECRET=$(echo $OLDSECRET|base64)
echo "##vso[task.setsecret]$NEWSECRET"
name: SetSecret
env:
OLDSECRET: "SeCrEtVaLuE"
Read the variables:
YAML
- bash: |
echo "Transformed and derived secrets will be masked: $(echo $OLDSECRET|base64)"
env:
OLDSECRET: "SeCrEtVaLuE"
Console output:
Transformed and derived secrets will be masked: ***
##vso[task.setendpoint]value
Set a service connection field with given value. Value updated will be retained in the endpoint for the subsequent tasks that execute within the same job.
id= service connection ID (Required)field= field type, one ofauthParameter,dataParameter, orurl(Required)key= key (Required, unlessfield=url)
##vso[task.setendpoint id=000-0000-0000;field=authParameter;key=AccessToken]testvalue
##vso[task.setendpoint id=000-0000-0000;field=dataParameter;key=userVariable]testvalue
##vso[task.setendpoint id=000-0000-0000;field=url]https://example.com/service
##vso[task.addattachment]value
Upload and attach attachment to current timeline record. These files aren't available for download with logs. These can only be referred to by extensions using the type or name values.
type= attachment type (Required)name= attachment name (Required)
##vso[task.addattachment type=myattachmenttype;name=myattachmentname;]c:\myattachment.txt
##vso[task.uploadsummary]local file path
Upload and attach summary Markdown from an .md file in the repository to current timeline record. This summary shall be added to the build/release summary and not available for download with logs. The summary should be in UTF-8 or ASCII format. The summary appears on the Extensions tab of your pipeline run. Markdown rendering on the Extensions tab is different from Azure DevOps wiki rendering. For more information on Markdown syntax, see the Markdown Guide.
##vso[task.uploadsummary]$(System.DefaultWorkingDirectory)/testsummary.md
It's a short hand form for the command
##vso[task.addattachment type=Distributedtask.Core.Summary;name=testsummaryname;]c:\testsummary.md
##vso[task.uploadfile]local file path
Upload user interested file as additional log information to the current timeline record. The file shall be available for download along with task logs.
##vso[task.uploadfile]c:\additionalfile.log
##vso[task.prependpath]local file path
Update the PATH environment variable by prepending to the PATH. The updated environment variable will be reflected in subsequent tasks.
##vso[task.prependpath]c:\my\directory\path
Artifact publishing is not supported in Classic release pipelines.
##vso[artifact.associate]artifact location
Create a link to an existing Artifact. Artifact location must be a file container path, VC path or UNC share path.
artifactname= artifact name (Required)type= artifact type (Required)container|filepath|versioncontrol|gitref|tfvclabel
container
##vso[artifact.associate type=container;artifactname=MyServerDrop]#/1/buildfilepath
##vso[artifact.associate type=filepath;artifactname=MyFileShareDrop]\\MyShare\MyDropLocationversioncontrol
##vso[artifact.associate type=versioncontrol;artifactname=MyTfvcPath]$/MyTeamProj/MyFoldergitref
##vso[artifact.associate type=gitref;artifactname=MyTag]refs/tags/MyGitTagtfvclabel
##vso[artifact.associate type=tfvclabel;artifactname=MyTag]MyTfvcLabelCustom Artifact
##vso[artifact.associate artifactname=myDrop;artifacttype=myartifacttype]https://downloads.visualstudio.com/foo/bar/package.zip
##vso[artifact.upload]local file path
Upload a local file into a file container folder, and optionally publish an artifact as artifactname.
containerfolder= folder that the file will upload to, folder will be created if needed.artifactname= artifact name. (Required)
##vso[artifact.upload containerfolder=testresult;artifactname=uploadedresult]c:\testresult.trx
Piezīme
The difference between Artifact.associate and Artifact.upload is that the first can be used to create a link to an existing artifact, while the latter can be used to upload/publish a new Artifact.
##vso[build.uploadlog]local file path
Upload user interested log to build's container "logs\tool" folder.
##vso[build.uploadlog]c:\msbuild.log
##vso[build.updatebuildnumber]build number
You can automatically generate a build number from tokens you specify in the pipeline options. However, if you want to use your own logic to set the build number, then you can use this logging command.
##vso[build.updatebuildnumber]my-new-build-number
##vso[build.addbuildtag]build tag
Add a tag for current build. You can expand the tag with a predefined or user-defined variable. For example, here a new tag gets added in a Bash task with the value last_scanned-$(currentDate). You can't use a colon with AddBuildTag.
YAML
- task: Bash@3
inputs:
targetType: 'inline'
script: |
last_scanned="last_scanned-$(currentDate)"
echo "##vso[build.addbuildtag]$last_scanned"
displayName: 'Apply last scanned tag'
##vso[release.updatereleasename]release name
Update the release name for the running release.
Piezīme
Supported in Azure DevOps and Azure DevOps Server beginning in version 2020.
##vso[release.updatereleasename]my-new-release-name
Piezīme. Autors izveidoja šo rakstu ar AI palīdzību. Uzzināt vairāk