[Savannah-cvs] [106] New page: SavannahServices

[Assaf Gordon]

Revision: 106
          
http://svn.sv.gnu.org/viewvc/?view=rev&root=administration&revision=106
Author:   agn
Date:     2014-11-09 02:16:05 +0000 (Sun, 09 Nov 2014)
Log Message:
-----------
New page: SavannahServices

Modified Paths:
--------------
    trunk/sviki/SavannahArchitecture.mdwn

Added Paths:
-----------
    trunk/sviki/SavannahServices.mdwn

Modified: trunk/sviki/SavannahArchitecture.mdwn
===================================================================
--- trunk/sviki/SavannahArchitecture.mdwn       2014-11-06 00:32:24 UTC (rev 
105)
+++ trunk/sviki/SavannahArchitecture.mdwn       2014-11-09 02:16:05 UTC (rev 
106)
@@ -129,6 +129,7 @@
 The mirrors redirection is handled by Apache2::Geo::Mirror, normally
 installed via cpan.
 
+See also [[SavannahServices]] for list of publically accessible services.
 
 Misc
 ----

Added: trunk/sviki/SavannahServices.mdwn
===================================================================
--- trunk/sviki/SavannahServices.mdwn                           (rev 0)
+++ trunk/sviki/SavannahServices.mdwn   2014-11-09 02:16:05 UTC (rev 106)
@@ -0,0 +1,102 @@
+# Services Hosted On Savannah Servers
+
+The following is the list of public servers, organized by the VM they run on.
+
+When restarting/reload/reboot a service or a VM, please check the following
+services are working as expected.
+
+See also:
+
+- [[SavannahArchitecture]]
+- [[GnuArchitecture]]
+
+## Frontend
+
+The `frontend.sv.gnu.org` VM runs the Savannah website (the PHP code).
+
+- Main page: <http://savannah.gnu.org> and <http://savannah.nongnu.org>
+- SSL Access: <https://savannah.gnu.org> and <https://savannah.nongnu.org>
+  using the SSL certificate in `frontend:/etc/ssl/private/2014/`.
+- PHP code runs defined in `frontend:/etc/apache2/sites-available/sv.inc`,
+  stored in `frontend:/var/www/savane/frontend/php/` .
+- PHP source code available in 
<http://savannah.gnu.org/projects/administration> .
+
+
+## VCS
+
+The `vcs` VM holds the source code and web-pages repositories
+(cvs,svn,arch,br,hg,git) providing various access methods.
+
+- Web Access:
+    - csv (the CVS **Source Code** repositories, not the web repositories)
+        - Apache config file: `vcs:/etc/apache2/sites-available/cvs`
+        - static welcome page: <http://cvs.savannah.gnu.org/>
+        - ViewVC CGI: <http://cvs.savannah.gnu.org/viewvc/>
+    - svn
+        - Apache config file: `vcs:/etc/apache2/sites-available/svn`
+        - static welcome page: <http://svn.savannah.gnu.org/>
+        - ViewVC CGI: <http://svn.savannah.gnu.org/viewvc/>
+    - bzr
+        - Apache config file: `vcs:/etc/apache2/sites-available/bzr`
+        - static welcome page: <http://bzr.savannah.gnu.org/>
+        - BZR CGI Viewer: <http://bzr.savannah.gnu.org/lh/>
+    - hg
+        - Apache config file: `vcs:/etc/apache2/sites-available/hg`
+        - static welcome page: <http://hg.savannah.gnu.org/>
+        - HGWEB Viewer: <http://hg.savannah.gnu.org/hgweb/>
+    - git
+        - Apache config file: `vcs:/etc/apache2/sites-available/git`
+        - static welcome page: <http://git.savannah.gnu.org/>
+        - CGIT viewer: <http://git.savannah.gnu.org/cgit/>
+        - WebGit viwer: <http://git.savannah.gnu.org/gitweb/>
+    - webcvs (the CVS web-pages repositories, propagated to `www.gnu.org` and
+      `www.nongnu.org`)
+        - Apache config file: same as `cvs` (above)
+        - static welcome page: <http://web.cvs.savannah.gnu.org/>
+        - ViewVC: <http://web.cvs.savannah.gnu.org/viewvc/>
+    - WebGit (experimental):
+        - Apache config file: `vcs:/etc/apache2/sites-available/webgit`
+        - static welcome page: <http://web.git.savannah.gnu.org/>
+        - CGIT viewer: <http://web.git.savannah.gnu.org/cgit/>
+        - WebGit viwer: <http://web.git.savannah.gnu.org/gitweb/>
+
+- SSH: SSH is used for read/write access to the repositories.  
+    Logging-in with SSH and the Savannah user requires setting-up a public SSH
+    key through the Savannah web interface. Upon login, the is user's key is
+    checked against the Savannah MySQL database, using the `AuthorizedKeysExec`
+    command defined in `vcs:/etc/ssh/sshd_config`.
+
+    The repositories access methods are:
+    - cvs: `cvs -z3 -d:ext:<USER>@cvs.savannah.nongnu.org:/sources/<PROJECT> 
co <modulename>`
+    - svn: `svn co 
svn+ssh://<USER>@svn.savannah.gnu.org/<PROJECT>/<modulename>`
+    - bzr: `bzr branch 
bzr+ssh://<USER>@bzr.savannah.nongnu.org/<PROJECT>/branch`
+    - hg:  `hg clone ssh://<USER>@hg.sv.gnu.org/<PROJECT>`
+    - webcvs: `cvs -z3 -d:ext:<USER>@cvs.savannah.nongnu.org:/web/<PROJECT> co 
<PROJECT>`
+    - git: `git clone <USER>@git.sv.gnu.org:/srv/git/<PROJECT>.git`
+
+- RSYNC - provides read-only anonymous access to the raw repository files.
+    configuration in `vcs:/etc/rsync.conf`, started with `xinetd` in
+    `vcs:/etc/xinetd.d/rsync`.
+    - cvs: `rsync://svn.savannah.gnu.org/sources/<PROJECT>`
+    - svn: `rsync://svn.savannah.gnu.org/svn/<PROJECT>`
+    - git: `rsync://svn.savannah.gnu.org/git/<PROJECT>`
+    - bzr: `rsync://svn.savannah.gnu.org/bzr/<PROJECT>`
+    - webcvs: `rsync://svn.savannah.gnu.org/web/<PROJECT>`
+    - hg: not defined.
+
+- Git-Daemon - provides read-only anonymous access to git repositories.
+    configured with `xinetd` in `vcs:/etc/xinetd.d/git`.
+    - usage: `git clone git://git.savannah.gnu.org/<PROJECT>.git`
+
+- CVS Pserver - provides read-only anonymous access to CVS repositories.
+    configured with `xinetd` in `vcs:/etc/xinetd.d/cvs`.
+    - cvs: `cvs -z3 -d:pserver:address@hidden:/sources/<PROJECT> co 
<modulename>`
+    - webcvs: `cvs -z3 -d:pserver:address@hidden:/web/<PROJECT> co 
<modulename>`
+
+- SVN Daemon - provides read-only anonymous access to SVN repositories.
+    configured with `xinetd` in `vcs:/etc/xinetd.d/svn`.
+    - svn: `svn co svn://svn.savannah.gnu.org/texinfo/modulename`
+
+- BZR-Daemon - provides read-only anonumous access to BZR repositories.
+    configured with `xinetd` in `vcs:/etc/xinetd.d/bzr-hpss`.
+    - bzr: `bzr branch bzr://bzr.savannah.nongnu.org/gnewsense/branch`