Update README.md
This commit is contained in:
parent
6cb35667a3
commit
018db25eac
1 changed files with 7 additions and 5 deletions
12
README.md
12
README.md
|
@ -1,18 +1,18 @@
|
||||||
# drone-quickstart
|
# drone-quickstart
|
||||||
|
|
||||||
This repository provides configuration and instructions for how to get started with [Drone CI](https://www.drone.io) from [Harness](https://harness.io)
|
This repository provides configuration and instructions for how to get started with [Drone CI](https://www.drone.io) from [Harness](https://harness.io) on Forgejo
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
* Comfortable running commands in the terminal
|
* Comfortable running commands in the terminal
|
||||||
* A [GitHub](https://github.com) account
|
* A [Forgejo](https://git.hhf.technology) account
|
||||||
* A [ngrok](https://ngrok.com) account
|
* A [ngrok](https://ngrok.com) account
|
||||||
* A computer that can run [amd64](https://en.wikipedia.org/wiki/X86-64) or [arm64](https://en.wikipedia.org/wiki/AArch64) [Docker](https://www.docker.com) containers (this includes the new [M1](https://en.wikipedia.org/wiki/Apple_M1)-based Macs)
|
* A computer that can run [amd64](https://en.wikipedia.org/wiki/X86-64) or [arm64](https://en.wikipedia.org/wiki/AArch64) [Docker](https://www.docker.com) containers (this includes the new [M1](https://en.wikipedia.org/wiki/Apple_M1)-based Macs)
|
||||||
* In your terminal, verify you have `docker` and `docker-compose` commands available
|
* In your terminal, verify you have `docker` and `docker-compose` commands available
|
||||||
|
|
||||||
## Tools used
|
## Tools used
|
||||||
|
|
||||||
* [Docker](https://www.docker.com) - for running the [Drone](https://docs.drone.io/server/provider/github/) and [Drone Docker Runner](https://docs.drone.io/runner/docker/overview/) processes
|
* [Docker](https://www.docker.com) - for running the [Drone](https://docs.drone.io/server/provider/gitea/) and [Drone Docker Runner](https://docs.drone.io/runner/docker/overview/) processes
|
||||||
* [ngrok](https://ngrok.com) - creates a [tunnel](https://en.wikipedia.org/wiki/Tunneling_protocol) between your local Drone docker container and the outside world, allowing it to receive webhooks from GitHub
|
* [ngrok](https://ngrok.com) - creates a [tunnel](https://en.wikipedia.org/wiki/Tunneling_protocol) between your local Drone docker container and the outside world, allowing it to receive webhooks from GitHub
|
||||||
|
|
||||||
## Steps
|
## Steps
|
||||||
|
@ -35,9 +35,11 @@ This repository provides configuration and instructions for how to get started w
|
||||||
|
|
||||||
1. [Fork this repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo) and [clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) the fork to your computer
|
1. [Fork this repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo) and [clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) the fork to your computer
|
||||||
2. Edit the file `run.sh`
|
2. Edit the file `run.sh`
|
||||||
- Set `DRONE_GITHUB_CLIENT_ID` and `DRONE_GITHUB_CLIENT_SECRET` using the "Client ID" and "Client secret" from the previous step
|
- Set `DRONE_GITEA_CLIENT_ID` and `DRONE_GITEA_CLIENT_SECRET` using the "Client ID" and "Client secret" from the previous step
|
||||||
- Set `DRONE_GITHUB_ADMIN` to your GitHub username
|
- Set `DRONE_GITEA_SERVER` Required string value provides your Forgejo server address.
|
||||||
|
- Set `DRONE_GIT_ALWAYS_AUTH` configures Drone to authenticate when cloning public repositories.
|
||||||
- Set `DRONE_SERVER_HOST` to your `ngrok` URL, without the `https://` (if your `ngrok` URL is `https://abcd-3fg-hij-k1-mn.ngrok.io`, set `DRONE_SERVER_HOST` to `abcd-3fg-hij-k1-mn.ngrok.io`)
|
- Set `DRONE_SERVER_HOST` to your `ngrok` URL, without the `https://` (if your `ngrok` URL is `https://abcd-3fg-hij-k1-mn.ngrok.io`, set `DRONE_SERVER_HOST` to `abcd-3fg-hij-k1-mn.ngrok.io`)
|
||||||
|
- Set `DRONE_SERVER_PROTO` This value should be set to http or https.
|
||||||
- Save your changes
|
- Save your changes
|
||||||
3. Open a new terminal session and change to the directory where you checked out this repository
|
3. Open a new terminal session and change to the directory where you checked out this repository
|
||||||
- Execute `run.sh` by typing `./run.sh` and hitting enter
|
- Execute `run.sh` by typing `./run.sh` and hitting enter
|
||||||
|
|
Loading…
Reference in a new issue