travis-resource

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:

{
	"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

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