/teamcity-azure-agent

TeamCity support for Azure cloud build agents

Primary LanguageKotlinApache License 2.0Apache-2.0

TeamCity Azure Cloud Plugin

official JetBrains project

Enables TeamCity cloud integration with Microsoft Azure and allows virtual machines usage to scale the pool of build agents.

Table Of Contents

Overview

More details about TeamCity Azure Resource Manager plugin can be found in the following blog post.

Plugin supports following types of images:

Installation

You can download the plugin build and install it as an additional plugin for TeamCity 10.x+.

Usage

To configure Azure Resource Manager cloud profile, refer to the wiki pages.

Common problems

TeamCity starts virtual machine but agent is not connected

To retrieve server configuration details, the TeamCity build agent needs to read the following files:

  • %SYSTEMDRIVE%\AzureData\CustomData.bin on Windows
  • /var/lib/waagent/ovf-env.xml in Linux

Please check that user under which TeamCity build agent is running has read access permissions to the mentioned files.

TeamCity starts virtual machine instance but agent is Unauthorized

To resolve it please add the following line in the buildagent.properties file:

azure.instance.name=<agent_name>

where <agent_name> should coincide with the vm name of running cloud instance.

Container instance-based images are reporting problem "Microsoft.ContainerInstance is not available in xxx region"

You need to register "Microsoft.ContainerInstance" provider in your subscription.

Problems investigation

To investigate the problems it worth look at the teamcity-agent.log agent log file and teamcity-clouds.log server log file. You could file an issue in the TeamCity tracker and privately attach these file for investigation by TeamCity team.

License

Apache 2.0

Feedback

Please feel free to send a PR or file an issue in the TeamCity issue tracker.