SAC:Git Service

From OSGeo
Jump to navigation Jump to search

The TracsvnVM machine hosts a few git related experimental services. This page describes where GIT repositories are and how they can be accessed.


Repositories

There are currently git repositories under /var/www/git/repos (served by Apache) and under /home/git/gitea-repositories (served by Gitea).

Apache runs as user www-data and thus user www-data owns the files in /var/www/git/repos.

Gitea runs as user git and thus user git owns the files in /home/git/gitea-repositories.

There are also a bunch of git repositories used for various system configurations, but they are not exposed to public services as such.

Some of the repositories from /var/www/git/repos are being transformed to symlinks to repos under /var/www/git/repos. These repositories will only be writable by the ``git`` user, but are made readable also by the rest of the world.

GIT Remote URIs

HTTPS (Read/Write)

Repo URL
/var/www/git/repos https://git.osgeo.org/git/REPONAME
/home/git/gitea-repositories https://git.osgeo.org/gitea/REPONAME

In both cases, LDAP authentication is allowed. For the /git/REPONAME LDAP authentication is _required_, and you need to use the Git protocol access for an anonymous checkout.

In both cases, http access redirects to https.

GIT protocol (Read Only)

Repos in /var/www/git/repos are served via git protocol with git://git.osgeo.org/REPONAME as long as they contain a file named git-daemon-export-ok

Repos in /home/git/gitea-repositories are NOT accessible via git protocol, unless made available via symlinks from /var/www/git/repos (as done for the GEOS repository, for example)

The handling server is SAC:GitDaemon

Web Interfaces

gitlab

GitLab is an alternative to gitea with some extra features. It can be accessed at the url https://git.osgeo.org/gitlab.

NOTE: Currently the GitLab installation is experimental and exists for evaluation purposes, it is not on the TracSVN machine but on a VM temporarely provided for the purpose by Vincent Picavet. The TracSVN machine solely acts as a reverse proxy.

See SAC:GitLab for more details.

gitea

Gitea allows anyone with an OSGeo Userid to create public or private repositories, manage access to them (individual or organization based), manage git hooks on the repositories and much more. It can be accessed at the url https://git.osgeo.org/gitea See SAC:Gitea for more details.

trac

Any trac instance administrator can expose any git repository on the system by simply referencing full path to it from the repository section of the administration panel. This may be a problem for private repositories if trac instance administrators are not careful.

Commits in a so-mapped git repository can be referenced in trac ticket comments, and git commit logs can update trac tickets. Creating a git repository via Trac is not possible at the time of writing (2016-04-19)

gitweb

Gitweb gives a read-only view into repositories in /var/www/git/repos. The entry point url is https://git.osgeo.org/gitweb/ where only selected repositories are shown (TODO: selected where?). But knowing the url template you can access any repository under the given base directory, following symlinks, like https://git.osgeo.org/gitweb/?p=geos

See Also