Child pages
  • VMware vSphere Cloud
Skip to end of metadata
Go to start of metadata
Icon

The plugin is bundled since TeamCity 10.0. Recent versions are described in the online documentation for the appropriate TeamCity version.

 

On this page:

General Info

Vendor

Jetbrains

License

Apache 2.0

Type

open-source

Status

beta

Description

TeamCity vSphere integration allows using TeamCity agent cloud features with VMWare vSphere and vCenter installation. It requires configuring TeamCity with your VMWare vSphere/vCenter account and then handles automatic creation/starting/stopping/deleting of the virtual machines with TeamCity agents on-demand, based on the queued builds.

Pre-requisites

Icon

 The plugin requires a write access for vSphere/vCenter via API, which is available in the licensed versions; the API support of free versions is limited to read-only  access.

Before you can start using vSphere integration, you need to create a Virtual Machine with the TeamCity Build Agent installed and set to start automatically. Also, you need to manually point the agent to an existing TeamCity server with the vSphere plugin installed and start build agent to let the build agent download the plugins.

Features

The plugin allows you to:

  • select the type of behavior:
    • either to start/stop an existing virtual machine
    • or clone a virtual machine or a template, deleting the clone once it becomes idle (when the build is finished or an idle timeout elapses, depending on the profile settings)
  • select a virtual machine snapshot to start
  • specify the folder for clones and the resource pool where your machine will be allocated
  • configure the maximum number of started instances .

Usage

The following steps are required to set up TeamCity-VMware vSphere agent cloud integration:

  1. Download the TeamCity-VMware vSphere plugin.
  2. Install the plugin on the TeamCity Server.
  3. Create a virtual machine where your builds will run. Refer to the VMware vSphere web site for details on creating virtual machines.
  4. Prepare a machine with an installed TeamCity agent.

    Icon

    When configuring the TeamCity build agent, be sure to specify the valid TeamCity server URL in the build agent properties.

    1. If you want TeamCity to start/stop this machine on demand or to clone it, proceed to configuring the VMware cloud profile on the TeamCity server.
    2. If you want to create a template of this machine and clone it, refer to the VMware vSphere web site for details on creating templates and proceed to configuring the VMware cloud profile on the TeamCity server. Make sure to specify the valid vCenter SDK URL.

TeamCity Versions Compatibility

Since TeamCity 8.1.2

Download

Teamcity VMware vSphere plugin

Sources

https://github.com/JetBrains/teamcity-vmware-plugin

Continuous Integration

The current build status is
Detailed CI status page

  • No labels

2 Comments

  1. It should be noted that this plugin only works for the licensed version of vSphere and vCenter.

    1. Yes, plugin requires a write access for vSphere/vCenter via API, which is only available in paid versions.