README.md

Gogs Branch Source

Pipeline as Code for Gogs: Go Git Service!

A Jenkins Plugin that provides SCMSource (i.e. Pipeline Multibranch) and SCMNavigator for Gogs - Go Git Service.

Features

• Supports Pipeline Multibranch
• Auto creation of repository webhooks for push and create events
• Supports SCMNavigator (Gogs Organization Scanning) functionality (i.e. org scanning per GitHub Organization Folder)
• Supports commit status update via repo issue creation on build FAILURE and UNSTABLE - Gogs currently doesn't support commit statuses see gogs/gogs#813
• Partial support for Gogs Organization avatar - Gogs does not support dynamically sized avatar images

Missing Features

• Does not support Gogs Pull Requests as there is currently no API - see gogs/gogs#2246
• Does not support auto-creation of Organization webhooks as there is currently no API - see gogs/go-gogs-client#38
• Update commit status - see gogs/gogs#813

Use with CJP Trial

There is a prepopulated Gogs server Docker image availalbe on Docker Hub. If you start this container and connect it to the same Docker network that is created when running the Dockerized CJP trial you will be able to experience Jenkins Pipeline as Code in the lovely confines of your personal computer ;) Here is an example Docker command:

docker run -d --name=gogs --net="cjptrial_default" -p 10022:22 -p 10080:3000 beedemo/gogs:develop

Login to Gogs (http://192.168.99.100:10080) with username: beedemo-user password: admin

Set up a Gogs Organization Folder

• On jenkins-team-1, upload the gogs-branch-source plugin from https://github.com/kmadel/gogs-branch-source-plugin/releases/download/v0.1-alpha/gogs-branch-source-0.1-alpha.hpi
• On jenkins-team-1 update branch-api plugin to version 1.10
• On jenkins-team-1, add credentials for Gogs user: Username/Password credentials
  • user: beedemo-user
  • password: admin
  • id: gogs-beedemo-user
  • desc: Gogs credentials for beedemo-user
• On jenkins-team-1 create a 'Gogs Organization Folder' project named 'beedemo': repo url=http://192.168.99.100:10080, creds=gogs-beedemo-user

Note: your network name may vary, especially on windows (docker network ls), also your Gogs URL/IP may vary based on your Docker Machine (check docker-machine ip {machine-name})

Tested Against

• Gogs: Go Git Service 0.9.60.0803
• Git Version: 2.6.6