https://github.com/jetbrains/teamcity-azure-agent

TeamCity support for Azure cloud build agents
https://github.com/jetbrains/teamcity-azure-agent

azure azure-vm cloud teamcity teamcity-plugin

Last synced: about 1 month ago
JSON representation

TeamCity support for Azure cloud build agents

• Host: GitHub
• URL: https://github.com/jetbrains/teamcity-azure-agent
• Owner: JetBrains
• License: apache-2.0
• Created: 2014-07-31T12:16:34.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-05-17T09:38:00.000Z (6 months ago)
• Last Synced: 2024-05-17T10:44:15.440Z (6 months ago)
• Topics: azure, azure-vm, cloud, teamcity, teamcity-plugin
• Language: Kotlin
• Homepage:
• Size: 34.5 MB
• Stars: 48
• Watchers: 24
• Forks: 22
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# TeamCity Azure Cloud Plugin

[![official JetBrains project](http://jb.gg/badges/official.svg)](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)



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

## Table Of Contents

* [Overview](#overview)

* [Installation](#installation)

* [Usage](#usage)

* [License](#license)

* [Feedback](#feedback)

## Overview

More details about TeamCity Azure Resource Manager plugin can be found in the following [blog post](https://blog.jetbrains.com/teamcity/2016/04/teamcity-azure-resource-manager/).

Plugin supports following types of images:

* Managed images

* VHD images

* ARM templates

* [Docker images](https://hub.docker.com/r/jetbrains/teamcity-agent/)

## Installation

You can [download](https://plugins.jetbrains.com/plugin/9260-azure-resource-manager-cloud-support) the plugin build and install it as an [additional plugin](https://confluence.jetbrains.com/display/TCDL/Installing+Additional+Plugins) for TeamCity 10.x+.

## Usage

To configure Azure Resource Manager cloud profile, refer to the [wiki pages](https://github.com/JetBrains/teamcity-azure-agent/wiki).

## 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](https://confluence.jetbrains.com/display/TCDL/Build+Agent+Configuration) file:

```

azure.instance.name=

```

where `` 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](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-supported-services) in your subscription.

### Problems investigation

To investigate the problems it worth look at the `teamcity-agent.log` [agent log file](https://confluence.jetbrains.com/display/TCDL/Viewing+Build+Agent+Logs) and `teamcity-clouds.log` [server log file](https://confluence.jetbrains.com/display/TCDL/TeamCity+Server+Logs).

You could file an issue in the [TeamCity tracker](#feedback) 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](https://youtrack.jetbrains.com/newIssue?project=TW&clearDraft=true&summary=Azure+Cloud%3A&c=Assignee+Dmitry.Tretyakov&c=Subsystem+plugins%3A+other&c=tag+Azure+Resource+Manager).