harness-drone/docs/setup/server.md

40 lines
1.3 KiB
Markdown
Raw Normal View History

2015-07-11 00:40:03 +00:00
# Server
Drone uses the `net/http` package in the Go standard library for high-performance `http` request processing. This section describes how to customize the default server configuration. This section is completely **optional**.
## Server Settings
This section lists all environment variables used to configure the server.
* `SERVER_ADDR` server address and port. Defaults to `:8000`
* `SERVER_KEY` ssl certificate key (key.pem)
* `SERVER_CERT` ssl certificate (cert.pem)
This example changes the default port to `:80`:
2015-08-09 03:51:12 +00:00
```bash
2015-10-08 00:17:15 +00:00
SERVER_ADDR=:80
2015-07-11 00:40:03 +00:00
```
## Server SSL
2015-10-08 00:17:15 +00:00
Drone uses the `ListenAndServeTLS` function in the Go standard library to accept `https` connections. If you experience any issues configuring `https` please contact us on [gitter](https://gitter.im/drone/drone). Please do not log an issue saying `https` is broken in Drone.
2015-07-11 00:40:03 +00:00
This example accepts `HTTPS` connections:
2015-08-09 03:51:12 +00:00
```bash
2015-10-08 00:17:15 +00:00
SERVER_ADDR=:443
SERVER_KEY=/path/to/key.pem
SERVER_CERT=/path/to/cert.pem
2015-07-11 00:40:03 +00:00
```
2015-10-08 00:17:15 +00:00
> When your certificate is signed by an authority, the certificate should be the concatenation of the server's certificate followed by the CA certificate.
2015-07-11 00:40:03 +00:00
2015-08-09 03:51:12 +00:00
When running Drone inside Docker, you'll need to mount a volume containing the certificate:
2015-07-11 00:40:03 +00:00
2015-08-09 03:51:12 +00:00
```bash
2015-07-11 00:40:03 +00:00
docker run
--volume /path/to/cert.pem:/path/to/cert.pem \
--volume /path/to/key.pem:/path/to/key.pem \
```