Gitolite Essentials by Chamarty, Sitaram -- Read -- Imperial Library of Trantor

Index

Gitolite Essentials

Table of Contents Gitolite Essentials Credits About the Author Acknowledgments About the Reviewers www.PacktPub.com

Support files, eBooks, discount offers and more

Why Subscribe? Free Access for Packt account holders

Preface

What this book covers What you need for this book Who this book is for Conventions Reader feedback Customer support

Errata Piracy Questions

1. Getting Started with Gitolite

Common Access Control needs Access Control example with Gitolite Sampling of Gitolite's power features

Creating groups Personal branches Personal repositories

Gitolite and the Git control flow Trying out Gitolite

Preparing for the setup Installing and setting up a test instance Playing with Gitolite

Summary

2. Installing Gitolite

Gitolite users and the hosting user

Distinguishing users from each other

Preparing the server Getting the Gitolite source Installing the code Setting up Gitolite

Creating an ssh key pair Running the setup command Checking over your new Gitolite server Adding a user Adding a repository

Summary

3. Your Users and Gitolite

Accessing Git repositories

Git servers, SSH, and HTTP

Accessing Gitolite repositories

SSH key pairs Repository naming

Getting information from Gitolite Gitolite commands Getting help for commands Troubleshooting SSH issues

Authorization, not authentication Duplicate public keys Diagnosing public key problems SSH best practice

Summary

4. Adding and Removing Users

Adding users

Behind the scenes

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

Adding repositories Adding existing repositories Common problems and troubleshooting

Ownership and permissions Converting a non-bare repository to a bare repository Gitolite and the update hook

Summary

6. Getting Started with Access Control

Basic access control examples

Basic branch level access control

Lexical syntax of the conf file The syntax of access control rules Branch level access control and refexes

Using deny rules The permission field

Defining user and repo groups

Working with large groups The special @all group

The include statement Rule accumulation and delegation Summary

7. 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

Locating the projects list file Unix permissions and the umask

Specifying Git config values and Gitolite options

Deleting a git-config key Substituting the repository name Overriding config values Gitolite options

Applying deny rules to read access Understanding VREFs Summary

8. Allowing Users to Create Repos

Putting repositories in Sub-directories Repository wildcards

Creating a wildcard repository Giving access to other users Generalizing the ruleset

Explaining wild repos to your users Managing with just wild repos Deleting wild repositories Summary

9. Customizing Gitolite

Core and non-core Gitolite Types of non-core code and examples

Commands Syntactic sugar Triggers Virtual refs

Writing your own non-core code Summary

10. Understanding VREFs

Migrating update hooks Passing arguments to the VREF code Using the permission field

Maintaining the update hook function

Default is success Example VREFs and their usage Writing your own VREF Summary

11. Mirroring

Terminology and basic concepts

Repository level mirroring The gitolite-admin repository

Setting up mirroring

Example setup Bootstrapping the mirroring process Mirroring other repositories

Local repositories and hostname substitution Redirecting pushes Manual synchronization Switching to a different master Summary

Index

← Prev
Back
Next →

← Prev
Back
Next →