Mercurial auf einem Debian mit PAM-Authentifizierung mit HTTP/HTTPS-Zugriff installieren

zuerst muss der Rechner mit fester IP konfiguriert werden.
Die DNS-Auflösung im Netz muss stimmen. Evt. muss der Rechner manuell auf dem DNS-Server eingetragen werden.
Die Uhrzeit muss per ntpd konfiguriert werden. siehe dazu ntp
Auf dem Rechner muss der Apache2 mit HTTPS installiert werden. siehe dazu Apache2
Die Softwarepakete mercurial, libapache2-mod-auth-pam, libapache2-mod-auth-sys-group müssen installiert werden:

apt-get install mercurial apache2 libapache2-mod-auth-pam libapache2-mod-auth-sys-group

Es muss ein Datenverzeichnis für Mercurial bestimmt werden (z.B. /daten/hg):

mkdir -p /daten/hg/meinCode

Jetzt wird ein Repository erstellt:

cd /daten/hg/meinCode ; hg init

Dem Apachebenutzer muss der Zugriff auf dieses Verzeichnis erlaubt werden.

chown -R www-data:www-data /daten/hg

jetzt wird eine Testdatei im repo erstellt:

echo "meine erste mercurialdatei" >blabla.txt
hg add blabla.txt
hg commit -Am "first commit" -u benutzername

Jetzt wird die Datei /etc/apache2/conf/hg.conf erstellt und dann wie folgt konfiguriert:

hg.conf
##configdatei für mercurial / borwinius
ScriptAlias /hg/meinCode /usr/lib/cgi-bin/hgweb.cgi
<Directory /hg/meinCode>
  AuthType Basic
  AuthPAM_Enabled on
  AuthName "Mercurial Repository meinCode erfordert eine Anmeldung"
  AuthUserFile /dev/null
  AuthPAM_FallThrough On
  AuthBasicAuthoritative Off
  AuthGroup_Enabled On
  #Require valid-user
  Require group meineNTGruppe
</Directory>

jetzt wird die Datei /usr/share/doc/mercurial/examples/hgweb.cgi in das normale cgi-bin-Verzeichnis kopiert.

cp /usr/share/doc/mercurial/examples/hgweb.cgi /usr/lib/cgi-bin/

Diese Datei (/usr/lib/cgi-bin/hgweb.cgi) wird jetzt wie folgt editiert:

hgweb.cgi
#!/usr/bin/env python
#
# An example CGI script to use hgweb, edit as necessary
# adjust python path if not a system-wide install:
#import sys
#sys.path.insert(0, "/path/to/python/lib")
 
# enable importing on demand to reduce startup time
from mercurial import demandimport; demandimport.enable()
 
# Uncomment to send python tracebacks to the browser if an error occurs:
#import cgitb
#cgitb.enable()
 
# If you'd like to serve pages with UTF-8 instead of your default
# locale charset, you can do so by uncommenting the following lines.
# Note that this will cause your .hgrc files to be interpreted in
# UTF-8 and all your repo files to be displayed using UTF-8.
#
#import os
#os.environ["HGENCODING"] = "UTF-8"
 
from mercurial.hgweb.hgweb_mod import hgweb
import mercurial.hgweb.wsgicgi as wsgicgi
 
application = hgweb("/daten/hg/meinCode", "meinCode")
wsgicgi.launch(application)

Jetzt muss die Datei hgweb.cgi für den Apache ausführbar gemacht werden:

chmod 770 /usr/lib/cgi-bin/hgweb.cgi

Jetzt muss der Apachedienst neu gestartet werden:

/etc/init.d/apache2 restart

Jetzt kann schon von einem anderen mercurialclient das repo heruntergeladen werden:

hg clone https://meinhgserver/hg/meinCode meinCode
user: meinNTAccount
password: meinNTPasswort

Auf dem Client wurde jetzt das Verzeichnis „meinCode“ mit der Datei „blabla.txt“ erstellt.
Um auch Dateien oder Änderungen auf den Server hochladen (pushen) zu können,
muss die Datei /daten/hg/meinCode/.hg/hgrc erstellt und wie folgt konfiguriert werden:

hgrc
[web]
allow_push = *
push_ssl = true
[paths]
default = /daten/hg/meinCode

Danach sollte der apache neu reloaded werden.
fertig.

Ein Repo hinter einem Proxyserver auschecken:

Bitte exportieren Sie die Umgebungsvariablen wie folgt:

export http-proxy-host = proxysrv:8080
export http-proxy-username = domaenenuser
export http-proxy-password = dasDomänenpasswort

anschließend versuchen Sie, das repo erneut auszuchecken:

hg clone http://meinentfernterServer/hg/meinCode meinCode


Lese- und Schreibzugriff auf ein Repository konfigurieren:
die Benutzer müssen sich zunächst einmal am Apache authentifiziert haben, danach werden zusätzliche Reporechte so vergeben:
die Datei im Repo .hg/hgrc muss etwa wie folgt editiert werden:

...
[web]
allow_push = user1,user2
allow_read = user1,user2,user3,user4
#
#allow_pull funktionierte nicht bei mir
#analog gibt es auch noch:
#deny_push =
#deny_read =
...