Documentation

No results
    gitHub

    Azure DevOps Repos

    The information below applies to repositories hosted on Azure Repos, part of Azure DevOps Services. It explains how to grant Hackolade Studio access to your Azure DevOps account, which is a pre-requisite for using the features submit for review and review change requests.

     

    Important note: while Azure Repos supports two types of version control: Git and Team Foundation Version Control (TFVC), Hackolade Studio will only function with the Git type in Azure Repos.

     

    Warning on Windows machines: if you get an error message "OpenSSL SSL_connect: Connection was reset in connection to dev.azure.com:443".  This issue is not specifically related to Hackolade Studio.  It can be solved by turning off IPv6 in Network Connections.  See this page for instructions.

     

    Personal Access Tokens

    You first need to provide the name of your Azure DevOps organization in the repository connection manager.

     

    Worgroup - manage connection Azure DevOps

     

    You must provide a personal access token, which is  a complex password generated by Azure DevOps. Click on the "generate" link located to the right of the input field to navigate to the personal access token creation screen. Note that the link won't work if the name of your organization is empty or incorrect.

     

    On Azure DevOps, click on the "New token" button, give it a meaningful name - e.g. "Hackolade Studio" - and select the permissions "Code:read & write" and "Graph:read" (available under "Show all scopes").

     

     

    Worgroup - Azure DevOps Repos token form

     

     

    Click on the "Create" button, then copy-paste the generated token in Hackolade Studio. As a last step, click on the "Connect" button and you are all set!  In case you need more information about personal access tokens, you can have a look at the Azure DevOps documentation.

     

    Note: the use of regular username and password has been deprecated by Azure DevOps for security reasons on March 2, 2020 (read this page for more details). That's why it is not supported by Hackolade.

     

    If you haven't set a valid personal access token, you may get the error message below, indicating that your token has been revoked, or that it does not grant enough permissions to Hackolade Studio.

     

    Worgroup - Azure DevOps Repos token error

     

    If you see this message, please follow the instructions above.

     

    Troubleshooting

    For issues when Git clone or push fails to an Azure DevOps repository.  Please consult this Microsoft article..

     

    A possible cause, as provided by the HackoladeGit.log can be "SSL certificate problem: unable to get local issuer certificate".  This is caused by the fact that your organization might be using self-signed certificates (often in the context of dev or test environments -- rarely in prod environments...) and this self-signed certificate is not present in the local certificate storage.  This situtaion and the solution are well described in this Microsoft link.