rawlingsj / jx-updatebot

a simple plugin to create downstream pull requests as part of your release pipeline

jx-updatebot

jx-updatebot is a small command line tool for generating downstream Pull Requests

Getting Started

Download the jx-updatebot binary for your operating system and add it to your $PATH.

Or you can use jx updatebot directly in the Jenkins X 3.x CLI

Configuration

The jx updatebot pr command looks in for the .jx/updatebot.yaml file to find the repositories to modify along with the list of change rules to make.

You can see the configuration documentation here for how to format your .jx/updatebot.yaml file.

Examples

Here are some example updatebot configurations:

• jenkins-x/go-scm which is a go library uses this .jx/updatebot.yaml to create a downstream pull request on jenkins-xlighthouse whenever its released.
• jenkins-xlighthouse releases a chart which then uses this .jx/updatebot.yaml to create a downstream pull request on the Jenkins X Version Stream
• jenkins-x/jx is the Jenkins X command line which releases binaries and charts and uses this .jx/updatebot.yaml to create a downstream pull request on the Jenkins X Version Stream

Using updatebot in Tekton

You can see an example of invoking the Updatebot step inside a Tekton pipeline. This reuses the Jenkins X Pipeline as Code GitOps approach

e.g. check out the final step in this Task:

        steps:
        - image: uses:jenkins-x/jx3-pipeline-catalog/tasks/git-clone/git-clone.yaml@versionStream
        - name: next-version
        - name: jx-variables
        - name: build-make-build
        - name: promote-changelog
        - image: uses:jenkins-x/jx3-pipeline-catalog/tasks/updatebot/release.yaml@versionStream

If you are not using Jenkins X but are using Tekton you could copy/paste this Task step

Commands

See the jx-updatebot command reference