Skip to content

Files

Latest commit

jglickjglick
[INFRA-1934] jenkinsci/jenkins Docker repo deprecated.
Dec 10, 2018
ab0782e · Dec 10, 2018

History

History

demo

README.md

Demo of GitHub Organization, multibranch projects, and pull requests.

To run the demo:

  1. Start the image:
  • from sources: make run
  • from binaries: docker run --rm -p 8080:8080 -p 4040:4040 -v /var/run/docker.sock:/var/run/docker.sock --group-add=$(stat -c %g /var/run/docker.sock) -ti jenkinsci/pipeline-as-code-github-demo
  1. Visit localhost:8080.
  2. Prepare your environment in GitHub:
  3. Create an organization or user account (or use an existing one)
  4. Fork multibranch-demo to your own account or organization
  5. Log in with the random administrative password printed to the Docker log. Skip the rest of the setup wizard (close the dialog).
  6. Go to Credentials » GitHub and add a username/password pair using an access token generated here.
  7. Configure a personal access token with these scopes: repo:status and public_repo
  8. Create a new item, selecting GitHub Organization as the type, and setting the name to your account or organization name (for example, cloudbeers).
  9. Select your credentials token under Scan Credentials
  10. Optionally add the Filter by name (with wildcards) option, Includeing multibranch-demo.
  11. Save; you will see repositories being scanned.
  12. Go back to the organization index page. You should see multibranch-demo, under that one or more branches including master, and under each a successful build #1
  13. Add a new webhook, ask to Send me everything, and specify a URL like https://SOMETHING.ngrok.io/github-webhook/ (look at the Docker log for the specific hostname). Remember to clean up your webhook when the demo is done
  14. File pull requests (from a forked repository, not from origin branches) and see them being built.

The image needs to run Docker commands, so it assumes that your Docker daemon is listening to /var/run/docker.sock (discussion). This is not “Docker-in-Docker”; the container only runs the CLI and connects back to the host to start sister containers. The run target also makes reference to file paths on the Docker host, assuming they are where you are running that command, so this target cannot work on boot2docker. There may be some way to run this demo using boot2docker; if so, please contribute it.