AccuRev® GitCentric™ User’s Help Version 2013.2 Revised 10/7/13 Copyright and Trademarks Copyright © AccuRev, Inc. 1995--2013 ALL RIGHTS RESERVED This product incorporates technology that may be covered by one or more of the following patents: U.S. Patent Numbers: 7,437,722; 7,614,038. AccuRev and TimeSafe are registered trademarks of AccuRev, Inc. AccuBridge, AccuReplica, AccuSync, AccuWork, Kando, GitCentric, and StreamBrowser are trademarks of AccuRev, Inc. All other trade names, trademarks, and service marks used in this document are the property of their respective owners. Table of Contents Preface........................................................................................................................ vii Audience .............................................................................................................................................................vii Using This Book .................................................................................................................................................vii Typographical Conventions .............................................................................................................................. viii Contacting Technical Support........................................................................................................................... viii License Issues ............................................................................................................................................ viii Other Support Issues.................................................................................................................................. viii Other Resources............................................................................................................................................ix 1. Concepts and Overview.......................................................................................... 1 What is AccuRev GitCentric?...............................................................................................................................1 Where to go for More Information .......................................................................................................................1 A Note About Terminology...........................................................................................................................2 Basic Architecture.................................................................................................................................................3 GitCentric Users ...................................................................................................................................................4 GitCentric Administrators and Mapping Branches to Streams.............................................................................4 Basic Rules ....................................................................................................................................................5 Mapped Behavior...........................................................................................................................................5 Best Practices When Planning Your Installation ...........................................................................................5 Keeping Git Merges and AccuRev Promotes in Sync...................................................................................6 Best Practice for Keeping Merges and Promotes in Sync .............................................................................7 Scenarios for Mapping Multiple Repositories to a Single Stream ................................................................7 Multiple Repos and Multiple Servers............................................................................................................8 AccuRev Replica Server Restriction .............................................................................................................9 Configuring for Security.......................................................................................................................................9 Configuring Multiple Git Repos with AccuRev and EACLs ......................................................................10 Getting Started ....................................................................................................................................................11 2. How to..................................................................................................................... 13 Procedures for All Users.....................................................................................................................................13 Get Started ..........................................................................................................................................................13 Define and Display a Site Header or Footer for Gerrit Code Review.........................................................17 Configure the Clone for Code Review (Optional).......................................................................................18 Configure the Clone for Direct Push ...........................................................................................................18 Troubleshoot Git Clone Issues.....................................................................................................................18 Configure GitCentric ...................................................................................................................................21 Remove a Branch.........................................................................................................................................23 Remove a Repository...................................................................................................................................23 A Note About AccuRev Depots ..................................................................................................................23 Import a Snapshot of the Latest Heads into AccuRev.................................................................................24 Import Complete Git History into AccuRev [BETA only]..........................................................................25 GitCentric User’s Help iii General Procedure for Setting ACLs...........................................................................................................30 Configuring ACLs for Code Review...........................................................................................................32 Configuring GitCentric ACLs for Direct Push............................................................................................34 Specify the Server and Service Account .....................................................................................................34 Map the Branch to the Stream .....................................................................................................................36 Registering an AccuRev Server...................................................................................................................39 Configuring the AccuRev Server.................................................................................................................40 Configure Multiple AccuRev Servers .........................................................................................................41 To View and Access Groups........................................................................................................................42 Add a Group ................................................................................................................................................42 Add a Member to a Group...........................................................................................................................42 AccuRev Groups..........................................................................................................................................43 Allowing Self-Reviews................................................................................................................................44 Disabling Code Review ...............................................................................................................................44 Overview......................................................................................................................................................45 Registering the GitCentric Bridge SSH Key with Gerrit.............................................................................45 Modifying the replication.config File..........................................................................................................45 AccuRev to Git ............................................................................................................................................47 Git to AccuRev ............................................................................................................................................47 3. My Account ............................................................................................................ 49 Menu Options .....................................................................................................................................................49 Profile ..........................................................................................................................................................49