Environment variables (original) (raw)

Environment variables that are set by AppVeyor for every build:

• APPVEYOR - True (true on Ubuntu image) if build runs in AppVeyor environment
• CI - True (true on Ubuntu image) if build runs in AppVeyor environment
• APPVEYOR_URL - AppVeyor central server(s) URL, https://ci.appveyor.com for Hosted service, specific server URL for on-premise
• APPVEYOR_API_URL - AppVeyor Build Agent API URL
• APPVEYOR_ACCOUNT_NAME - account name
• APPVEYOR_PROJECT_ID - AppVeyor unique project ID
• APPVEYOR_PROJECT_NAME - project name
• APPVEYOR_PROJECT_SLUG - project slug (as seen in project details URL)
• APPVEYOR_BUILD_FOLDER - path to clone directory
• APPVEYOR_BUILD_ID - AppVeyor unique build ID
• APPVEYOR_BUILD_NUMBER - build number
• APPVEYOR_BUILD_VERSION - build version
• APPVEYOR_BUILD_WORKER_IMAGE - current build worker image the build is running on, e.g. Visual Studio 2015 (also can be used as “tweak” environment variable to set build worker image)
• APPVEYOR_PULL_REQUEST_NUMBER - Pull (Merge) Request number
• APPVEYOR_PULL_REQUEST_TITLE - Pull (Merge) Request title
• APPVEYOR_PULL_REQUEST_HEAD_REPO_NAME - Pull (Merge) Request source repo
• APPVEYOR_PULL_REQUEST_HEAD_REPO_BRANCH - Pull (Merge) Request source branch
• APPVEYOR_PULL_REQUEST_HEAD_COMMIT - Pull (Merge) Request source commit ID (SHA)
• APPVEYOR_JOB_ID - AppVeyor unique job ID
• APPVEYOR_JOB_NAME - job name
• APPVEYOR_JOB_NUMBER - job number, i.g. 1, 2, etc.
• APPVEYOR_REPO_PROVIDER - gitHub, bitBucket, kiln, vso, gitLab, gitHubEnterprise, gitLabEnterprise, stash, gitea, git, mercurial or subversion
• APPVEYOR_REPO_SCM - git or mercurial
• APPVEYOR_REPO_NAME - repository name in format owner-name/repo-name
• APPVEYOR_REPO_BRANCH - build branch. For Pull Request commits it is base branch PR is merging into
• APPVEYOR_REPO_TAG - true if build has started by pushed tag; otherwise false
• APPVEYOR_REPO_TAG_NAME - contains tag name for builds started by tag; otherwise this variable is undefined
• APPVEYOR_REPO_COMMIT - commit ID (SHA)
• APPVEYOR_REPO_COMMIT_AUTHOR - commit author’s name
• APPVEYOR_REPO_COMMIT_AUTHOR_EMAIL - commit author’s email address
• APPVEYOR_REPO_COMMIT_TIMESTAMP - commit date/time in ISO 8601 format
• APPVEYOR_REPO_COMMIT_MESSAGE - commit message
• APPVEYOR_REPO_COMMIT_MESSAGE_EXTENDED - the rest of commit message after line break (if exists)
• APPVEYOR_SCHEDULED_BUILD - True if the build runs by scheduler
• APPVEYOR_FORCED_BUILD (True or undefined) - builds started by “New build” button or from the same API
• APPVEYOR_RE_BUILD (True or undefined) - build started by “Re-build commit/PR” button of from the same API
• APPVEYOR_RE_RUN_INCOMPLETE (True or undefined) - build job started by “Re-run incomplete” button of from the same API
• PLATFORM - platform name set on Build tab of project settings (or through platform parameter in appveyor.yml)
• CONFIGURATION - configuration name set on Build tab of project settings (or through configuration parameter in appveyor.yml)

Tweak environment variables

• APPVEYOR_ARTIFACT_UPLOAD_TIMEOUT - artifact upload timeout in seconds. Default is 600 (10 minutes)
• APPVEYOR_FILE_DOWNLOAD_TIMEOUT - timeout in seconds to download arbitrary files using appveyor DownloadFile command. Default is 300 (5 minutes)
• APPVEYOR_REPOSITORY_SHALLOW_CLONE_TIMEOUT - timeout in seconds to download repository (GitHub, Bitbucket or Azure DevOps) as zip file (shallow clone). Default is 1800 (30 minutes)
• APPVEYOR_CACHE_ENTRY_UPLOAD_DOWNLOAD_TIMEOUT - timeout in seconds to download or upload each cache entry. Default is 300 (5 minutes)
• APPVEYOR_CACHE_SKIP_RESTORE - set to true to disable cache restore
• APPVEYOR_CACHE_SKIP_SAVE - set to true to disable cache update
• APPVEYOR_WAP_ARTIFACT_NAME - custom name for WAP artifact (default is the same as project name)
• APPVEYOR_WAP_SKIP_ACLS - set to true to create WAP package, which will prevent Web Deploy from updating ACLs
• APPVEYOR_BUILD_WORKER_IMAGE - set build worker image for build to run on. Can be done only at build configuration level, not at build time
• APPVEYOR_SKIP_FINALIZE_ON_EXIT - if appveyor exit or Exit-AppVeyor build was called, exit build even without Finalize steps (on_success, on_finish scripts and build cache save)
• APPVEYOR_SAVE_CACHE_ON_ERROR - save build cache on build failure. By default build cache is being saved only during successful build Finalize steps
• APPVEYOR_ACS_DEPLOYMENT_UPGRADE_MODE - Exposes DeploymentUpgradeMode Enumeration when deploying Azure Cloud Service. Default value is Auto. Set it to Manual or Simultaneous if different behavior is required.
• APPVEYOR_IGNORE_COMMIT_FILTERING_ON_TAG - if set to true, tagged build does not respect commit filtering (except built-in [skip ci] / [ci skip] / [skip appveyor] in the commit message), branches white- and blacklisting, as well as skip_tags: true.

Did you know that you can edit this page on GitHub and send us a Pull Request?