Book Image

Gitolite Essentials

By : Sitaram Chamarty
Book Image

Gitolite Essentials

By: Sitaram Chamarty

Overview of this book

Related Content you might be interested in

Current Title:

Small book image
Gitolite Essentials
Sitaram Chamarty
Apr, 2014 | 120 pages
No titles found
Table of Contents (19 chapters)
Gitolite Essentials
Gitolite Essentials
Credits
Credits
About the Author
About the Author
Acknowledgments
Acknowledgments
About the Reviewers
About the Reviewers
www.PacktPub.com
www.PacktPub.com
Preface
Preface
Free Chapter
1
Getting Started with Gitolite
Getting Started with Gitolite
Common Access Control needs
Access Control example with Gitolite
Sampling of Gitolite's power features
Gitolite and the Git control flow
Trying out Gitolite
Summary
2
Installing Gitolite
Installing Gitolite
Gitolite users and the hosting user
Preparing the server
Getting the Gitolite source
Installing the code
Setting up Gitolite
Summary
3
Your Users and Gitolite
Your Users and Gitolite
Accessing Git repositories
Accessing Gitolite repositories
Getting information from Gitolite
Gitolite commands
Getting help for commands
Troubleshooting SSH issues
Summary
4
Adding and Removing Users
Adding and Removing Users
Adding users
Users with multiple key pairs
Giving some users a shell
Managing keys outside Gitolite
Getting user group information from LDAP
Removing users
Summary
5
Managing Repositories
Managing Repositories
Adding repositories
Adding existing repositories
Common problems and troubleshooting
Summary
6
Getting Started with Access Control
Getting Started with Access Control
Basic access control examples
Lexical syntax of the conf file
The syntax of access control rules
Branch level access control and refexes
Defining user and repo groups
The include statement
Rule accumulation and delegation
Summary
7
Advanced Access Control and Configuration
Advanced Access Control and Configuration
Making changes to the rc file
Giving users their own branches
Types of write operations
Allowing Gitweb and Git-daemon access
Specifying Git config values and Gitolite options
Applying deny rules to read access
Understanding VREFs
Summary
8
Allowing Users to Create Repos
Allowing Users to Create Repos
Putting repositories in Sub-directories
Repository wildcards
Explaining wild repos to your users
Managing with just wild repos
Deleting wild repositories
Summary
9
Customizing Gitolite
Customizing Gitolite
Core and non-core Gitolite
Types of non-core code and examples
Writing your own non-core code
Summary
10
Understanding VREFs
Understanding VREFs
Migrating update hooks
Passing arguments to the VREF code
Using the permission field
Default is success
Example VREFs and their usage
Writing your own VREF
Summary
11
Mirroring
Mirroring
Terminology and basic concepts
Setting up mirroring
Local repositories and hostname substitution
Redirecting pushes
Manual synchronization
Switching to a different master
Summary
Index
Index

Preparing the server

Gitolite can be installed on any Unix server. This includes Linux, any of the BSDs, and the legacy Unix servers such as AIX and HP-UX. With that said, here are the requirements:

  • A Unix system with a POSIX-compatible sh (shell)

  • Git Version 1.7.1 or higher

  • Perl 5.8.8 or higher

  • OpenSSH 5.0 or higher

  • A dedicated Unix user as the hosting user described previously, whose home directory must be on a filesystem that supports symlinks, and allows executables (that is, it is not mounted with the noexec mount flag)

    Tip

    Ideally, you should use a brand new user ID that has no existing files or directories, except for whatever a newly created user gets (such as the bashrc or similar files). This will ensure that any leftover files don't interfere.

Previous Section
End of Section 3
Next Section