36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# Enable Bitbucket Cloud PR Integration
|
|
|
|
## Get Started
|
|
|
|
The Nx Cloud + Bitbucket Cloud Integration lets you access the result of every run—with all its logs and build insights—straight from your PR.
|
|
|
|
## Connecting Your Workspace
|
|
|
|

|
|
|
|
Once on the VCS Integrations setup page, select "Bitbucket". You will be prompted to enter the name of your workspace and its repository slug.
|
|
|
|
Identifying your workspace name and repository slug can be done by looking at the URL from Bitbucket.
|
|
|
|
```
|
|
https://bitbucket.org/[workspace]/[repository-slug]/src/main/
|
|
```
|
|
|
|
For example, the url `https://bitbucket.org/nrwl/large-monorepo/src/main/` has a workspace name of "nrwl", and a repository slug of "large-monorepo".
|
|
|
|

|
|
|
|
### Configuring Authentication
|
|
|
|
#### Using an App Password
|
|
|
|
To use an app password for authentication, one must be generated with proper permissions. The minimum required permissions are write access to PRs.
|
|
|
|

|
|
|
|
Once the app password is created, verify the username is correct, paste the value, and then click "Connect". This will verify that Nx Cloud can connect to your repo. Upon a successful test, your configuration is saved, and setup is complete.
|
|
|
|
{% callout type="note" title="Use the correct username" %}
|
|
Make sure that you are using your Bitbucket username, found on the [account settings](https://bitbucket.org/account/settings) screen, and not your email address.
|
|
{% /callout %}
|