Linux Certif

Toute la documentation sur la certification Linux LPI

cg-admin-setuprepo

NAME

cg-admin-setuprepo - setup a public repository

SYNOPSIS

cg-admin-setuprepo [-g GROUP] REPOSITORY

DESCRIPTION

Setup a public GIT repository, that is, one that has no attached working copy and you typically only push into it and pull from it. You need to run this command before you will be able to push into the repository for the first time, but you will be also unable to pull from the repository until you push into it at first.

Therefore the workflow is to first init a regular private repository, then use this command to create the public one, then add the appropriate remote branch (cg-branch-add origin ...) in your private repository and then push to the public repository.

Use gitm[blue]1m[][1] if you want to instead create a new GIT project.

The command will create the repository to reside in REPOSITORY (either local path or git+ssh URL; the directory must not exist before calling this command). By default, it will be world-readable, but writable only by you. If you want to make it possible for multiple users to push, create a group for them and use the -g parameter, which will make gitm[blue]1m[][2] set up the permissions properly.

Note that in case you are using cg-admin-setuprepo with SSH URL instead of a local path, you need a full shell access at the remote machine, the restricted git-shell access is not enough.

The repository will also be set up so that git-update-server-info will be automagically re-ran after each push, in short making it suitable for HTTP access.

Note that you might need to do other additional steps, like touching the git-daemon-export-ok file if you want to make the repository accessible by the git daemon (serving the git://... URIs).

OPTIONS

-g GROUP

Name of the UNIX group covering the users authorized to push into the repository. If unspecified, only you (who ran this command) will have write (push) access.

-h, --help

Print usage summary.

--long-help

Print user manual. The same as found in gitm[blue]1m[][2].

NOTES

It may happen that you are using version of GIT missing the default post-update hook, or that the relevant template hooks are not available on your system or with your GIT installation. In that case, in order to have your repository properly accessible with HTTP, you need to add this to .git/hooks/post-update (and then make it eXecutable):

 #!/bin/sh
 exec git-update-server-info
 

COPYRIGHT

Copyright © Petr Baudis, 2005

SEE ALSO

cg-admin-setuprepo is part of gitm[blue]7m[][3], a toolkit for managing gitm[blue]7m[][4] trees.

NOTES

1.

1

[set $man.base.url.for.relative.links]/cg-init

2.

1

[set $man.base.url.for.relative.links]/cg-admin-setuprepo

3.

7

[set $man.base.url.for.relative.links]/cogito

4.

7

[set $man.base.url.for.relative.links]/git