Documents

BitbucketServer042.pdf

Description
Download BitbucketServer042.pdf
Categories
Published
of 357
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Related Documents
Share
Transcript
  Documentation for Bitbucket Server 4.2  Documentation for Bitbucket Server 4.2  2 Created in 2016 by Atlassian. Licensed under a .Creative Commons Attribution 2.5 Australia License  Contents  Bitbucket Server documentation home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Supported platforms details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Using Bitbucket Server in the enterprise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Installing and upgrading Git . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Configuring JIRA integration in the Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Getting started with Git and Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Importing code from an existing project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Bitbucket Server tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Tutorial: Work with Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Set up SourceTree to work with Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . 30 Create a personal repository in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Clone your repository and manage files locally . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Commit and push changes to Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Using Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Creating projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Creating repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Creating personal repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Using repository hooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Permanently authenticating with Git repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Clone a repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Controlling access to code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Using branch permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Branch permission patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Using repository permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Using project permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Allowing public access to code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Using SSH keys to secure Git operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Creating SSH keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 SSH user keys for personal use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 SSH access keys for system use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Workflow strategies in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Using branches in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Automatic branch merging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Using forks in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Keeping forks synchronized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Using pull requests in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Checks for merging pull requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Markdown syntax guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Requesting add-ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Integrating Bitbucket Server with Atlassian applications . . . . . . . . . . . . . . . . . . . . . . . . . . 86 JIRA integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 HipChat notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Bamboo integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Administering Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Users and groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 External user directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Connecting Bitbucket Server to an existing LDAP directory . . . . . . . . . . . . . . . . . . . . 101 Connecting Bitbucket Server to JIRA for user management . . . . . . . . . . . . . . . . . . . . 108 Delegating Bitbucket Server authentication to an LDAP directory . . . . . . . . . . . . . . . . 111 Connecting Bitbucket Server to Crowd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Global permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Setting up your mail server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Linking Bitbucket Server with JIRA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121  Documentation for Bitbucket Server 4.2  3 Created in 2016 by Atlassian. Licensed under a .Creative Commons Attribution 2.5 Australia License   Using custom JIRA issue keys with Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . 124 Connecting Bitbucket Server to an external database . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Connecting Bitbucket Server to MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Connecting Bitbucket Server to Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Connecting Bitbucket Server to PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Connecting Bitbucket Server to SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Transitioning from jTDS to Microsoft's JDBC driver . . . . . . . . . . . . . . . . . . . . . . . . 139 Migrating Bitbucket Server to another server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Specifying the base URL for Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Configuring the application navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Managing add-ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 POST service webhook for Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Audit logging in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Audit events in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Advanced actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Running the Bitbucket Server installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Automated setup for Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 Starting and stopping Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 Install Bitbucket Server from an archive file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Running Bitbucket Server as a Linux service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Running Bitbucket Server as a Windows service . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 Bitbucket Server config properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 Proxying and securing Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 Securing Bitbucket Server with Tomcat using SSL . . . . . . . . . . . . . . . . . . . . . . . . 203 Integrating Bitbucket Server with Apache HTTP Server . . . . . . . . . . . . . . . . . . . . 210 Securing Bitbucket Server with Apache using SSL . . . . . . . . . . . . . . . . . . . . . . . . 214 Securing Bitbucket Server behind nginx using SSL . . . . . . . . . . . . . . . . . . . . . . . . 218 Securing Bitbucket Server behind HAProxy using SSL . . . . . . . . . . . . . . . . . . . . . 221 Enabling SSH access to Git repositories in Bitbucket Server . . . . . . . . . . . . . . . . . . . 224 Setting up SSH port forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Using diff transcoding in Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 Changing the port that Bitbucket Server listens on . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Moving Bitbucket Server to a different context path . . . . . . . . . . . . . . . . . . . . . . . . . . 232 Running Bitbucket Server with a dedicated user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 Bitbucket Server debug logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 Data recovery and backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 Using the Bitbucket Server Backup Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Using Bitbucket Server DIY Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 Lockout recovery process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Scaling Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 Scaling Bitbucket Server for Continuous Integration performance . . . . . . . . . . . . . 259 Bitbucket Server production server data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 High availability for Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 Clustering with Bitbucket Data Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 Installing Bitbucket Data Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 Adding cluster nodes to Bitbucket Data Center . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 Enabling JMX counters for performance monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Getting started with Bitbucket Server and AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 Quick Start with Bitbucket Server and AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 Launching Bitbucket Server in AWS manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 Administering Bitbucket Server in AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Recommendations for running Bitbucket Server in AWS . . . . . . . . . . . . . . . . . . . . 302 Securing Bitbucket Server in AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 Using Bitbucket Server DIY Backup in AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 Disabling HTTP(S) access to Git repositories in Bitbucket Server . . . . . . . . . . . . . . . 317 Smart Mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 Set up a mirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 Git Large File Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 Updating your Bitbucket Server License Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 Git resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 Basic Git commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 Bitbucket Server FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328  Documentation for Bitbucket Server 4.2  4 Created in 2016 by Atlassian. Licensed under a .Creative Commons Attribution 2.5 Australia License   Bitbucket rebrand FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 How do I change the external database password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 Bitbucket Server home directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 Raising a request with Atlassian Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Support policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 Bug fixing policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 New features policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 Security Bugfix Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Building Bitbucket Server from source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Contributing to the Bitbucket Server documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Collecting analytics for Bitbucket Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 Bitbucket Server EAP - How to update your add-on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks
SAVE OUR EARTH

We need your sign to support Project to invent "SMART AND CONTROLLABLE REFLECTIVE BALLOONS" to cover the Sun and Save Our Earth.

More details...

Sign Now!

We are very appreciated for your Prompt Action!

x