Skip to content

Commit f41651a

Browse files
tskarhedzerok
andauthored
Docs: Contribution guidelines for updating Drone pipelines (grafana#69530)
* Create drone-pipeline.md * Update drone-pipeline.md * Update README.md * Update drone-pipeline.md * Apply suggestions from code review Co-authored-by: Horst Gutmann <[email protected]> * Format file --------- Co-authored-by: Horst Gutmann <[email protected]>
1 parent a6b524f commit f41651a

File tree

2 files changed

+18
-0
lines changed

2 files changed

+18
-0
lines changed

contribute/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ This directory contains guides for contributors to the Grafana project.
77
- [Developer guide](developer-guide.md)
88
- [Triage issues](triage-issues.md)
99
- [Merge a pull request](merge-pull-request.md)
10+
- [Making changes to the CI pipeline](drone-pipeline.md)
1011

1112
The `style-guides` directory contains style guides for the Grafana software project and documentation.
1213

contribute/drone-pipeline.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Making changes to the Drone pipeline
2+
3+
_Only people in the Grafana organization can make changes to the Drone pipeline_
4+
5+
The Drone pipelines are built with [Starlark](https://github.com/bazelbuild/starlark), a language which is similar to Python. The Starlark files are located in [`scripts/drone`](https://github.com/grafana/grafana/tree/main/scripts/drone).
6+
7+
## Setup
8+
9+
- Set environment variables `DRONE_SERVER` and `DRONE_TOKEN`, which can be found on your [Drone account](https://drone.grafana.net/account). These are used to verify that only Grafana employees can make changes to the pipelines.
10+
- Install [buildifier](https://github.com/bazelbuild/buildtools/blob/master/buildifier/README.md), and use it to format the Starlark files you edit.
11+
12+
## Develop
13+
14+
- Open a PR where you can do test runs for your changes. If you need to experiment with secrets, create a PR in the [grafana-ci-sandbox repo](https://github.com/grafana/grafana-ci-sandbox), before opening a PR in the main repo.
15+
- Run `make drone` after making changes to the Starlark files. This builds the `.drone.yml` file.
16+
17+
For further questions, reach out to the grafana-delivery squad.

0 commit comments

Comments
 (0)