2017-05-28 00:38:50 +02:00
|
|
|
# ci-info
|
|
|
|
|
|
|
|
Get details about the current Continuous Integration environment.
|
|
|
|
|
|
|
|
Please [open an issue](https://github.com/watson/ci-info/issues) if your
|
|
|
|
CI server isn't properly detected :)
|
|
|
|
|
|
|
|
[![Build status](https://travis-ci.org/watson/ci-info.svg?branch=master)](https://travis-ci.org/watson/ci-info)
|
|
|
|
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](https://github.com/feross/standard)
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
```
|
|
|
|
npm install ci-info --save
|
|
|
|
```
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
```js
|
|
|
|
var ci = require('ci-info')
|
|
|
|
|
|
|
|
if (ci.isCI) {
|
|
|
|
console.log('The name of the CI server is:', ci.name)
|
|
|
|
} else {
|
|
|
|
console.log('This program is not running on a CI server')
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
## Supported CI tools
|
|
|
|
|
|
|
|
Officially supported CI servers:
|
|
|
|
|
2017-12-27 19:33:54 +01:00
|
|
|
- [AWS CodeBuild](https://aws.amazon.com/codebuild/)
|
|
|
|
- [AppVeyor](http://www.appveyor.com)
|
2017-05-28 00:38:50 +02:00
|
|
|
- [Bamboo](https://www.atlassian.com/software/bamboo) by Atlassian
|
2017-12-27 19:33:54 +01:00
|
|
|
- [Bitbucket Pipelines](https://bitbucket.org/product/features/pipelines)
|
|
|
|
- [Buildkite](https://buildkite.com)
|
|
|
|
- [CircleCI](http://circleci.com)
|
2017-05-28 00:38:50 +02:00
|
|
|
- [Codeship](https://codeship.com)
|
|
|
|
- [Drone](https://drone.io)
|
2017-12-27 19:33:54 +01:00
|
|
|
- [GitLab CI](https://about.gitlab.com/gitlab-ci/)
|
|
|
|
- [GoCD](https://www.go.cd/)
|
|
|
|
- [Hudson](http://hudson-ci.org)
|
|
|
|
- [Jenkins CI](https://jenkins-ci.org)
|
2017-05-28 00:38:50 +02:00
|
|
|
- [Magnum CI](https://magnum-ci.com)
|
|
|
|
- [Semaphore](https://semaphoreci.com)
|
|
|
|
- [TaskCluster](http://docs.taskcluster.net)
|
2017-12-27 19:33:54 +01:00
|
|
|
- [Team Foundation Server](https://www.visualstudio.com/en-us/products/tfs-overview-vs.aspx) by Microsoft
|
|
|
|
- [TeamCity](https://www.jetbrains.com/teamcity/) by JetBrains
|
|
|
|
- [Travis CI](http://travis-ci.org)
|
2017-05-28 00:38:50 +02:00
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
### `ci.name`
|
|
|
|
|
|
|
|
A string. Will contain the name of the CI server the code is running on.
|
|
|
|
If not CI server is detected, it will be `null`.
|
|
|
|
|
|
|
|
Don't depend on the value of this string not to change for a specific
|
|
|
|
vendor. If you find your self writing `ci.name === 'Travis CI'`, you
|
|
|
|
most likely want to use `ci.TRAVIS` instead.
|
|
|
|
|
|
|
|
### `ci.isCI`
|
|
|
|
|
|
|
|
A boolean. Will be `true` if the code is running on a CI server.
|
|
|
|
Otherwise `false`.
|
|
|
|
|
|
|
|
Some CI servers not listed here might still trigger the `ci.isCI`
|
|
|
|
boolean to be set to `true` if they use certain vendor neutral
|
|
|
|
environment variables. In those cases `ci.name` will be `null` and no
|
|
|
|
vendor specific boolean will be set to `true`.
|
|
|
|
|
|
|
|
### `ci.<VENDOR-CONSTANT>`
|
|
|
|
|
|
|
|
The following vendor specific boolean constants are exposed. A constant
|
|
|
|
will be `true` if the code is determined to run on the given CI server.
|
|
|
|
Otherwise `false`.
|
|
|
|
|
|
|
|
- `ci.APPVEYOR`
|
2017-12-27 19:33:54 +01:00
|
|
|
- `ci.BAMBOO`
|
|
|
|
- `ci.BITBUCKET`
|
|
|
|
- `ci.BUILDKITE`
|
|
|
|
- `ci.CIRCLE`
|
|
|
|
- `ci.CODEBUILD`
|
2017-05-28 00:38:50 +02:00
|
|
|
- `ci.CODESHIP`
|
|
|
|
- `ci.DRONE`
|
2017-12-27 19:33:54 +01:00
|
|
|
- `ci.GITLAB`
|
|
|
|
- `ci.GOCD`
|
|
|
|
- `ci.HUDSON`
|
|
|
|
- `ci.JENKINS`
|
2017-05-28 00:38:50 +02:00
|
|
|
- `ci.MAGNUM`
|
|
|
|
- `ci.SEMAPHORE`
|
|
|
|
- `ci.TASKCLUSTER`
|
2017-12-27 19:33:54 +01:00
|
|
|
- `ci.TEAMCITY`
|
|
|
|
- `ci.TFS` (Team Foundation Server)
|
|
|
|
- `ci.TRAVIS`
|
2017-05-28 00:38:50 +02:00
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
MIT
|