• Overview
  • Documentation
  • Version history

Description

The Microsoft Azure DevOps source configuration plugin automates importing version artifacts from a Azure DevOps server.

Quick Info

Product icon

Product

DevOps Deploy (HCL Launch)
Plugin type icon

Type

plugin
Compatibility icon

Compatibility

HCL Launch 6.0.1 or later
created by icon

Created by

HCL Software

Published Date

Last Updated

Summary

The Microsoft Azure Devops source configuration plugin automates importing version artifacts from a Azure Devops.

Compatibility

The HCL Launch Deploy source configuration plugin for Microsoft Azure Devops Server works with Team Foundation Server, Team Explorer Everywhere, and Visual Studio Online. This plugin supports Team Foundation Server 2010, 2012, 2013, 2015 and 2017.

This plugin requires HCL Launch version 6.0.1 or later.

This plugin supports agents that are running on Microsoft Windows.

This plugin requires Microsoft .NET Framework 3.5 to be installed on the agent computer where the plugin is installed.

Installation

See Installing plugins in HCL Launch for installing and removing plugins.

History

The following table describes the changes made in each plugin version.

Plugin history details
Version Description
1 Initial release

Steps

The following process steps are available in the in the Azure plugin.

Import Version

Import a new version from Azure DevOps .

This step has no input properties.

Roles

The plugin adds these roles automatically to resources. You cannot add these roles manually.

AzureComponentProperties

Properties for the AzureComponentProperties role
Name Type Description Required Property
Collection URL String The URL of the AzureDevops collection, for example: https://dev.azure.com/. Y ${p:component/AzureComponentProperties/url}
Extensions of files to convert String The list of file extensions to be converted, if text-type files must be converted into another character set. Matching file types are converted into the default or system character set of the system where the agent is located. Separate each list item with a comma. N ${p:component/AzureComponentProperties/extensions}
Local Workspace Folder String The path to the local workspace folder of the computer with the agent. If the folder does not exist, it is created to the specified path. This value is only used if the Workspace property is specified. Otherwise, a temporary folder is created in the agent working directory. Y ${p:component/AzureComponentProperties/localFolder}
Password Password The password for the account that has access to the Azure DevOps Server. N  
Path to tf.exe or tf.cmd String The full path to the Visual Studio or Team Explorer Everywhere tf.exe or tf.cmd file. If a value is not specified, the tf executable file must be available on the agent’s PATH environment variable. N ${p:component/AzureComponentProperties/tfExePath}
Preserve execute permissions Boolean For Linux and UNIX operating systems, retain the execute permissions for each file. N ${p:component/AzureComponentProperties/saveFileExecuteBits}
Server Project Folder String The path variable to the project folder on Visual Studio Online or the Team Foundation
Server server. The default is $/ followed by the name of the project.
N ${p:component/AzureComponentProperties/serverFolder}
User String The user name for the account that has access to the Azure DevOps Server. N ${p:component/AzureComponentProperties/username}
Workspace String The name of the Team Foundation Server or Azure DevOps Online workspace. To get a list of workspace names from the server, run the following command: TF workspaces /collection:Repository_URL /login:user,password. For Azure DevOps Online, alternate authentication credentials must be enabled. Y ${p:component/AzureComponentProperties/workspace}

AzureImportProperties

Properties for the AzureImportProperties role
Name Type Description Required
Changeset String The version integer of the Azure DevOps Server changeset to load. No
Label String The name of the version label to load. No

Troubleshooting

Unable to delete temporary workspace

The server does not have the privileges that are required to delete the local temp file. This error message does not affect the standard operation of the plug-in.

Error Creating New Version: TFS Map Workspace Error: An argument error occurred: The workspace name <workspace_name> matches more than one cached workspace. Try adding the workspace owner to the workspace spec to match a specific workspace.

tf workspaces /remove:* to clear the cache. If you created more than one workspace with the same name, delete the redundant workspace and then clear the cache.

 

Error Creating New Version: Error retrieving latest build.

Install Microsoft .NET Framework 3.5 on the agent computer where the plug-in is installed.

    Version

  • 1.1112501

launch-sourceconfig-azure-1.1112501.zip

Uploaded: 08-Jul-2021 14:20

Release Note

Initial Release.

Related Plugins