https://github.com/fourdollars/jenkins-resource
https://github.com/fourdollars/jenkins-resource
concourse-ci-resource jenkins
Last synced: 27 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/fourdollars/jenkins-resource
- Owner: fourdollars
- License: mit
- Created: 2021-06-23T15:50:28.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-06-23T09:57:32.000Z (almost 3 years ago)
- Last Synced: 2023-04-19T03:41:31.249Z (about 2 years ago)
- Topics: concourse-ci-resource, jenkins
- Language: Shell
- Homepage: https://fourdollars.github.io/
- Size: 20.5 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/fourdollars/jenkins-resource/) [](https://opensource.org/licenses/MIT) [](https://www.gnu.org/software/bash/)  [](https://hub.docker.com/r/fourdollars/jenkins-resource/)
# jenkins-resource
[Concourse CI](https://concourse-ci.org/)'s jenkins-resource to watch and trigger the Jenkins builds by https://www.jenkins.io/doc/book/using/remote-access-api/.
## Config
### Resource Type
```yaml
resource_types:
- name: resource-jenkins
type: registry-image
source:
repository: fourdollars/jenkins-resource
tag: latest
```
or
```yaml
resource_types:
- name: resource-jenkins
type: registry-image
source:
repository: ghcr.io/fourdollars/jenkins-resource
tag: latest
```
### Resource
* host: **Required**
* user: **Required**
* token: **Required**
* job: **Required**, such as 'job/JOB_NAME'.
* port: Optional
* protocol: Optional, such as 'http' or 'https', using 'https' by default.
* timezone: Optional, such as 'Asia/Taipei'. 'UTC' by default.
* timeout: Optional, seconds to timeout. No timeout by default.
* builds: Optional, limit the build number to check. No limit by default.
* skip: Optional, don't check the result and the duration in check step or don't wait for the result in get step.
* crumb: Optional, using 'skip' if you want to skip the crumbIssuer.
* debug: Optional
```yaml
resources:
- name: test
icon: bow-tie
type: resource-jenkins
check_every: 5m
source:
host: 127.0.0.1
user: user
token: wxdnqsclxzrmhb2k27frgjc7hdp3zqk0b4
job: job/test
port: 8080
protocol: http
builds: 5
- name: release
icon: bow-tie
type: resource-jenkins
check_every: never
source:
host: 127.0.0.1
user: user
token: wxdnqsclxzrmhb2k27frgjc7hdp3zqk0b4
job: job/release
port: 8080
protocol: http
builds: 5
```
#### check step params
* skip: Don't check the result and the duration to skip the builds without the result or the duration.
* expectedResult: Optional, only check for the expected results.
#### get step params
* expectedResult: Optional, waiting for the expected results.
* timeout: Optional, seconds to timeout. No timeout by default.
* skip: Don't wait for the result.
#### put step params
* expectedResult: Optional, only generate the expected results.
* stringParameters: Optional.
* fileParameters: Optional.
* timeout: Optional, seconds to timeout. No timeout by default.
### Job Example
```yaml
jobs:
- name: check-test-job
plan:
- get: test
trigger: true
- task: check
config:
platform: linux
image_resource:
type: registry-image
source:
repository: alpine
tag: latest
inputs:
- name: test
outputs:
- name: outgoing
run:
path: sh
args:
- -exc
- |
apk add jq
jq -r < test/api.json
cp test/api.json outgoing/api.json
- put: release
inputs: [outgoing]
params:
stringParameters:
id: 123
verbosity: high
fileParameters:
FILE_LOCATION_AS_SET_IN_JENKINS: outgoing/api.json
get_params:
expectedResult:
- SUCCESS
- UNSTABLE
- FAILURE
- NOT_BUILT
- ABORTED
```