Drone UI
Getting started
-
Clone this repository
git clone https://github.com/drone/drone-ui.git
-
Install dependencies
npm install
-
Copy .env.example and rename it into .env
cp .env.example .env.development.local
-
Fill required variables. For example:
REACT_APP_DRONE_SERVER=https://drone.company.com
REACT_APP_DRONE_TOKEN=<your_drone_token> // find your token in your Drone account settings (click your Avatar in the UI).
Run the app
npm run start
Build the app
npm run build
Run the built app
npm run serve
Run linters
npm run lint
Run linters and fix auto fixable problems
npm run lint:fix
Run your tests
npm run test
Commits
We use Conventional Commits for commit messages. You can read more about Conventional Commits here. Here you can find a useful Conventional Commits Cheat Sheet.
We try to make our commits "atomic". Here and here you can read more about Atomic commits.
Release procedure
Run the changelog generator.
docker run -it --rm -v "$(pwd)":/usr/local/src/your-app githubchangeloggenerator/github-changelog-generator -u drone -p drone-ui -t <secret github token>
You can generate a token by logging into your GitHub account and going to Settings -> Personal access tokens.
Next we tag the PR's with the fixes or enhancements labels. If the PR does not fufil the requirements, do not add a label.
** Before moving on make sure to update the version in package.json
. **
Run the changelog generator again with the future version according to semver.
docker run -it --rm -v "$(pwd)":/usr/local/src/your-app githubchangeloggenerator/github-changelog-generator -u drone -p drone-ui -t <secret token> --future-release v1.0.0
Create your pull request for the release. Get it merged then tag the release.
Please reference the updated changelog in your PR to update Drone
with the latest UI SHA.
Community and Support
Harness Community Slack - Join the #drone slack channel to connect with our engineers and other users running Drone CI.
Harness Community Forum - Ask questions, find answers, and help other users.
Report A Bug - Find a bug? Please report in our forum under Drone Bugs. Please provide screenshots and steps to reproduce.
Events - Keep up to date with Drone events and check out previous events here.