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 die3in[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.