Difference between revisions of "SAC:Git Service"

From OSGeo
Jump to navigation Jump to search
(→‎gitlab: gogs -> gitea)
 
(13 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
= Repositories =
 
= Repositories =
  
There are currently git repositories under <code>/var/www/git/repos</code> (served by Apache) and under <code>/home/git/gogs-repositories</code> (served by Gogs).
+
There are currently git repositories under <code>/var/www/git/repos</code> (served by Apache) and under <code>/home/git/gitea-repositories</code> (served by Gitea).
  
 
Apache runs as user ''www-data'' and thus user ''www-data'' owns the files in <code>/var/www/git/repos</code>.
 
Apache runs as user ''www-data'' and thus user ''www-data'' owns the files in <code>/var/www/git/repos</code>.
  
[[SAC:Gogs|Gogs]] runs as user ''git'' and thus user ''git'' owns the files in <code>/home/git/gogs-repositories</code>.
+
[[SAC:Gitea|Gitea]] runs as user ''git'' and thus user ''git'' owns the files in <code>/home/git/gitea-repositories</code>.
  
 
There are also a bunch of git repositories used for various system configurations, but they are not exposed to public services as such.
 
There are also a bunch of git repositories used for various system configurations, but they are not exposed to public services as such.
Line 26: Line 26:
 
|<code>https://git.osgeo.org/git/REPONAME</code>
 
|<code>https://git.osgeo.org/git/REPONAME</code>
 
|-
 
|-
|<code>/home/git/gogs-repositories</code>
+
|<code>/home/git/gitea-repositories</code>
|<code>https://git.osgeo.org/gogs/REPONAME</code>
+
|<code>https://git.osgeo.org/gitea/REPONAME</code>
 
|}
 
|}
  
Line 39: Line 39:
 
Repos in <code>/var/www/git/repos</code> are served via git protocol with <code>git://git.osgeo.org/REPONAME</code> as long as they contain a file named <code>git-daemon-export-ok</code>
 
Repos in <code>/var/www/git/repos</code> are served via git protocol with <code>git://git.osgeo.org/REPONAME</code> as long as they contain a file named <code>git-daemon-export-ok</code>
  
Repos in <code>/home/git/gogs-repositories</code> are '''NOT accessible''' via git protocol, unless made available via symlinks from <code>/var/www/git/repos</code> (as done for the GEOS repository, for example)
+
Repos in <code>/home/git/gitea-repositories</code> are '''NOT accessible''' via git protocol, unless made available via symlinks from <code>/var/www/git/repos</code> (as done for the GEOS repository, for example)
  
 
The handling server is [[SAC:GitDaemon]]
 
The handling server is [[SAC:GitDaemon]]
Line 45: Line 45:
 
= Web Interfaces =
 
= Web Interfaces =
  
== gogs ==
+
== gitlab ==
  
Gogs 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
+
GitLab is an alternative to gitea with some extra features. It can be accessed at the url https://git.osgeo.org/gitlab.
accessed at the url https://git.osgeo.org/gogs
 
  
See [[SAC:Gogs]] for more details.
+
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 ==
 
== trac ==
Line 60: Line 67:
 
== gitweb ==
 
== gitweb ==
  
'''TODO'''
+
Gitweb gives a read-only view into repositories in <code>/var/www/git/repos</code>.
 +
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 =
 
= See Also =
  
[[GitInfrastructureComparison]]
+
* [[GitInfrastructureComparison]]
 +
* [[GitServiceRequirement]]
  
  
 
[[Category:Infrastructure]]
 
[[Category:Infrastructure]]
 +
[[Category:Services]]

Latest revision as of 04:07, 17 December 2017

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