268 lines
10 KiB
Python
268 lines
10 KiB
Python
"""Support code for working with Azure Pipelines."""
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
import os
|
|
import re
|
|
import tempfile
|
|
import uuid
|
|
|
|
from .. import types as t
|
|
|
|
from ..encoding import (
|
|
to_bytes,
|
|
)
|
|
|
|
from ..config import (
|
|
CommonConfig,
|
|
TestConfig,
|
|
)
|
|
|
|
from ..git import (
|
|
Git,
|
|
)
|
|
|
|
from ..http import (
|
|
HttpClient,
|
|
urlencode,
|
|
)
|
|
|
|
from ..util import (
|
|
display,
|
|
MissingEnvironmentVariable,
|
|
)
|
|
|
|
from . import (
|
|
AuthContext,
|
|
ChangeDetectionNotSupported,
|
|
CIProvider,
|
|
CryptographyAuthHelper,
|
|
)
|
|
|
|
CODE = 'azp'
|
|
|
|
|
|
class AzurePipelines(CIProvider):
|
|
"""CI provider implementation for Azure Pipelines."""
|
|
def __init__(self):
|
|
self.auth = AzurePipelinesAuthHelper()
|
|
|
|
@staticmethod
|
|
def is_supported(): # type: () -> bool
|
|
"""Return True if this provider is supported in the current running environment."""
|
|
return os.environ.get('SYSTEM_COLLECTIONURI', '').startswith('https://dev.azure.com/')
|
|
|
|
@property
|
|
def code(self): # type: () -> str
|
|
"""Return a unique code representing this provider."""
|
|
return CODE
|
|
|
|
@property
|
|
def name(self): # type: () -> str
|
|
"""Return descriptive name for this provider."""
|
|
return 'Azure Pipelines'
|
|
|
|
def generate_resource_prefix(self): # type: () -> str
|
|
"""Return a resource prefix specific to this CI provider."""
|
|
try:
|
|
prefix = 'azp-%s-%s-%s' % (
|
|
os.environ['BUILD_BUILDID'],
|
|
os.environ['SYSTEM_JOBATTEMPT'],
|
|
os.environ['SYSTEM_JOBIDENTIFIER'],
|
|
)
|
|
except KeyError as ex:
|
|
raise MissingEnvironmentVariable(name=ex.args[0])
|
|
|
|
prefix = re.sub(r'[^a-zA-Z0-9]+', '-', prefix).lower()
|
|
|
|
return prefix
|
|
|
|
def get_base_branch(self): # type: () -> str
|
|
"""Return the base branch or an empty string."""
|
|
base_branch = os.environ.get('SYSTEM_PULLREQUEST_TARGETBRANCH') or os.environ.get('BUILD_SOURCEBRANCHNAME')
|
|
|
|
if base_branch:
|
|
base_branch = 'origin/%s' % base_branch
|
|
|
|
return base_branch or ''
|
|
|
|
def detect_changes(self, args): # type: (TestConfig) -> t.Optional[t.List[str]]
|
|
"""Initialize change detection."""
|
|
result = AzurePipelinesChanges(args)
|
|
|
|
if result.is_pr:
|
|
job_type = 'pull request'
|
|
else:
|
|
job_type = 'merge commit'
|
|
|
|
display.info('Processing %s for branch %s commit %s' % (job_type, result.branch, result.commit))
|
|
|
|
if not args.metadata.changes:
|
|
args.metadata.populate_changes(result.diff)
|
|
|
|
if result.paths is None:
|
|
# There are several likely causes of this:
|
|
# - First run on a new branch.
|
|
# - Too many pull requests passed since the last merge run passed.
|
|
display.warning('No successful commit found. All tests will be executed.')
|
|
|
|
return result.paths
|
|
|
|
def supports_core_ci_auth(self, context): # type: (AuthContext) -> bool
|
|
"""Return True if Ansible Core CI is supported."""
|
|
return True
|
|
|
|
def prepare_core_ci_auth(self, context): # type: (AuthContext) -> t.Dict[str, t.Any]
|
|
"""Return authentication details for Ansible Core CI."""
|
|
try:
|
|
request = dict(
|
|
org_name=os.environ['SYSTEM_COLLECTIONURI'].strip('/').split('/')[-1],
|
|
project_name=os.environ['SYSTEM_TEAMPROJECT'],
|
|
build_id=int(os.environ['BUILD_BUILDID']),
|
|
task_id=str(uuid.UUID(os.environ['SYSTEM_TASKINSTANCEID'])),
|
|
)
|
|
except KeyError as ex:
|
|
raise MissingEnvironmentVariable(name=ex.args[0])
|
|
|
|
self.auth.sign_request(request)
|
|
|
|
auth = dict(
|
|
azp=request,
|
|
)
|
|
|
|
return auth
|
|
|
|
def get_git_details(self, args): # type: (CommonConfig) -> t.Optional[t.Dict[str, t.Any]]
|
|
"""Return details about git in the current environment."""
|
|
changes = AzurePipelinesChanges(args)
|
|
|
|
details = dict(
|
|
base_commit=changes.base_commit,
|
|
commit=changes.commit,
|
|
)
|
|
|
|
return details
|
|
|
|
|
|
class AzurePipelinesAuthHelper(CryptographyAuthHelper):
|
|
"""
|
|
Authentication helper for Azure Pipelines.
|
|
Based on cryptography since it is provided by the default Azure Pipelines environment.
|
|
"""
|
|
def publish_public_key(self, public_key_pem): # type: (str) -> None
|
|
"""Publish the given public key."""
|
|
try:
|
|
agent_temp_directory = os.environ['AGENT_TEMPDIRECTORY']
|
|
except KeyError as ex:
|
|
raise MissingEnvironmentVariable(name=ex.args[0])
|
|
|
|
# the temporary file cannot be deleted because we do not know when the agent has processed it
|
|
# placing the file in the agent's temp directory allows it to be picked up when the job is running in a container
|
|
with tempfile.NamedTemporaryFile(prefix='public-key-', suffix='.pem', delete=False, dir=agent_temp_directory) as public_key_file:
|
|
public_key_file.write(to_bytes(public_key_pem))
|
|
public_key_file.flush()
|
|
|
|
# make the agent aware of the public key by declaring it as an attachment
|
|
vso_add_attachment('ansible-core-ci', 'public-key.pem', public_key_file.name)
|
|
|
|
|
|
class AzurePipelinesChanges:
|
|
"""Change information for an Azure Pipelines build."""
|
|
def __init__(self, args): # type: (CommonConfig) -> None
|
|
self.args = args
|
|
self.git = Git()
|
|
|
|
try:
|
|
self.org_uri = os.environ['SYSTEM_COLLECTIONURI'] # ex: https://dev.azure.com/{org}/
|
|
self.project = os.environ['SYSTEM_TEAMPROJECT']
|
|
self.repo_type = os.environ['BUILD_REPOSITORY_PROVIDER'] # ex: GitHub
|
|
self.source_branch = os.environ['BUILD_SOURCEBRANCH']
|
|
self.source_branch_name = os.environ['BUILD_SOURCEBRANCHNAME']
|
|
self.pr_branch_name = os.environ.get('SYSTEM_PULLREQUEST_TARGETBRANCH')
|
|
except KeyError as ex:
|
|
raise MissingEnvironmentVariable(name=ex.args[0])
|
|
|
|
if self.source_branch.startswith('refs/tags/'):
|
|
raise ChangeDetectionNotSupported('Change detection is not supported for tags.')
|
|
|
|
self.org = self.org_uri.strip('/').split('/')[-1]
|
|
self.is_pr = self.pr_branch_name is not None
|
|
|
|
if self.is_pr:
|
|
# HEAD is a merge commit of the PR branch into the target branch
|
|
# HEAD^1 is HEAD of the target branch (first parent of merge commit)
|
|
# HEAD^2 is HEAD of the PR branch (second parent of merge commit)
|
|
# see: https://git-scm.com/docs/gitrevisions
|
|
self.branch = self.pr_branch_name
|
|
self.base_commit = 'HEAD^1'
|
|
self.commit = 'HEAD^2'
|
|
else:
|
|
commits = self.get_successful_merge_run_commits()
|
|
|
|
self.branch = self.source_branch_name
|
|
self.base_commit = self.get_last_successful_commit(commits)
|
|
self.commit = 'HEAD'
|
|
|
|
self.commit = self.git.run_git(['rev-parse', self.commit]).strip()
|
|
|
|
if self.base_commit:
|
|
self.base_commit = self.git.run_git(['rev-parse', self.base_commit]).strip()
|
|
|
|
# <commit>...<commit>
|
|
# This form is to view the changes on the branch containing and up to the second <commit>, starting at a common ancestor of both <commit>.
|
|
# see: https://git-scm.com/docs/git-diff
|
|
dot_range = '%s...%s' % (self.base_commit, self.commit)
|
|
|
|
self.paths = sorted(self.git.get_diff_names([dot_range]))
|
|
self.diff = self.git.get_diff([dot_range])
|
|
else:
|
|
self.paths = None # act as though change detection not enabled, do not filter targets
|
|
self.diff = []
|
|
|
|
def get_successful_merge_run_commits(self): # type: () -> t.Set[str]
|
|
"""Return a set of recent successsful merge commits from Azure Pipelines."""
|
|
parameters = dict(
|
|
maxBuildsPerDefinition=100, # max 5000
|
|
queryOrder='queueTimeDescending', # assumes under normal circumstances that later queued jobs are for later commits
|
|
resultFilter='succeeded',
|
|
reasonFilter='batchedCI', # may miss some non-PR reasons, the alternative is to filter the list after receiving it
|
|
repositoryType=self.repo_type,
|
|
repositoryId='%s/%s' % (self.org, self.project),
|
|
)
|
|
|
|
url = '%s%s/build/builds?%s' % (self.org_uri, self.project, urlencode(parameters))
|
|
|
|
http = HttpClient(self.args)
|
|
response = http.get(url)
|
|
|
|
# noinspection PyBroadException
|
|
try:
|
|
result = response.json()
|
|
except Exception: # pylint: disable=broad-except
|
|
# most likely due to a private project, which returns an HTTP 203 response with HTML
|
|
display.warning('Unable to find project. Cannot determine changes. All tests will be executed.')
|
|
return set()
|
|
|
|
commits = set(build['sourceVersion'] for build in result['value'])
|
|
|
|
return commits
|
|
|
|
def get_last_successful_commit(self, commits): # type: (t.Set[str]) -> t.Optional[str]
|
|
"""Return the last successful commit from git history that is found in the given commit list, or None."""
|
|
commit_history = self.git.get_rev_list(max_count=100)
|
|
ordered_successful_commits = [commit for commit in commit_history if commit in commits]
|
|
last_successful_commit = ordered_successful_commits[0] if ordered_successful_commits else None
|
|
return last_successful_commit
|
|
|
|
|
|
def vso_add_attachment(file_type, file_name, path): # type: (str, str, str) -> None
|
|
"""Upload and attach a file to the current timeline record."""
|
|
vso('task.addattachment', dict(type=file_type, name=file_name), path)
|
|
|
|
|
|
def vso(name, data, message): # type: (str, t.Dict[str, str], str) -> None
|
|
"""
|
|
Write a logging command for the Azure Pipelines agent to process.
|
|
See: https://docs.microsoft.com/en-us/azure/devops/pipelines/scripts/logging-commands?view=azure-devops&tabs=bash
|
|
"""
|
|
display.info('##vso[%s %s]%s' % (name, ';'.join('='.join((key, value)) for key, value in data.items()), message))
|