Bitbucket Server

Only organization Admins can create, edit and delete integrations.

Link your model objects to reality, such as code repos, branches, folders and files. When those links move, change names or get deleted, we’ll notify you that the object may need to be updated in your IcePanel landscape.

Learn more here: Linking to reality

Using BitBucket Server

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

Whitelist the IcePanel repo scanner

You may find that no code repos show if your organization has enabled IP filtering or whitelisting in your BitBucket Server instance. To resolve this whitelist the IcePanel repo scanner IP address:

34.168.47.236

CLI command reference

Usage: IcePanel bitbucket-server-sync [options]

Syncronize 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 seperated
  -i, --interval <secs>      Interval for syncronization (default: "1800")
  -f, --force                Force refresh of code repos and trees
  --filter-repos <pattern>   Filter code repo names to include, supports wildcards
  --delete-all               Delete all code repos and trees for this integration
  --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 seperated
  SYNC_INTERVAL               Interval for syncronization
  FORCE                       Force refresh of code repos and trees
  FILTER_REPOS                Filter code repo names to include, supports wildcards
  CONCURRENCY                 Number of jobs that can be processed in parallel
  LOG_LEVEL                   Options are fatal, error, warn, info, debug, trace, silent