added proxy documentation

This commit is contained in:
Brad Rydzewski 2015-10-26 10:28:01 -07:00
parent df0c6cd567
commit a45ce34ca8
4 changed files with 36 additions and 2 deletions

View file

@ -4,6 +4,7 @@
* [Plugins](plugins.md) * [Plugins](plugins.md)
* Server * Server
* [Server](server.md) * [Server](server.md)
* [Proxy](proxy.md)
* [Nginx](nginx.md) * [Nginx](nginx.md)
* Remotes * Remotes
* [GitHub](github.md) * [GitHub](github.md)

View file

@ -1,6 +1,6 @@
# Nginx # Nginx
Using a proxy server is **not necessary**. Drone serves most static content from a CDN and uses the Go standard librarys high-performance net/http package to serve dynamic content. Using a proxy server is **not necessary**. Drone serves most static content from a CDN and uses the Go standard library's high-performance net/http package to serve dynamic content.
If using Nginx to proxy traffic to Drone, please ensure you have version 1.3.13 or greater. You also need to configure nginx to write `X-Forwarded_*` headers: If using Nginx to proxy traffic to Drone, please ensure you have version 1.3.13 or greater. You also need to configure nginx to write `X-Forwarded_*` headers:

31
docs/setup/proxy.md Normal file
View file

@ -0,0 +1,31 @@
# Proxy
This document provides high-level instructions for configuring Drone to work with a corporate proxy server.
## Http Proxy
The HTTP_PROXY environment variable holds the hostname or IP address of your proxy server. You can specify the HTTP_PROXY variables in your `/etc/drone/dronerc` file or as an envronment variable.
```
HTTPS_PROXY=https://proxy.example.com
HTTP_PROXY=http://proxy.example.com
```
These variables are propogated throughout your build environment, including build and plugin containers. To verify the environment variables are being set in your build container you can add the `env` command to your build script.
We also recommend you provide both uppercase and lowercase environment variables. We've found that certain common unix tools are case-sensitive:
```
HTTP_PROXY=http://proxy.example.com
http_proxy=http://proxy.example.com
```
## No Proxy
The `NO_PROXY` variable should contain a comma-separated list of domain extensions the proxy should not be used for. This typically includes resources inside your network, such as your GitHub Enterprise server.
```
NO_PROXY=.example.com, *.docker.example.com
```
You may also need to add your Docker daemon hostnames to the above list.

View file

@ -1,5 +1,7 @@
# Upgrading # Upgrading
> Warning. There is no automated migration from 0.3 to 0.4 due to substantial changes in database structure.
Drone is built continuously, with updates available daily. In order to upgrade Drone you must first stop and remove your running Drone instance: Drone is built continuously, with updates available daily. In order to upgrade Drone you must first stop and remove your running Drone instance:
``` ```
@ -13,7 +15,7 @@ Pull the latest Drone image:
sudo docker pull drone/drone:0.4 sudo docker pull drone/drone:0.4
``` ```
Run the container using the latest Drone image: Re-run the container using the latest Drone image:
``` ```
sudo docker run \ sudo docker run \