woodpecker/docs/setup/bitbucket.md

51 lines
1.6 KiB
Markdown
Raw Normal View History

2015-07-07 04:13:50 +00:00
# Bitbucket
2015-05-24 21:13:56 +00:00
Drone comes with built-in support for Bitbucket. To enable Bitbucket you should configure the Bitbucket driver using the following environment variables:
2015-07-07 04:13:50 +00:00
```bash
2015-10-08 00:17:15 +00:00
REMOTE_DRIVER=bitbucket
REMOTE_CONFIG=https://bitbucket.org?client_id=${client_id}&client_secret=${client_secret}
```
2015-05-24 21:13:56 +00:00
## Bitbucket configuration
The following is the standard URI connection scheme:
```
scheme://host[?options]
2015-05-24 21:13:56 +00:00
```
The components of this string are:
* `scheme` server protocol `http` or `https`.
* `host` server address to connect to.
* `?options` connection specific options.
## Bitbucket options
This section lists all connection options used in the connection string format. Connection options are pairs in the following form: `name=value`. The value is always case sensitive. Separate options with the ampersand (i.e. &) character:
* `client_id` oauth client id for registered application.
* `client_secret` oauth client secret for registered application.
* `open=false` allows users to self-register. Defaults to false.
* `orgs=drone&orgs=docker` restricts access to these Bitbucket organizations. **Optional**
## Bitbucket registration
You must register your application with Bitbucket in order to generate a Client and Secret. Navigate to your account settings and choose OAuth from the menu, and click Add Consumer.
2015-05-24 21:13:56 +00:00
Please use `http://drone.mycompany.com/authorize` as the Authorization callback URL. You will also need to check the following permissions:
2015-05-24 21:13:56 +00:00
* Account:Email
* Account:Read
* Team Membership:Read
* Repositories:Read
* Webhooks:Read and Write
## Known Issues
This section details known issues and planned features:
* Pull Request support
* Mercurial support