Zum Hauptinhalt springen

Beispiel: mehrere Pakete in einem Repository

Beispiel: mehrere Pakete in einem Repository

Quayside hält drei Pakete in einem Repository, quayside/platform: eine API, ein Web-Frontend und ein Kommandozeilenwerkzeug. Jedes Paket hat seine eigene Version und sein eigenes Publikum: Wer die API nutzt, muss nichts von einem neuen Web-Release hören.

So arbeitet das Team

Jedes Paket wird für sich veröffentlicht, mit einem Tag, der Paket und Version nennt: [email protected], [email protected], [email protected]. Ein Release auf GitHub trägt die Notes dieses einen Pakets. Manchmal erscheinen zwei oder drei Pakete innerhalb weniger Minuten.

Was auf GitHub entsteht

Releases in einem Repository, deren Tags mit dem Namen eines Pakets beginnen. Für Chronik.io sind es alles Releases von quayside/platform; nur der Name des Tags unterscheidet die Pakete, und genau darauf schauen die Muster einer Regel.

Eine Regel je Paket

Leg für jedes Paket eine Regel an, alle für dasselbe Repository:

API Web CLI
Welcher Kanal? #api-releases #web-releases #cli-releases
Nur Tags, die passen auf api@* web@* cli@*

Die übrigen Schalter wie in Beispiel: Versionen aus main: Veröffentlichte Releases an, Gepushte Tags aus, Vorabversionen einschließen aus.

* steht für eine beliebige Folge von Zeichen, also passt api@* auf [email protected] und auf [email protected], aber auf nichts von den beiden anderen Paketen. Groß- und Kleinschreibung zählen: api@* passt nicht auf [email protected].

Ein Kanal für alle

Sollen alle drei nach #platform-releases, reicht eine einzige Regel: Nur Tags, die passen auf bleibt leer, und jedes Release des Repositorys kommt durch. Außer Tags, die passen auf nimmt heraus, was dort nicht hingehört, cli@* zum Beispiel, wenn das Kommandozeilenwerkzeug woanders angekündigt wird.

Erscheinen die Pakete zusammen, lässt Mehrere Releases kurz nacheinander zu einer Nachricht bündeln (nur Slack) sie als eine Nachricht ankommen, die jedes Release aufzählt, statt drei Nachrichten innerhalb einer Minute. Nach jedem Release wartet die Regel zehn Minuten auf das nächste, insgesamt höchstens eine Stunde.

Was im Kanal ankommt

Jeder Kanal bekommt die Releases seines Pakets, mit ihren Notes. Ein Release, auf das keine Regel passt, wird übergangen, ohne Nachricht und ohne Eintrag im Zustellprotokoll: In einem Repository mit drei gefilterten Regeln übergehen zwei von ihnen jedes Release, und ein Protokoll davon würde nichts sagen.

Was schiefgehen kann

  • Eine Vorabversion eines Pakets bleibt draußen, solange Vorabversionen einschließen aus ist. Ein Tag ist eine Vorabversion, wenn direkt auf seine Versionsnummer eine Markierung folgt, [email protected] zum Beispiel, und ein Release, wenn der Haken für die Vorabversion auf GitHub gesetzt ist. Eine Ziffer im Namen eines Pakets, wie die 3 in [email protected], zählt nicht als Versionsnummer.
  • Ein neues Paket erreicht keine der gefilterten Regeln, bis jemand eine Regel dafür anlegt, und nichts sagt das an. Letzte Releases und Tags zeigen unter den Mustern einer Regel zeigt, welche der letzten Releases eine Regel auslassen würde.