Bitbucket Server

Only organization Admins can create, edit and delete integrations.

Setting up an access token

First, you must create an access token with read permissions in your Bitbucket instance.

1. Once logged in, in your profile menu click Manage account

2. Go to the Access tokens tab and click Create token

3. Fill in the token name and ensure the permissions are set to Read

4. Click Create and copy the token for the next step

Setting up Bitbucket Server

1. From your landscape homepage, click on the organization dropdown at the top of the navigation bar

2. Click on the Manage link for the organization you want to setup

3. Go to the Integrations tab

4. Click on the New Integration button, then select Bitbucket Server

5. Enter your Bitbucket server URL which must be accessible to the IcePanel API (api.icepanel.io)

6. Enter your Bitbucket username and the token you created in the previous step

7. Click Link Bitbucket

Unlinking your Bitbucket Server

You can unlink the integration from IcePanel and Bitbucket Server.

1. From your landscape homepage, click on the organization dropdown at the top of the navigation bar

2. Click on the Manage link for the organization you want to setup

3. Go to the Integrations tab and Bitbucket Server tab

4. Click the Remove button

5. Login to Bitbucket, click Manage account in your profile menu

6. Go to the Access tokens tab and click Revoke next to the token you created in the previous steps

CLI command reference

Usage: IcePanel bitbucket-server-sync [options]

Synchronize IcePanel code repos with a BitBucket server instance

Options:
  --api-url <value>          IcePanel API URL (default: "<https://api.icepanel.io/v1>")
  -k, --api-key <value>      IcePanel API key
  -s, --server-url <value>   BitBucket server URL
  -u, --username <value>     BitBucket server username
  -t, --token <value>        BitBucket server token
  -p, --project-key <value>  BitBucket project key, comma separated
  -i, --interval <secs>      Interval for synchronization (default: "1800")
  -f, --force                Force refresh of code repos and trees
  --concurrency <value>      Number of jobs that can be processed in parallel (default: "10")
  -h, --help                 display help for command

Environment variables:
  API_URL                     IcePanel API URL
  API_KEY                     IcePanel API key
  BITBUCKET_SERVER_URL        BitBucket server URL
  BITBUCKET_SERVER_USERNAME   BitBucket server username
  BITBUCKET_SERVER_TOKEN      BitBucket server token
  BITBUCKET_PROJECT_KEY       BitBucket project key, comma-separated
  SYNC_INTERVAL               Interval for synchronization
  CONCURRENCY                 Number of jobs that can be processed in parallel
  LOG_LEVEL                   Options are fatal, error, warn, info, debug, trace, silent