Google Git
Sign in
apache / incubator-devlake-website / refs/heads/asf-site / . / docs / v0.21 / Configuration / BitBucket / index.html
blob: 4426aeefae31cbe3ba23a56df807d71fa5032af5 [file] [log] [blame]
<!doctype html>
<html lang="en-GB" dir="ltr" class="docs-wrapper docs-doc-page docs-version-v0.21 plugin-docs plugin-id-default docs-doc-id-Configuration/BitBucket">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="generator" content="Docusaurus v2.0.0-rc.1">
<link rel="alternate" type="application/rss+xml" href="/blog/rss.xml" title="Apache DevLake - Open-Source Dev Data Platform for Productivity RSS Feed">
<link rel="alternate" type="application/atom+xml" href="/blog/atom.xml" title="Apache DevLake - Open-Source Dev Data Platform for Productivity Atom Feed"><title data-rh="true">BitBucket Cloud | Apache DevLake - Open-Source Dev Data Platform for Productivity</title><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://devlake.apache.org/docs/v0.21/Configuration/BitBucket"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="keywords" content="Engineering Productivity, Open-Source Engineering, Open-Source Integration Tools, Data Integrates Platform, Open-Source Dev Platform, Open-Source Data Integrates, DevOps Tools Integrates, Open-Source DevOps Tools"><meta data-rh="true" name="docusaurus_version" content="v0.21"><meta data-rh="true" name="docusaurus_tag" content="docs-default-v0.21"><meta data-rh="true" name="docsearch:version" content="v0.21"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-v0.21"><meta data-rh="true" property="og:title" content="BitBucket Cloud | Apache DevLake - Open-Source Dev Data Platform for Productivity"><meta data-rh="true" name="description" content="Config UI instruction for BitBucket(Cloud)"><meta data-rh="true" property="og:description" content="Config UI instruction for BitBucket(Cloud)"><link data-rh="true" rel="icon" href="/img/logo.svg"><link data-rh="true" rel="canonical" href="https://devlake.apache.org/docs/v0.21/Configuration/BitBucket"><link data-rh="true" rel="alternate" href="https://devlake.apache.org/docs/v0.21/Configuration/BitBucket" hreflang="en-GB"><link data-rh="true" rel="alternate" href="https://devlake.apache.org/zh/docs/v0.21/Configuration/BitBucket" hreflang="zh"><link data-rh="true" rel="alternate" href="https://devlake.apache.org/docs/v0.21/Configuration/BitBucket" hreflang="x-default"><link rel="stylesheet" href="/assets/css/styles.ddc6bf33.css">
<link rel="preload" href="/assets/js/runtime~main.da0d55e0.js" as="script">
<link rel="preload" href="/assets/js/main.a12a6bb4.js" as="script">
</head>
<body class="navigation-with-keyboard">
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
<div role="region"><a href="#" class="skipToContent_fXgn">Skip to main content</a></div><nav class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Navigation bar toggle" class="navbar__toggle clean-btn" type="button" tabindex="0"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/logo.svg" alt="apache devlake" class="themedImage_ToTc themedImage--light_HNdA"><img src="/img/logo.svg" alt="apache devlake" class="themedImage_ToTc themedImage--dark_i4oU"></div><b class="navbar__title text--truncate">Apache DevLake</b></a></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link">Docs</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/docs/Overview/Introduction">Next</a></li><li><a class="dropdown__link" href="/docs/v1.0/Overview/Introduction">v1.0 (Stable)</a></li><li><a class="dropdown__link" href="/docs/v0.21/Overview/Introduction">v0.21</a></li><li><a class="dropdown__link" href="/docs/v0.20/Overview/Introduction">v0.20</a></li><li><a class="dropdown__link" href="/docs/v0.19/Overview/Introduction">v0.19</a></li><li><a class="dropdown__link" href="/docs/v0.18/Overview/Introduction">v0.18</a></li><li><a class="dropdown__link" href="/docs/v0.17/Overview/Introduction">v0.17</a></li><li><a class="dropdown__link" href="/docs/v0.16/Overview/Introduction">v0.16</a></li><li><a class="dropdown__link" href="/docs/v0.15/Overview/Introduction">v0.15</a></li></ul></div><a class="navbar__item navbar__link" href="/livedemo/EngineeringLeads/DORA">Use Cases</a><a class="navbar__item navbar__link" href="/community/">Community</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blogOverview">Blog</a><a href="https://github.com/apache/incubator-devlake" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">GitHub</a><a class="navbar__item navbar__link" href="/download">Download</a><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link">ASF</a><ul class="dropdown__menu"><li><a href="https://www.apache.org/" target="_blank" rel="noopener noreferrer" class="dropdown__link">Foundation</a></li><li><a href="https://www.apache.org/licenses/" target="_blank" rel="noopener noreferrer" class="dropdown__link">License</a></li><li><a href="https://www.apache.org/events/current-event" target="_blank" rel="noopener noreferrer" class="dropdown__link">Events</a></li><li><a href="https://www.apache.org/security/" target="_blank" rel="noopener noreferrer" class="dropdown__link">Security</a></li><li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" target="_blank" rel="noopener noreferrer" class="dropdown__link">Privacy</a></li><li><a href="https://www.apache.org/foundation/sponsorship.html" target="_blank" rel="noopener noreferrer" class="dropdown__link">Sponsorship</a></li><li><a href="https://www.apache.org/foundation/thanks.html" target="_blank" rel="noopener noreferrer" class="dropdown__link">Thanks</a></li></ul></div><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="Switch between dark and light mode (currently light mode)" aria-label="Switch between dark and light mode (currently light mode)"><svg viewBox="0 0 24 24" width="24" height="24" class="lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" class="darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg></button></div><div class="searchBox_ZlJk"><div class="navbar__search searchBarContainer_NW3z"><input placeholder="Search" aria-label="Search" class="navbar__search-input"><div class="loadingRing_RJI3 searchBarLoadingRing_YnHq"><div></div><div></div><div></div><div></div></div></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div class="main-wrapper mainWrapper_z2l0 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebar_njMd"><nav class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/docs/v0.21/Overview">Overview</a><button aria-label="Toggle the collapsible sidebar category &#x27;Overview&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/docs/v0.21/GettingStarted">Getting Started</a><button aria-label="Toggle the collapsible sidebar category &#x27;Getting Started&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" href="/docs/v0.21/Config UI">Config UI</a><button aria-label="Toggle the collapsible sidebar category &#x27;Config UI&#x27;" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/Tutorial">Tutorial</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/HowToOrganizeDevlakeProjects">How to Organize DevLake Projects</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/AzureDevOps">Azure DevOps</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/docs/v0.21/Configuration/BitBucket">BitBucket Cloud</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/CircleCI">CircleCI</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/GitHub">GitHub</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/GitLab">GitLab</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/Opsgenie">Opsgenie</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/Jenkins">Jenkins</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/Jira">Jira</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/PagerDuty">PagerDuty</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/SonarQube">SonarQube Server</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/Tapd">TAPD</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/Teambition">Teambition(WIP)</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/webhook">Webhooks</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/Zentao">Zentao</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/AdvancedMode">Blueprint Advanced Mode</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/APIKeys">API Keys</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/v0.21/Configuration/TeamConfiguration">Team Configuration</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" tabindex="0" href="/docs/v0.21/Configuration/Dashboards/AccessControl">Dashboard Configuration</a></div></li></ul></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/docs/v0.21/DORA">DORA</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/docs/v0.21/Metrics">Metrics</a><button aria-label="Toggle the collapsible sidebar category &#x27;Metrics&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/docs/v0.21/DataModels">Data Models</a><button aria-label="Toggle the collapsible sidebar category &#x27;Data Models&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/docs/v0.21/DeveloperManuals">Developer Manuals</a><button aria-label="Toggle the collapsible sidebar category &#x27;Developer Manuals&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/docs/v0.21/Plugins">Plugins</a><button aria-label="Toggle the collapsible sidebar category &#x27;Plugins&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/docs/v0.21/Troubleshooting">Troubleshooting</a><button aria-label="Toggle the collapsible sidebar category &#x27;Troubleshooting&#x27;" type="button" class="clean-btn menu__caret"></button></div></li></ul></nav></div></aside><main class="docMainContainer_gTbr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="theme-doc-version-banner alert alert--warning margin-bottom--md" role="alert"><div>This is documentation for <!-- -->Apache DevLake - Open-Source Dev Data Platform for Productivity<!-- --> <b>v0.21</b>, which is no longer actively maintained.</div><div class="margin-top--md">For up-to-date documentation, see the <b><a href="/docs/Configuration/BitBucket">latest version</a></b> (<!-- -->Next<!-- -->).</div></div><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_OVgt"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/docs/v0.21/Config UI"><span itemprop="name">Config UI</span></a><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">BitBucket Cloud</span><meta itemprop="position" content="2"></li></ul></nav><span class="theme-doc-version-badge badge badge--secondary">Version: v0.21</span><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>BitBucket Cloud</h1></header><p>Visit Config UI at : <code>http://localhost:4000</code> and go to <code>Connections</code> page.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="step-1---add-data-connections">Step 1 - Add Data Connections<a class="hash-link" href="#step-1---add-data-connections" title="Direct link to heading">​</a></h2><p><img loading="lazy" src="https://user-images.githubusercontent.com/3294100/220118398-2d08070f-0edb-4de6-8696-9ee58b80719b.png" alt="image" class="img_ev3q"></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="connection-name">Connection Name<a class="hash-link" href="#connection-name" title="Direct link to heading">​</a></h3><p>Give your connection a unique name to help you identify it in the future.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="endpoint-url">Endpoint URL<a class="hash-link" href="#endpoint-url" title="Direct link to heading">​</a></h3><p>For BitBucket Cloud, you do not need to enter the REST API endpoint URL, which is always <code>https://api.bitbucket.org/2.0/</code>.</p><p>DevLake will support BitBucket Server in the future.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="username-and-app-password">Username and App Password<a class="hash-link" href="#username-and-app-password" title="Direct link to heading">​</a></h3><p>Learn about <a href="https://support.atlassian.com/bitbucket-cloud/docs/create-an-app-password/" target="_blank" rel="noopener noreferrer">how to create a BitBucket app password</a>.</p><p>The following permissions are required to collect data from BitBucket repositories:</p><ul><li>Account:Read</li><li>Workspace membership:Read</li><li>Projects:Read</li><li>Repositories:Read</li><li>Pull requests:Read</li><li>Issues:Read</li><li>Pipelines:Read</li><li>Runners:Read</li></ul><p><img loading="lazy" alt="bitbucket-app-password-permissions" src="/assets/images/bitbucket-app-password-permissions-2b87fad376a9ab4a5e4f52b4352d38f1.jpeg" width="1212" height="830" class="img_ev3q"></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="proxy-url-optional">Proxy URL (Optional)<a class="hash-link" href="#proxy-url-optional" title="Direct link to heading">​</a></h3><p>If you are behind a corporate firewall or VPN you may need to utilize a proxy server. Enter a valid proxy server address on your network, e.g. <code>http://your-proxy-server.com:1080</code></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="fixed-rate-limit-optional">Fixed Rate Limit (Optional)<a class="hash-link" href="#fixed-rate-limit-optional" title="Direct link to heading">​</a></h3><p>DevLake uses a dynamic rate limit to collect BitBucket data. You can adjust the rate limit if you want to increase or lower the speed.</p><p>The maximum rate limit for different entities in BitBucket(Cloud) <a href="https://support.atlassian.com/bitbucket-cloud/docs/api-request-limits/" target="_blank" rel="noopener noreferrer">varies from 1,000 - 60,000 requests/hour</a>. The rate limit to access repository data is 1,000 requests/hour, but we find it can still run when we input a value that exceeds 1,000. You can try using a larger rate limit if you have large repositories.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="test-and-save-connection">Test and Save Connection<a class="hash-link" href="#test-and-save-connection" title="Direct link to heading">​</a></h3><p>Click <code>Test Connection</code>, if the connection is successful, click <code>Save Connection</code> to add the connection.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="step-2---configure-blueprint">Step 2 - Configure Blueprint<a class="hash-link" href="#step-2---configure-blueprint" title="Direct link to heading">​</a></h2><p><img loading="lazy" src="https://user-images.githubusercontent.com/14050754/224308925-449a4d3e-ed52-45e9-bb72-0d2892df374f.png" alt="image" class="img_ev3q"></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="repositories">Repositories<a class="hash-link" href="#repositories" title="Direct link to heading">​</a></h3><p>Select the BitBucket repositories to collect.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="data-entities">Data Entities<a class="hash-link" href="#data-entities" title="Direct link to heading">​</a></h3><p>Usually, you don&#x27;t have to modify this part. However, if you don&#x27;t want to collect certain BitBucket entities, you can unselect some entities to accelerate the collection speed.</p><ul><li>Issue Tracking: BitBucket issues, issue comments, etc.</li><li>Source Code Management: BitBucket repos, refs, commits, etc.</li><li>Code Review: BitBucket PRs, PR comments, etc.</li><li>CI/CD: BitBucket Pipelines, BitBucket Deployments, etc.</li><li>Cross Domain: BitBucket accounts, etc.</li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="step-3---adding-transformation-rules-optional">Step 3 - Adding Transformation Rules (Optional)<a class="hash-link" href="#step-3---adding-transformation-rules-optional" title="Direct link to heading">​</a></h2><p>You can add a <code>transformation</code> to standardize the data. A <code>transformation</code> acts on the BitBucket data in the <a href="/docs/DataModels/ToolLayerSchema">tool layer</a>, transforming it to the <a href="/docs/DataModels/DevLakeDomainLayerSchema">domain layer</a>.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="issue-tracking">Issue Tracking<a class="hash-link" href="#issue-tracking" title="Direct link to heading">​</a></h3><p><strong>Issue Status Mapping</strong><br>
<img loading="lazy" src="https://user-images.githubusercontent.com/14050754/224309704-b096c256-b2cf-4107-b78c-044d06b5f23c.png" alt="image" class="img_ev3q"></p><p>The given settings transformed the BitBucket issue statuses to the issue statuses used by DevLake, enabling you to measure metrics like the Issue Delivery Rate on the pre-built dashboards, as DevLake understands your definition of when an issue is considered as completed (status = &#x27;DONE&#x27;).</p><ul><li>TODO: The issues that are planned but have not been worked on yet </li><li>IN-PROGRESS: The issues that are work-in-progress</li><li>DONE: The issues that are completed</li><li>OTHER: Other issues statuses that do not belong to the three statuses above</li></ul><p>The original status will be saved in the column <code>original_status</code> of the table &#x27;issues&#x27;, and the new status will be saved in the column <code>status</code> of the same table.</p><p><strong>Issue Type Mapping</strong><br>
DevLake will convert the issue types of &#x27;enhancement&#x27;, &#x27;proposal&#x27;, and &#x27;task&#x27; from BitBucket into the new issue type &#x27;REQUIREMENT&#x27; for DevLake. In contrast, any issues classified as &#x27;bug&#x27; in BitBucket will be converted into the new issue type &#x27;BUG&#x27; for DevLake. The original type will be saved in the column <code>original_type</code> of the table &#x27;issues&#x27;, and the new type will be saved in the column <code>type</code> of the same table.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="cicd">CI/CD<a class="hash-link" href="#cicd" title="Direct link to heading">​</a></h3><p>The CI/CD configuration for BitBucket is used for calculating <a href="/docs/v0.21/DORA">DORA metrics</a>.</p><p>By default, DevLake will identify the deployment and environment settings that are defined in the BitBucket CI .yml file. </p><p><img loading="lazy" src="https://user-images.githubusercontent.com/14050754/224311429-31304867-8cdd-476b-8675-e4acbc17f552.png" alt="image" class="img_ev3q"></p><p>However, to ensure this works properly, you must specify the deployment settings in the .yml file.
<img loading="lazy" src="https://user-images.githubusercontent.com/3294100/221528908-4943b1e6-1398-49e9-8ce9-aa264995f9bc.jpg" alt="img_v2_89602d14-a733-4679-9d4b-d9635c03bc5g" class="img_ev3q"></p><p>The pipeline steps with the <code>deployment</code> key will be recognized as DevLake deployments. The value of the <code>deployment</code> key will be recognized as the environment of DevLake deployments.</p><p>All BitBucket pipeline steps will be saved in table &#x27;cicd_tasks&#x27;, but DevLake deployments will be set as <code>type</code> = &#x27;deployment&#x27; and <code>environment</code> = &#x27;{BitBucket-pipeline-step.deployment.value}&#x27;.</p><p>If you have not defined these settings in the .yml file, please select &#x27;Detect Deployments from Pipeline steps in BitBucket&#x27;, and input the RegEx in the following fields:</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/14050754/224310350-cc9a4901-476d-4583-ad73-4d3b394bc343.png" alt="image" class="img_ev3q"></p><ul><li>Deployment: A pipeline step with a name that matches the given RegEx will be recognized as a DevLake deployment.</li><li>Production: A pipeline step with a name that matches the given RegEx will be recognized as a DevLake cicd_task in the production environment.</li></ul><p><strong>Introduction to BitBucket CI entities</strong><br>
BitBucket has several key CI entities: <code>pipelines</code>, <code>pipeline steps</code>, and <code>deployments</code>. A Bitbucket pipeline contains several pipeline steps. Each pipeline step defined with a deployment key can be mapped to a BitBucket deployment.</p><p>Each Bitbucket pipeline is converted to a cicd_pipeline in DevLake&#x27;s domain layer schema and each Bitbucket pipeline step is converted to a cicd_task in DevLake&#x27;s domain layer.
<img loading="lazy" src="https://user-images.githubusercontent.com/3294100/220288225-71bee07d-c319-45bd-98e5-f4d01359840e.png" alt="image" class="img_ev3q"></p><p>If a pipeline step defines <code>deployment</code> with a value (usually indicating the environment), this pipeline step is also a BitBucket deployment.</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/3294100/221887426-4cae1c46-31ce-4fcd-b773-a54c28af0264.png" alt="image" class="img_ev3q"></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="additional-settings-optional">Additional Settings (Optional)<a class="hash-link" href="#additional-settings-optional" title="Direct link to heading">​</a></h3><ul><li><p>Tags Limit: DevLake compares the last N pairs of tags to get the &quot;commit diff&#x27;, &quot;issue diff&quot; between tags. N defaults to 10.</p><ul><li>commit diff: new commits for a tag relative to the previous one</li><li>issue diff: issues solved by the new commits for a tag relative to the previous one</li></ul></li><li><p>Tags Pattern: Only tags that meet the given Regular Expression will be counted.</p></li><li><p>Tags Order: Only &quot;reverse semver&quot; order is supported for now.</p></li></ul><p>Please click <code>Save</code> to save the transformation rules for the repo. In the data scope list, click <code>Next Step</code> to continue configuring.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="step-4---setting-sync-policy">Step 4 - Setting Sync Policy<a class="hash-link" href="#step-4---setting-sync-policy" title="Direct link to heading">​</a></h2><p>You can choose how often you would like to sync your data in this step by selecting a sync frequency option or entering a cron code to specify your prefered schedule.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="troubleshooting">Troubleshooting<a class="hash-link" href="#troubleshooting" title="Direct link to heading">​</a></h2><p>If you run into any problems, please check the <a href="/docs/v0.21/Troubleshooting/Configuration">Troubleshooting</a> or <a href="https://github.com/apache/incubator-devlake/issues" target="_blank" rel="noopener noreferrer">create an issue</a>.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/apache/incubator-devlake-website/edit/main/versioned_docs/version-v0.21/Configuration/BitBucket.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages navigation"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/v0.21/Configuration/AzureDevOps"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Azure DevOps</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/v0.21/Configuration/CircleCI"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">CircleCI</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#step-1---add-data-connections" class="table-of-contents__link toc-highlight">Step 1 - Add Data Connections</a><ul><li><a href="#connection-name" class="table-of-contents__link toc-highlight">Connection Name</a></li><li><a href="#endpoint-url" class="table-of-contents__link toc-highlight">Endpoint URL</a></li><li><a href="#username-and-app-password" class="table-of-contents__link toc-highlight">Username and App Password</a></li><li><a href="#proxy-url-optional" class="table-of-contents__link toc-highlight">Proxy URL (Optional)</a></li><li><a href="#fixed-rate-limit-optional" class="table-of-contents__link toc-highlight">Fixed Rate Limit (Optional)</a></li><li><a href="#test-and-save-connection" class="table-of-contents__link toc-highlight">Test and Save Connection</a></li></ul></li><li><a href="#step-2---configure-blueprint" class="table-of-contents__link toc-highlight">Step 2 - Configure Blueprint</a><ul><li><a href="#repositories" class="table-of-contents__link toc-highlight">Repositories</a></li><li><a href="#data-entities" class="table-of-contents__link toc-highlight">Data Entities</a></li></ul></li><li><a href="#step-3---adding-transformation-rules-optional" class="table-of-contents__link toc-highlight">Step 3 - Adding Transformation Rules (Optional)</a><ul><li><a href="#issue-tracking" class="table-of-contents__link toc-highlight">Issue Tracking</a></li><li><a href="#cicd" class="table-of-contents__link toc-highlight">CI/CD</a></li><li><a href="#additional-settings-optional" class="table-of-contents__link toc-highlight">Additional Settings (Optional)</a></li></ul></li><li><a href="#step-4---setting-sync-policy" class="table-of-contents__link toc-highlight">Step 4 - Setting Sync Policy</a></li><li><a href="#troubleshooting" class="table-of-contents__link toc-highlight">Troubleshooting</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs/GettingStarted">Getting Started</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/DataModels/DevLakeDomainLayerSchema">Data Models</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/Metrics">Engineering Metrics</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://join.slack.com/t/devlake-io/shared_invite/zt-2ox842kuu-_6x3Lwdj88YpzKhMRpgnMg" target="_blank" rel="noopener noreferrer" class="footer__link-item">Slack</a></li><li class="footer__item"><a href="https://github.com/apache/incubator-devlake/issues" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub Issue Tracker</a></li><li class="footer__item"><a href="https://github.com/apache/incubator-devlake-website/issues" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub Issue Tracker For Docs</a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/apache/incubator-devlake" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub</a></li><li class="footer__item"><a href="https://twitter.com/ApacheDevLake" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter</a></li><li class="footer__item"><a class="footer__link-item" href="/community/trademark">Trademark Guidelines</a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">
<div style="margin-top: 20px">
<a href="https://incubator.apache.org/" target="_blank"><img style="height:40px; margin-bottom: 10px; margin-top: 10px" alt="Apache Software Foundation" src="/img/apache-incubator.svg"></a>
<p style="text-align:left; font-weight: 300; font-size: 0.8em;">Apache DevLake is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</p>
<p style="text-align:left; font-weight: 300; font-size: 0.8em;">Copyright ©2025 Apache DevLake, DevLake, Apache, the Apache feather logo and the Apache DevLake project logo are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries.</p>
</div>
</div></div></div></footer></div>
<script src="/assets/js/runtime~main.da0d55e0.js"></script>
<script src="/assets/js/main.a12a6bb4.js"></script>
</body>
</html>