Difference between revisions of "SAC:Gitea"

From OSGeo
Jump to navigation Jump to search
(→‎Continuous integration: add Woodie, although non existing yet)
 
(21 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  
Gogs is an '''experimental''' instance of the [https://gogs.io/ Go Git Service] that runs on [[TracsvnVM]] as part of the [[SAC:Git Service|OSGeo Git Services]].
+
Gitea is an instance of the [https://gitea.io/ Go Git Service] that runs on [[TracSVN]] as part of the [[SAC:Git Service|OSGeo Git Services]].
  
It can be accessed via https://git.osgeo.org/gogs/ (login with your [[SAC:LDAP|OSGeo Userid]])
+
It can be accessed via https://git.osgeo.org/gitea/ (login with your [[SAC:LDAP|OSGeo Userid]])
  
 
= Files location and configuration =
 
= Files location and configuration =
  
It is installed in ''/home/git/gogs''.
+
It is installed in <code>/home/git/gitea</code>.
Its configuration is in the ''custom/'' subdir and revision-controlled under git.
+
Its configuration is in the ''custom/'' subdir and controlled via ansible.
A clone of the configuration git repo can be accessed here: https://git.osgeo.org/gogs/sac/gogs-config (request access via sac mailing list).
 
  
Repositories are in ''/home/git/gogs-repositories'' and all files are created as readable for any user in the ''git'' group.
+
Repositories are in <code>/home/git/gitea-repositories</code> and all files are created as readable for any user in the ''git'' group.
Apache running user (''www-data'') is made part of the group to allow for browsing gogs-managed repositories via existing [[Trac_Instances|trac instances]].
+
Apache running user (''www-data'') is made part of the group to allow for browsing ''gitea-managed'' repositories via existing [[Trac_Instances|trac instances]].
  
It is configured to use [[SAC:LDAP|LDAP]] for authentication and PostgreSQL as the backend, see the configuration for access parameters.
+
Attachment and session data are in <code>/home/git/gitea/data</code>.
Backups should be currently automated for the database (but at the time of writing there are no details in [[SAC:Backups]])
 
  
It listens on IP 127.0.0.1 and TCP port 3000 via HTTP. Apache is configured to deal with HTTPS and act as a proxy.
+
It is configured to use [[SAC:LDAP|LDAP]] for authentication and ''PostgreSQL'' as the backend, see the configuration for access parameters.
See [[TracsvnVM]] for info about the apache configuration.
 
  
Gogs is composed by a single binary and a bunch of templates and web assets (images, javascript).
+
Backups are currently automated for the database and data directory via scripts in <code>/osgeo/backup/</code> (start from <code>/osgeo/backup/bacula_before.sh</code>). No repositories are backed up (what's a distributed code version control system worth otherwise?:). Refer to [[SAC:Backups]] for other backup info.
See https://gogs.io/ for more info.
 
  
= Starting and stopping the service =
+
It listens on IP <code>127.0.0.1</code> and TCP port <code>3001</code> via HTTP. Apache is configured to deal with HTTPS and act as a proxy.
 +
See [[TracSVN]] for info about the apache configuration.
  
The service is started via sysV init script /etc/init.d/gogs which is a symlink to a file in /home/git/gogs/scripts. The init script is symlinked to rc3.d for use in runlevel 3
+
Gitea is built to be composed by a single binary.
 +
See https://gitea.io/ for more info.
  
 
= Administration =
 
= Administration =
  
 
At the moment [[User:Strk|Sandro Santilli]] (promoter of the initiative) and Martin Spott have admin privileges from the web UI.
 
At the moment [[User:Strk|Sandro Santilli]] (promoter of the initiative) and Martin Spott have admin privileges from the web UI.
 +
[[User:Robe|Regina Obe]] and [[Jeff McKenna]] are willing to help.
 +
 +
Server configuration is done via https://git.osgeo.org/gitea/sac/ansible-deployment
 +
(requires login and authorization to see)
 +
 +
== Starting and stopping the service ==
 +
 +
The service is managed via systemctl:
 +
 +
  - systemctl start gitea
 +
  - systemctl stop gitea
 +
  - systemctl restart gitea
 +
 +
= Continuous integration =
 +
 +
A CI server is associated to the hosting service,
 +
see [[Dronie]] and [[Woodie]]
  
 
[[Category:Infrastructure]]
 
[[Category:Infrastructure]]

Latest revision as of 07:32, 8 May 2024

Gitea is an instance of the Go Git Service that runs on TracSVN as part of the OSGeo Git Services.

It can be accessed via https://git.osgeo.org/gitea/ (login with your OSGeo Userid)

Files location and configuration

It is installed in /home/git/gitea. Its configuration is in the custom/ subdir and controlled via ansible.

Repositories are in /home/git/gitea-repositories and all files are created as readable for any user in the git group. Apache running user (www-data) is made part of the group to allow for browsing gitea-managed repositories via existing trac instances.

Attachment and session data are in /home/git/gitea/data.

It is configured to use LDAP for authentication and PostgreSQL as the backend, see the configuration for access parameters.

Backups are currently automated for the database and data directory via scripts in /osgeo/backup/ (start from /osgeo/backup/bacula_before.sh). No repositories are backed up (what's a distributed code version control system worth otherwise?:). Refer to SAC:Backups for other backup info.

It listens on IP 127.0.0.1 and TCP port 3001 via HTTP. Apache is configured to deal with HTTPS and act as a proxy. See TracSVN for info about the apache configuration.

Gitea is built to be composed by a single binary. See https://gitea.io/ for more info.

Administration

At the moment Sandro Santilli (promoter of the initiative) and Martin Spott have admin privileges from the web UI. Regina Obe and Jeff McKenna are willing to help.

Server configuration is done via https://git.osgeo.org/gitea/sac/ansible-deployment

(requires login and authorization to see)

Starting and stopping the service

The service is managed via systemctl:

 - systemctl start gitea
 - systemctl stop gitea
 - systemctl restart gitea

Continuous integration

A CI server is associated to the hosting service, see Dronie and Woodie