https://github.com/jonnyzzz/teamcity.node

Node.js, NPM and Phantom.JS runners for TeamCity
https://github.com/jonnyzzz/teamcity.node

Last synced: 9 days ago
JSON representation

Node.js, NPM and Phantom.JS runners for TeamCity

• Host: GitHub
• URL: https://github.com/jonnyzzz/teamcity.node
• Owner: jonnyzzz
• License: apache-2.0
• Created: 2013-01-12T10:18:44.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2024-03-25T20:16:38.000Z (8 months ago)
• Last Synced: 2024-10-22T20:33:51.969Z (16 days ago)
• Language: Kotlin
• Homepage:
• Size: 6.18 MB
• Stars: 309
• Watchers: 12
• Forks: 49
• Open Issues: 63
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
TeamCity Node plugin

====================

This is a plugin for TeamCity that provides following build runners

- [Node.js](http://nodejs.org/) 

- [NPM](https://npmjs.org/)

- [Phantom.JS](http://phantomjs.org) 

- [Grunt](http://gruntjs.com)

- [NVM](https://github.com/nvm-sh/nvm)

- [Gulp](http://gulpjs.com/)

- [Bower](https://bower.io/)

- [Yarn](https://yarnpkg.com/en/)

Plugin is implemented with [JetBrains Kotlin](https://kotlinlang.org/)

Features

========

- Environment detection

 - Plugin detects node.js in system PATH `node.js` and reports it's version as configuration parameter `node.js`.

 - Plugin detects system wide installed `npm` and reports it's version as configuration parameter `node.js.npm`

- Build Runners

 - `node.js` build runner to run `.js` file or source code

 - `node.js NPM` build runner to execute NPM commands

 - `node.js NVM Installer` build runner to install/update to selected version of Node.js

 - `Phantom.JS` build runner to run `.js`, `.coffee` (or other script) file or source code.

 - `Grunt` build runner to run your grunt scripts. It's assumes you have `grunt` and `grunt-cli` NPM packages installed to local repo

 - `Gulp` build runner to run you gulp scripts

 - `Bower` build runner to run you bower scripts

 - `Yarn` build runner to execute yarn commands

License

==========

Apache 2.0

Supported Versions

==================

Plugin is tested to work with TeamCity 7.1, 8.0, 8.1, 9.0 and 9.1.

It should work with 7.0 (and maybe 6.5)

Agent and server are expected to run JRE 1.7 (or maybe JRE 1.6)

Downloading Build

=================

Download the latest build from [TeamCity](https://teamcity.jetbrains.com/viewType.html?buildTypeId=bt434) 

Installation

============

* Download the plugin build (binaries) from https://teamcity.jetbrains.com/guestAuth/repository/download/bt434/.lastSuccessful/jonnyzzz.node.zip

  * If the link does not work, select latest successful build here https://teamcity.jetbrains.com/viewType.html?buildTypeId=bt434

* Make sure downloaded `.zip` file is not corrupted

* Put the downloaded plugin `.zip` file into `/plugins` folder

* Restart the TeamCity Server 

* Open ```Administration | Plugins``` and check you see the plugin listed

For more details, there is [documentation](http://confluence.jetbrains.net/display/TCD7/Installing+Additional+Plugins)

Building

=========

- Define `$TeamCityDistribution$` IDEA path variable with path to TeamCity home (unpacked `.tar.gz` or installed `.exe` distribution).

- Add tomcat application server named `Tomcat 7` into IDEA settings from TeamCity distribution path

- Use IDEA build runner in TeamCity of Intellij IDEA 12 with Kotlin plugin to develop

In this repo you will find

=============================

- TeamCity server and agent plugin bundle

- Plugin version will be patched if building with IDEA build runner in TeamCity

- Run configuration `server` to run/debug plugin under TeamCity (use `http://localhost:8111/bs`)

- pre-configured IDEA settings to support references to TeamCity

- Uses `$TeamCityDistribution$` IDEA path variable as path to TeamCity home (unpacked .tar.gz or .exe distribution)

- Bunch of libraries for most recent needed TeamCity APIs

- Module with TestNG tests that uses TeamCity Tests API

Troubleshooting

===============

- Unmet requirements: *npm package* exists

When your your NPM packages folder in your PATH system environment variable is pointing to the system profile ("C:\Windows\System32\config\systemprofile\AppData\Roaming\npm") you will get this error. This is because this plugin runs under 32 bit and this folder will redirect 32 bit applications trying to access it to "C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\npm". To resolve this point your NPM packages folder in your PATH environment variable to a different folder (e.g. C:\npm) or point it to the SysWow64 folder above. 

Note

====

This plugin was created with [TeamCity Plugin Template](https://github.com/jonnyzzz/TeamCity.PluginTemplate)

This is my (Eugene Petrenko) private home project