mirror of
https://github.com/woodpecker-ci/woodpecker.git
synced 2024-10-04 01:12:12 +00:00
44 lines
1.5 KiB
Markdown
44 lines
1.5 KiB
Markdown
An official Drone image is available in the [Docker registry](https://registry.hub.docker.com/u/drone/drone/). This is the recommended way to install and run Drone on non-Ubuntu environments. Pull the latest Drone image to get started:
|
|
|
|
```bash
|
|
sudo docker pull drone/drone
|
|
```
|
|
|
|
An example command to run your Drone instance with GitHub enabled:
|
|
|
|
```bash
|
|
sudo docker run -d \
|
|
-v /var/lib/drone:/var/lib/drone \
|
|
-e DRONE_GITHUB_CLIENT=c0aaff74c060ff4a950d \
|
|
-e DRONE_GITHUB_SECRET=1ac1eae5ff1b490892f5 \
|
|
-p 80:80 --name=drone drone/drone
|
|
```
|
|
|
|
### Persistence
|
|
|
|
When running Drone inside Docker we recommend mounting a volume for your sqlite database. This ensures the database is not lost if the container is accidentally stopped and removed. Below is an example that mounts `/var/lib/drone` on your host machine:
|
|
|
|
```bash
|
|
sudo docker run \
|
|
-v /var/lib/drone:/var/lib/drone \
|
|
--name=drone drone/drone
|
|
```
|
|
|
|
### Configuration
|
|
|
|
When running Drone inside Docker we recommend using environment variables to configure the system. All configuration attributes in the `drone.toml` may also be provided as environment variables. Below demonstrates how to configure GitHub from environment variables:
|
|
|
|
```bash
|
|
sudo docker run \
|
|
-e DRONE_GITHUB_CLIENT=c0aaff74c060ff4a950d \
|
|
-e DRONE_GITHUB_SECRET=1ac1eae5ff1b490892f5 \
|
|
--name=drone drone/drone
|
|
```
|
|
|
|
### Logging
|
|
|
|
When running Drone inside Docker the logs are sent to stdout / stderr. You can view the log output by running the following command:
|
|
|
|
```bash
|
|
docker logs drone
|
|
```
|