https://github.com/orange-cloudfoundry/travis-resource
A concourse resource to track travis builds and trigger them.
https://github.com/orange-cloudfoundry/travis-resource
Last synced: about 1 year ago
JSON representation
A concourse resource to track travis builds and trigger them.
- Host: GitHub
- URL: https://github.com/orange-cloudfoundry/travis-resource
- Owner: orange-cloudfoundry
- License: apache-2.0
- Created: 2016-04-28T16:58:56.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2020-01-21T10:57:12.000Z (over 6 years ago)
- Last Synced: 2025-03-25T04:41:34.503Z (over 1 year ago)
- Language: Go
- Homepage:
- Size: 1.24 MB
- Stars: 3
- Watchers: 16
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Travis Resource
Track travis builds and can trigger them.
## Source Configuration
* `repository`: *Required.* The name of the repository, e.g. `Orange-OpenSource/travis-resource`.
* `branch`: *Optional.* The branch to track. Defaults to the last build found on travis.
* `branch-regex`: *Optional.* The branch to track filtering by a regex (e.g: "v.*" to find all branches starting with "v"). Defaults to the last build found on travis.
* `check-all-builds`: *Optional.* If set to `true` it will retrieve all builds (not just passed ones). Defaults to `false`.
* `check-on-state`: *Optional.* On which build's state check will be triggered, possible values are `created`, `started`, `passed`,
`failed` and `errored`. Defaults to `passed`. **Note:** if `check-all-builds` is set to `true` this value is ignored.
* `pro`: *Optional.* If set to `true` it will use travis pro api. Defaults to `false`.
* `travis-url`: *Optional.* If set it will override default travis api with this one.
* `github-token`: *if `travis-token` set it becomes unnecessary* A github token to authenticate to travis.
* `travis-token`: *if `github-token` set it becomes unnecessary* A travis token to authenticate to travis. **Note:** Do not confuse the access token with the token found on your travis profile page.
## Behavior
### `check`: Check for new builds.
Find the last build triggered on travis for the repository set and branch (if given).
### `in`: Fetch the last build triggered on travis and retrieve information about it.
Find information the last build triggered on travis for the repository set and and branch (if given) and place information about the build inside the destination folder.
The name of this file placed in destination foler is `build-info.json` and will give information in this format:
```json
{
"builds": [
{
"id": 93712979,
"repository_id": 6711424,
"commit_id": 26643017,
"number": "18",
"state": "passed",
"started_at": "2015-11-28T23:02:01Z",
"finished_at": "2015-11-28T23:04:07Z",
"duration": 126,
"job_ids": [
93712980
],
"event_type": "push"
}
],
"commits": [
{
"id": 26643017,
"sha": "b3a3f680f3a3d02d2a677322b24a13aa63d2a2f6",
"branch": "master",
"message": "fix install script",
"committed_at": "2015-11-28T23:01:40Z",
"author_name": "ArthurHlt",
"author_email": "arthurh.halet@gmail.com",
"committer_name": "ArthurHlt",
"committer_email": "arthurh.halet@gmail.com",
"compare_url": "https://github.com/ArthurHlt/github-blob-sender/compare/712868bf61f0...b3a3f680f3a3"
}
]
}
```
#### Parameters
* `download-logs`: *Optional.* If set to true it will download logs for every jobs in a build and put them in `travis-logs` folder inside the destination folder, log files follow this filename pattern: `job-{job id}.log`. Defaults to `false`.
### `out`: Restart a build on travis.
Restart a particular build set by user.
By default it will restart the build give by the file `build-info.json`.
#### Parameters
* `build`: *Optional.* A build number associated to a repository to restart. It can be value `latest` to trigger the latest finished build.
* `branch`: *Optional.* A branch associated to a repository to restart (It will restart the last build found in this branch). **Note:** if `build` is set this parameter will be ignored
* `repository`: *Optional.* The repository where we can found the build number in travis. If it's not set `build` parameter will be associated to the repository given in source configuration
* `skip-wait`: *Optional.* Don't wait travis to finish the build. Defaults to `false`
## Example
``` yaml
resource_types:
- name: travis
type: docker-image
source:
repository: orangeopensource/travis-resource-image
resources:
- name: travis-resource
type: travis
source:
repository: user/main-project
github-token: mygithubtoken
#or travis-token: mytravistoken
#branch: master
#check-all-builds: false
jobs:
- name: build-rootfs
plan:
- get: travis-resource
trigger: true
- put: travis-resource
params:
build: latest
repository: user/project-with-main-project-in-dependence
#branch: master
```