This repository contains the vagrant demo for tinyCI. It, by default, runs one instance of the tinyCI VM for UI and other services, and another for a docker runner (overlay-runner). You can customize it to run multiple runners.
This demo only works on Linux and OS X. Be sure to check out the docs before getting started.
Before anything, you need the following tools installed and operational:
- VirtualBox
- Vagrant
- Ansible
- OS X:
brew install ansible
(via homebrew) - Ubuntu:
apt-get install ansible
- OS X:
Additionally, mkcert will be downloaded using the system's curl
tool.
Firstly, setup an oauth account. Make it look like this:
- You need to change the following configuration details:
- The application name is tinyci-demo
- The homepage URL is https://192.168.42.2
- The authorization callback URL is https://192.168.42.2/uisvc/login
- Clone this repository.
- Get a release. Either:
- Run
make download
to get a recommended version of the release - Get a copy of the release
and name it
release.tar.gz
, and put it at the root of this repository's clone.
- Run
- Create a
customize.rb
from the sample file. You should only need to change three things:- Replace <client id> with the value obtained above
- Replace <client secret> with the value obtained above
- Replace <github username> with your github username
- Run
make setup
. - Assuming
make setup
succeeds, runmake start
.
You will be asked to enter a password during this process. Enter your system password.
Your UI will be @ https://192.168.42.2. Be sure to accept the cert if prompted!
If make start
fails for some reason, you can run make restart
after correcting any errors.
If you want a really quick start and want to see the jobs run:
- Click "Add to CI".
- Click the "people" icon to upgrade your oauth token to one that can run CI jobs. This will refresh the page after success.
- Then, click the "cloud" icon to scan your repositories.
- Fork tinyci/ci-runners (a few small jobs) or tinyci/ci-agents (lots of jobs).
- After that, you can search for your fork and click the
+
symbol to move forward with adding your hook and allowing submissions. - Then, "Submit" the repository's master branch using the UI element at the top of the web page.