npm package: @itentialopensource/prebuilt-promotion-azure-devops
Description: Prebuilt Promotion for Azure DevOps
Author: Itential
Latest version: 2.0.0-2023.1.9

# Prebuilt Promotion Azure DevOps

## Overview

This Pre-Built Automation bundle contains several example use cases that are applicable when the Itential Automation Platform is integrated with the Azure DevOps. Because every environment is different, these use cases are fully functioning examples that can be easily modified to operate in your specific environment. These workflows have been written with modularity in mind to make them easy to understand and simple to modify to suit your needs.


## Workflows


<table>
  <thead>
    <tr>
      <th>Name</th>
      <th>Overview</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href='https://gitlab.com/itentialopensource/pre-built-automations/prebuilt-promotion-azure-devops/-/blob/release/2023.1/documentation/Prebuilt Promotion Azure DevOps.md' target='_blank'>Prebuilt Promotion Azure DevOps</a></td>
      <td>Prebuilt Promotion Azure DevOps takes a prebuilt installed on IAP in Admin Essentials and creates a new repository or updates an existing repository by way of a pull request in Azure DevOps. This repository contains the prebuilt's IAP components as well as script and pipeline files to verify the prebuilt's artifact.json file is generated correctly, increments the prebuilt version, updates CHANGELOG of changes made to the prebuilt, and optionally promotes the prebuilt to another IAP environment.</td>
    </tr>
  </tbody>
</table>


## External Dependencies

<table>
  <thead>
    <tr>
      <th>Name</th>
      <th>OS Version</th>
      <th>API Version</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Azure DevOps</td>
      <td></td>
      <td>^7.0</td>
    </tr>    <tr>
      <td>App-Artifacts</td>
      <td></td>
      <td>^6.5.3-2023.1.5</td>
    </tr>
  </tbody>
</table>

## Adapters

<table>
  <thead>
    <tr>
      <th>Name</th>
      <th>Version</th>
      <th>Configuration Notes</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="https://gitlab.com/itentialopensource/adapters/devops-netops/adapter-azure_devops">adapter-azure_devops</a></td>
      <td>^0.3.0</td>
      <td>Note that this adapter configuration assumes a Personal Access Token has been created and is configured to have access to the organization needed in Azure DevOps. A Personal Access Token can be created in the Azure DevOps UI under `User Settings` next to your account icon. See documentation <a href="https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?toc=%2Fazure%2Fdevops%2Forganizations%2Ftoc.json&view=azure-devops&tabs=Windows" target="_blank">here</a> for more details. 

- Under properties.properties:
  - `"host" : "dev.azure.com"`
  - `"base_path" : ""`
  - `"protocol" : "https"`
- Under properties.properties.authentication:
  - `"auth_method": "basic user_password"`
  - `"username": "Basic"`
  - `"password": "<value of personal access token>"`
  - `"auth_field": "header.headers.Authorization"`
  - `"auth_field_format": "Basic {b64}{username}:{password}{/b64}"`
- If the `auth_method` field is `static_token`, under properties.properties.authentication:
  - `"auth_method": "static_token"`
  - `"token": "<value of personal access token>"`
  - `"auth_field": "header.headers.Authorization"`
  - `"auth_field_format": "Basic {b64}Basic:{token}{/b64}"`

- Under properties.properties.request:
  - `"attempt_timeout" : 15000`</td>
    </tr>
  </tbody>
</table>