Add gitea docs

This is based on the recently removed cgit document, but updated
for gitea.

Change-Id: I4bb1f4b9485d15c412e4882ccc0baf031aeba87b
This commit is contained in:
James E. Blair 2019-05-24 11:20:01 -07:00
parent a92ac59e15
commit 860652fedf
2 changed files with 62 additions and 0 deletions

61
doc/source/gitea.rst Normal file
View File

@ -0,0 +1,61 @@
:title: Gitea
.. _gitea:
Gitea
#####
Gitea is running on opendev.org
At a Glance
===========
:Hosts:
* https://opendev.org/
* gitea*.opendev.org
:Ansible:
* :git_file:`playbooks/roles/gitea`
* :git_file:`playbooks/roles/haproxy`
:Configuration:
* :git_file:`playbooks/group_vars/gitea-lb.yaml`
:Projects:
* https://gitea.io/
:Bugs:
* https://storyboard.openstack.org/#!/project/748
* https://github.com/go-gitea/gitea/issues
Overview
========
The OpenDev Git repositories are hosted on a pool of servers. They
are served via https using Gitea behind HAProxy which handles load
balancing across the nodes.
Backend Maintenance
===================
To temporarily remove a git backend from the HAProxy load balancer,
you can put it in "maintenance" mode. This can be done interactively
on the HAProxy host. Note that long-term changes to the topology
should be made via configuration management. These commands must be
run as root.
To see the current status of all servers::
echo "show stat" | socat /var/haproxy/run/stats stdio
To disable a server (eg, gitea08)::
echo "disable server balance_git_http/gitea08.opendev.org" | socat /var/haproxy/run/stats stdio
echo "disable server balance_git_https/gitea08.opendev.org" | socat /var/haproxy/run/stats stdio
To re-enable a server::
echo "enable server balance_git_http/gitea08.opendev.org" | socat /var/haproxy/run/stats stdio
echo "enable server balance_git_https/gitea08.opendev.org" | socat /var/haproxy/run/stats stdio
To run these commands and others interactively, issue the prompt
command to haproxy::
socat readline /var/haproxy/run/stats
prompt

View File

@ -10,6 +10,7 @@ Major Systems
certificate_authority
dns
gerrit
gitea
grafana
grafyaml
zuul