mirrors/woodpecker
1
0
Fork 0
mirror of https://github.com/woodpecker-ci/woodpecker.git synced 2024-06-10 17:39:37 +00:00
Code Issues Projects Releases Wiki Activity
woodpecker/docs/docs/30-administration/11-forges/50-bitbucket.md

72 lines
2.2 KiB
Markdown
Raw Normal View History

Administration articles moved
2019-11-13 18:50:54 +00:00
# Bitbucket
Woodpecker comes with built-in support for Bitbucket Cloud. To enable Bitbucket Cloud you should configure the Woodpecker container using the following environment variables:
Readme
2019-07-05 13:30:25 +00:00
Cleanups + prefer .yaml (#3069) Co-authored-by: Robert Kaussow <xoxys@rknet.org>
2024-01-11 17:43:54 +00:00
```ini
WOODPECKER_BITBUCKET=true
WOODPECKER_BITBUCKET_CLIENT=... # called "Key" in Bitbucket
WOODPECKER_BITBUCKET_SECRET=...
Readme
2019-07-05 13:30:25 +00:00
```
Administration articles moved
2019-11-13 18:50:54 +00:00
## Registration
Readme
2019-07-05 13:30:25 +00:00
Improve bitbucket docs (#2066)
2023-07-30 15:52:47 +00:00
You must register an OAuth application at Bitbucket in order to get a key and secret combination for woodpecker. Navigate to your workspace settings and choose `OAuth consumers` from the menu, and finally click `Add Consumer` (the url should be like: `https://bitbucket.org/[your-project-name]/workspace/settings/api`).
Readme
2019-07-05 13:30:25 +00:00
Improve bitbucket docs (#2066)
2023-07-30 15:52:47 +00:00
Please set a name and set the `Callback URL` like this:
Readme
2019-07-05 13:30:25 +00:00
Cleanups + prefer .yaml (#3069) Co-authored-by: Robert Kaussow <xoxys@rknet.org>
2024-01-11 17:43:54 +00:00
```uri
Improve bitbucket docs (#2066)
2023-07-30 15:52:47 +00:00
https://<your-woodpecker-address>/authorize
Readme
2019-07-05 13:30:25 +00:00
```
Improve bitbucket docs (#2066)
2023-07-30 15:52:47 +00:00
![bitbucket oauth setup](bitbucket_oauth.png)
Readme
2019-07-05 13:30:25 +00:00
Please also be sure to check the following permissions:
Cleanups + prefer .yaml (#3069) Co-authored-by: Robert Kaussow <xoxys@rknet.org>
2024-01-11 17:43:54 +00:00
- Account: Email, Read
- Workspace membership: Read
- Projects: Read
- Repositories: Read
- Pull requests: Read
- Webhooks: Read and Write
Readme
2019-07-05 13:30:25 +00:00
Improve bitbucket docs (#2066)
2023-07-30 15:52:47 +00:00
![bitbucket permissions](bitbucket_permissions.png)
[Docs] Simplify docker-compose samples (#356)
2021-09-27 22:04:52 +00:00
## Configuration
This is a full list of configuration options. Please note that many of these options use default configuration values that should work for the majority of installations.
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
### `WOODPECKER_BITBUCKET`
Add prettier (#2600)
2023-10-24 12:42:05 +00:00
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
> Default: `false`
[Docs] Simplify docker-compose samples (#356)
2021-09-27 22:04:52 +00:00
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
Enables the Bitbucket driver.
[Docs] Simplify docker-compose samples (#356)
2021-09-27 22:04:52 +00:00
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
### `WOODPECKER_BITBUCKET_CLIENT`
Add prettier (#2600)
2023-10-24 12:42:05 +00:00
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
> Default: empty
Improve bitbucket docs (#2066)
2023-07-30 15:52:47 +00:00
Configures the Bitbucket OAuth client key. This is used to authorize access.
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
Allow loading sensitive flags from files (#815) With systems like docker swarm or docker compose it is usually a little awkward to manage secrets. There is no way to directly inject them into the environment config. So you often have to write your secrets directly into the compose file There are hacky workarounds such as overriding the entry-point of the container and loading a script which then fetches secrets from /run/secrets and replaces the environment variables, but this becomes very difficult once we are using docker images built from "scratch" (which is a really great practice otherwise) as there is no shell or standard tooling available This adds a *_FILE variant of their Environment config values to work around this issue. Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>
2022-03-01 15:09:33 +00:00
### `WOODPECKER_BITBUCKET_CLIENT_FILE`
Add prettier (#2600)
2023-10-24 12:42:05 +00:00
Allow loading sensitive flags from files (#815) With systems like docker swarm or docker compose it is usually a little awkward to manage secrets. There is no way to directly inject them into the environment config. So you often have to write your secrets directly into the compose file There are hacky workarounds such as overriding the entry-point of the container and loading a script which then fetches secrets from /run/secrets and replaces the environment variables, but this becomes very difficult once we are using docker images built from "scratch" (which is a really great practice otherwise) as there is no shell or standard tooling available This adds a *_FILE variant of their Environment config values to work around this issue. Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>
2022-03-01 15:09:33 +00:00
> Default: empty
Read the value for `WOODPECKER_BITBUCKET_CLIENT` from the specified filepath
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
### `WOODPECKER_BITBUCKET_SECRET`
Add prettier (#2600)
2023-10-24 12:42:05 +00:00
Move vcs configs and hide some unstable options from docs (#755) move vcs configs to their pages, hide some unclear options
2022-02-09 19:32:38 +00:00
> Default: empty
Configures the Bitbucket OAuth client secret. This is used to authorize access.
[Docs] Simplify docker-compose samples (#356)
2021-09-27 22:04:52 +00:00
Allow loading sensitive flags from files (#815) With systems like docker swarm or docker compose it is usually a little awkward to manage secrets. There is no way to directly inject them into the environment config. So you often have to write your secrets directly into the compose file There are hacky workarounds such as overriding the entry-point of the container and loading a script which then fetches secrets from /run/secrets and replaces the environment variables, but this becomes very difficult once we are using docker images built from "scratch" (which is a really great practice otherwise) as there is no shell or standard tooling available This adds a *_FILE variant of their Environment config values to work around this issue. Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>
2022-03-01 15:09:33 +00:00
### `WOODPECKER_BITBUCKET_SECRET_FILE`
Add prettier (#2600)
2023-10-24 12:42:05 +00:00
Allow loading sensitive flags from files (#815) With systems like docker swarm or docker compose it is usually a little awkward to manage secrets. There is no way to directly inject them into the environment config. So you often have to write your secrets directly into the compose file There are hacky workarounds such as overriding the entry-point of the container and loading a script which then fetches secrets from /run/secrets and replaces the environment variables, but this becomes very difficult once we are using docker images built from "scratch" (which is a really great practice otherwise) as there is no shell or standard tooling available This adds a *_FILE variant of their Environment config values to work around this issue. Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>
2022-03-01 15:09:33 +00:00
> Default: empty
Read the value for `WOODPECKER_BITBUCKET_SECRET` from the specified filepath
Administration articles moved
2019-11-13 18:50:54 +00:00
## Missing Features
Readme
2019-07-05 13:30:25 +00:00
Cleanups + prefer .yaml (#3069) Co-authored-by: Robert Kaussow <xoxys@rknet.org>
2024-01-11 17:43:54 +00:00
Path filters for pull requests are not supported. We are interested in patches to include this functionality.
Mention Matrix Space & Rooms in Readme & Docs (#646) * Mention Matrix Space & Rooms in Readme & Docs * custom labels Co-authored-by: John Olheiser <john.olheiser@gmail.com> Co-authored-by: John Olheiser <john.olheiser@gmail.com>
2021-12-30 17:53:52 +00:00
If you are interested in contributing to Woodpecker and submitting a patch please **contact us** via [Discord](https://discord.gg/fcMQqSMXJy) or [Matrix](https://matrix.to/#/#WoodpeckerCI-Develop:obermui.de).
Reference in a new issue Copy permalink