226fa67a02
Continue to implement #2698: - Add `core/base-service/index.js` (but hold off on moving the things it imports) - Add shortcuts in `services/index.js` for Base*Service, errors, and deprecatedService. This file will be streamlined later to avoid cluttering it with rarely used bits. - Apply consistent ordering of imports and use of `module.exports` in testers. - Remove some renaming of imports. - Remove obsolete tests here and there.
93 lines
3.0 KiB
JavaScript
93 lines
3.0 KiB
JavaScript
'use strict'
|
|
|
|
const BaseSvgService = require('../base-svg-scraping')
|
|
const { NotFound } = require('..')
|
|
const { keywords, fetch } = require('./azure-devops-helpers')
|
|
const { renderBuildStatusBadge } = require('../../lib/build-status')
|
|
|
|
const documentation = `
|
|
<p>
|
|
A badge requires three pieces of information: <code>ORGANIZATION</code>,
|
|
<code>PROJECT_ID</code> and <code>DEFINITION_ID</code>.
|
|
</p>
|
|
<p>
|
|
To start, edit your build definition and look at the url:
|
|
</p>
|
|
<img
|
|
src="https://user-images.githubusercontent.com/3749820/47259976-e2d9ec80-d4b2-11e8-92cc-7c81089a7a2c.png"
|
|
alt="ORGANIZATION is after the dev.azure.com part, PROJECT_NAME is right after that, DEFINITION_ID is at the end after the id= part." />
|
|
<p>
|
|
Then use the Azure DevOps REST API to translate the
|
|
<code>PROJECT_NAME</code> to a <code>PROJECT_ID</code>.
|
|
</p>
|
|
<p>
|
|
Navigate to <code>https://dev.azure.com/ORGANIZATION/_apis/projects/PROJECT_NAME</code>
|
|
</p>
|
|
<img
|
|
src="https://user-images.githubusercontent.com/3749820/47266325-1d846900-d535-11e8-9211-2ee72fb91877.png"
|
|
alt="PROJECT_ID is in the id property of the API response." />
|
|
`
|
|
|
|
module.exports = class AzureDevOpsBuild extends BaseSvgService {
|
|
static get category() {
|
|
return 'build'
|
|
}
|
|
|
|
static get route() {
|
|
return {
|
|
base: '',
|
|
format: '(?:azure-devops|vso)/build/([^/]+)/([^/]+)/([^/]+)(?:/(.+))?',
|
|
capture: ['organization', 'projectId', 'definitionId', 'branch'],
|
|
}
|
|
}
|
|
|
|
static get examples() {
|
|
return [
|
|
{
|
|
title: 'Azure DevOps builds',
|
|
pattern: 'azure-devops/build/:organization/:projectId/:definitionId',
|
|
namedParams: {
|
|
organization: 'totodem',
|
|
projectId: '8cf3ec0e-d0c2-4fcd-8206-ad204f254a96',
|
|
definitionId: '2',
|
|
},
|
|
staticPreview: renderBuildStatusBadge({ status: 'succeeded' }),
|
|
keywords,
|
|
documentation,
|
|
},
|
|
{
|
|
title: 'Azure DevOps builds (branch)',
|
|
pattern:
|
|
'azure-devops/build/:organization/:projectId/:definitionId/:branch',
|
|
namedParams: {
|
|
organization: 'totodem',
|
|
projectId: '8cf3ec0e-d0c2-4fcd-8206-ad204f254a96',
|
|
definitionId: '2',
|
|
branch: 'master',
|
|
},
|
|
staticPreview: renderBuildStatusBadge({ status: 'succeeded' }),
|
|
keywords,
|
|
documentation,
|
|
},
|
|
]
|
|
}
|
|
|
|
async handle({ organization, projectId, definitionId, branch }) {
|
|
// Microsoft documentation: https://docs.microsoft.com/en-us/rest/api/vsts/build/status/get
|
|
const { status } = await fetch(this, {
|
|
url: `https://dev.azure.com/${organization}/${projectId}/_apis/build/status/${definitionId}`,
|
|
qs: { branchName: branch },
|
|
errorMessages: {
|
|
404: 'user or project not found',
|
|
},
|
|
})
|
|
if (status === 'set up now') {
|
|
throw new NotFound({ prettyMessage: 'definition not found' })
|
|
}
|
|
if (status === 'unknown') {
|
|
throw new NotFound({ prettyMessage: 'project not found' })
|
|
}
|
|
return renderBuildStatusBadge({ status })
|
|
}
|
|
}
|