Bitbucket Server Discovery
This documentation is written for the new backend system which is the default since Backstage version 1.24. If you are still on the old backend system, you may want to read its own article instead, and consider migrating!
The Bitbucket Server integration has a special entity provider for discovering catalog files located in Bitbucket Server. The provider will search your Bitbucket Server account and register catalog files matching the configured path as Location entity and via following processing steps add all contained catalog entities. This can be useful as an alternative to static locations or manually adding things to the catalog.
Installation
You will have to add the entity provider in the catalog initialization code of your
backend. The provider is not installed by default, therefore you have to add a
dependency to @backstage/plugin-catalog-backend-module-bitbucket-server
to your backend package.
yarn --cwd packages/backend add @backstage/plugin-catalog-backend-module-bitbucket-server
And update your backend by adding the following line:
backend.add(import('@backstage/plugin-catalog-backend'));
backend.add(
import('@backstage/plugin-catalog-backend-module-bitbucket-server'),
);
Configuration
To use the entity provider, you'll need a Bitbucket Server integration set up.
Additionally, you need to configure your entity provider instance(s):
catalog:
providers:
bitbucketServer:
yourProviderId: # identifies your ingested dataset
host: 'bitbucket.mycompany.com'
catalogPath: /catalog-info.yaml # default value
filters: # optional
projectKey: '^apis-.*$' # optional; RegExp
repoSlug: '^service-.*$' # optional; RegExp
skipArchivedRepos: true # optional; boolean
schedule: # same options as in SchedulerServiceTaskScheduleDefinition
# supports cron, ISO duration, "human duration" as used in code
frequency: { minutes: 30 }
# supports ISO duration, "human duration" as used in code
timeout: { minutes: 3 }
host
: The host of the Bitbucket Server instance, note: the host needs to registered as an integration as well, see location.catalogPath
(optional): Default:/catalog-info.yaml
. Path where to look forcatalog-info.yaml
files. When started with/
, it is an absolute path from the repo root.filters
(optional):projectKey
(optional): Regular expression used to filter results based on the project key.repoSlug
(optional): Regular expression used to filter results based on the repo slug.skipArchivedRepos
(optional): Boolean flag to filter out archived repositories.
schedule
:frequency
: How often you want the task to run. The system does its best to avoid overlapping invocations.timeout
: The maximum amount of time that a single task invocation can take.initialDelay
(optional): The amount of time that should pass before the first invocation happens.scope
(optional):'global'
or'local'
. Sets the scope of concurrency control.