payvision-development/scribe

:rocket: Azure Devops continuous delivery audit in Freshservice

Scribe

The goal of this project is to capture Azure Devops service hooks events, specifically those related with the release pipeline from Azure Devops release pipelines keeping track of the progress and recording changes in real time in Freshservice platform auditing all the continuous delivery process.

Documentation

• Build and execution
  • Debugging in Visual Studio Code
• Execution flow
• Configuration
• Freshservice

Example

A new release is created from Azure Devops release pipelines, usually you define the release pipeline using stages.

Each stage is recorded and will result in a detailed and always updated Freshservice Change for each deployment, most of the descriptions constains links to each item in Azure DevOps portal.

scribe's Issues

Complete Freshservice change creation with an Agent user

Agent user should be submitted with the id of the Freshservice agent user

"owner_id": <id>,

Create TFS documentation for API calls and user permissions

Explain main API calls and permissions needed for each project.

Specify basic authorized scopes when creating a personal access token to make API requests.

Add support to get information about all TFS artifact types

Add support to get information about 'Jenkins', 'GitHub', 'Nuget', 'Team Build (external)', 'ExternalTFSBuild', 'Git', 'TFVC' and 'ExternalTfsXamlBuild' artifact types when composing change description

Create a multi-stage build in Docker to reduce the container size

If possible minimize the entire runtime environment (FROM scratch)

Add SonarQube integration

Use SonarQube as a Service (free for opensource projects)

Add VSTS client to register related work items to the Freshservice change

Don't create session for Fabrikam "ms.vss-release.deployment-started-event" test event

Avoid create a session with this configuration in order to see new changes created when a user click on Test web hook button from TFS configuration page.

Complete Freshservice change creation with a Business Domain

Associate known business domains to Team Projects or Artifacts in order to provide a more detailed change request in Freshservice platform

In the request json set the Business Domain name through "custom_field_values" field

"custom_field_values": {
    "notification_type_117995": null,
    "business_domain_117995": "<Domain name>",
    "sub_117995": null,
    "test_results_117995": null
}

Set Unknown if there is no business domain available for a project

Check VSTS user account permissions for API requests

Check permissions for VSTS/TFS user before make TFS API requests to avoid error 401 Unauthorized

Permissions needed:

• View releases

These permissions are assigned by Team Project

Add information about missing permissions in the /status endpoint