Wie man auf dem Main-Repository Server committet

From Paldo

Jump to: navigation, search

Contents

[edit] Über das Tutorial

Dieses Tutorial ist für unsere Maintainer gedacht. Ich erkläre Euch, wie Ihr auf unserem Server Eure Pakete committen könnt. Lest Euch das Tutorial durch und befolgt es auch.

[edit] Regeln

Ihr dürft nur neue Pakete, die sich nicht in dem Meta-Package "paldo" befinden, committen. Dies geschieht NUR in den Branches testing/unstable. Um zu überprüfen, ob sich Euer Paket in dem Meta-Package "paldo" befindet könnt Ihr mit durch suchen des Paketes auf unserer Homepage herausfinden. Klickt auf "Show all dependencies" um alle Abhängigkeiten angezeigt zu bekommen.

Falls Ihr trotzdem eines der Pakete updaten wollt, ladet Sie zuvor auf Eure Homefolder-Repository hoch und weist Jürg oder Rasa per E-Mail darauf hin: info_at_paldo.org ("SVN diff"-Patches erstellen) Ggf. dürft Ihr Euer Paket nach Absprache committen.

[edit] Account

Ihr bekommt von Jürg/Raffaele ggf. einen Account um auf die Main-Repository committen zu dürfen.

[edit] Pfade

  • ssh://paldo.org/srv/paldo/sources
  • svn co svn://paldo.org/paldo/trunk/specs

[edit] Vorgehensweise

[edit] Source-Tarballs

Die Tarballs werden in den Ordner "ssh://paldo.org/srv/paldo/sources" abgelegt. Ausserdem müssen sie im tar.bz2-Archiv vorliegen. Ihr könnt dies in der Terminal mit folgendem Befehl erreichen:

  scp pfadaufdeinempczumrepo/sources/paketname/tarballname.tar.bz2 deinBenutzername@paldo.org:/srv/paldo/sources/paketname

Beispiel:

  scp ~/repo/sources/foo/foo-1.0.tar.bz2 deinBenutzername@paldo.org:/srv/paldo/sources/foo

[edit] Specs

Specs werden NUR LOKAL bearbeitet und in die SVN geschrieben! Hierzu öffnet eine Terminal und holt Euch die aktuelle svn der Specs mit folgendem Befehl:

  svn co svn://paldo.org/paldo/trunk/specs specs-svn

Nun könnt Ihr Eure veränderten Specs in den Ordner "specs-svn" kopieren. Wechselt in der Terminal in den Ordner "specs-svn" mit "cd specs-svn" Mit dem Befehl "svn st" werden Euch die geänderten Specs angezeigt. "svn diff" zeigt die Veränderungen im Detail an.

Falls Ihr neue Pakete der Repository hinzufügen wollt müsst Ihr die Spec mit folgendem Befehl der Repository hinzufügen:

  svn add foo.xml

Mit "svn st" überprüft Ihr die Veränderung.

Falls Ihr nur ein existierendes Paket updated, könnt Ihr diese zwei Schritte weglassen.

Um den Vorgang abzuschließen gebt Ihr den Befehl "svn commit" in die Terminal ein. Das Programm "VI" öffnet sich. Nun müsst Ihr einen Kommentar abgeben (unbedingt in Englisch), was Ihr an der SVN verändert habt. Das Format ist folgendermaßen:

  * Paketname-Version-Revision: ggf. persönlicher Kommentar

Beispiel:

  * foo-1.0-1: neues Testpaket

Drückt als erstes die Taste "i". Nun seit Ihr im Editier-Modus. Schreibt Eure(n) Kommentar(e) in englisch. Drückt danach die Taste "ESC" um den Editier-Modus zu verlassen. Mit dem Befehl ":wq" beendet Ihr VI.

Eure Datei wird nach eingabe Eures Account-Passwortes hochgeladen.

Mit dem Befehl "svn up" updated Ihr eure lokale SVN-Specs auf den neusten Stand. Mit dem Befehl "svn log | less" könnt Ihr nachlesen, welche Veränderungen/Updates es in der SVN gibt.

[edit] "SVN diff"-Patches

Für Specs die in den Meta-Specs "paldo" und "paldo-base" enthalten sind benötigt Ihr erst die Erlaubnis zum Committen von Jürg oder Rasa.

Nachdem Ihr Eure neuen/geänderten Specs der lokalen SVN hinzugefügt habt prüft bitte Euere Veränderungen wie gehabt mit "svn st". Durch ein "svn diff > ~/specs.changes" werden Eure Veränderung in die Datei "~/specs.changes" gespeichert. Sendet diese zur Überprüfung an Jürg oder Rasa (info_at_paldo.org).

Bei Erlaubnis dürft Ihr diese Pakete der Haupt-Repository hinzufügen. Fügt Eurem Kommentar hinzu von wem Ihr die Erlaubnis bekommen hattet.

[edit] Die Log des Build-Servers verfolgen

Es ist gut sich die Log des Build-Server anzusehen. Es könnten ja trotz Eurer Überprüfungen Eurer Pakete Fehler auftreten. Hierzu öffnet Nautilus und connected Euch auf den Server. Öffnet nun eine Terminal mit Maus-Rechtsklick auf eine freie Fläche > "Im Terminal öffnen". Gebt nochmal Euer Server-Passwort ein. Mit folgendem Befehl könnt Ihr die Log des Build-Servers verfolgen:

   tail -f /paldo-x86/var/log/upkg-buildd/upkg-buildd.log /paldo-x86/var/log/upkg/upkg.log

Tutorial by Müller Philip (aka Amnon82) - 23.09.2007

Personal tools