Gitolite Essentials电子书

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