Zum Inhalt
Handbuch
Inhalt

Eine Instanz verwalten

Werkzeuge freigeben

Den Entwurf veröffentlichen, ein Werkzeug einer Rolle freigeben, Besitzer eintragen und Fehler einsehen.

Den Stand der Werkzeuge findest du unter Betrieb, Auslieferung. Die Seite heisst Werkzeuge.

Die Seite Werkzeuge mit dem ausgelieferten Stand, dem Entwurf und der Liste der Werkzeuge mit ihren Rollen

Den Stand lesen

Ausgelieferter Stand nennt drei Dinge:

  • Quelle: das Repository, aus dem die Instanz die Werkzeuge ausliefert.
  • Commit: der veröffentlichte Stand. Er ändert sich nur beim Veröffentlichen.
  • Entwurf: der Stand, an dem gerade jemand baut. Ein Entwurf ist unter /t/<tool>@draft/ erreichbar und für die Person sichtbar, die ihn gepusht hat.

Jetzt abgleichen bringt die Auslieferung auf den Stand des Repositorys. Liegt das Repository in der Instanz, gibt es dazu Repository herunterladen und unter An den Werkzeugen arbeiten den Befehl zum Klonen.

Die Tabelle Werkzeuge listet jedes Werkzeug mit Titel und den Rollen mit Grant. kein Grant heisst: Niemand sieht das Werkzeug. es fehlt etwas heisst: Einer Rolle fehlt ein Recht, das das Werkzeug braucht.

Den Entwurf veröffentlichen

Wartet ein Entwurf, steht unter dem Stand der Knopf Entwurf veröffentlichen. Danach läuft der Entwurf als veröffentlichter Stand, für alle, denen das Werkzeug freigegeben ist.

Zwei Dinge halten dich auf:

  • Schemaänderungen warten noch auf die Produktion. Appliziere sie zuerst, siehe Aus dem Übungsraum übertragen. Ein Werkzeug, das sie braucht, bricht sonst.
  • Noch nicht veröffentlichbar: Ein geändertes Werkzeug sagt nicht, was es braucht. Wer es baut, trägt uses in tool.json ein und pusht erneut, siehe Aufbau eines Werkzeugs.

Ein Werkzeug einer Rolle freigeben

Ohne Grant sieht niemand ein Werkzeug, auch du nicht. Öffne das Werkzeug in der Tabelle.

Die Seite eines Werkzeugs mit den Rollen, der Freigabe für eine weitere Rolle, den Fehlern und dem Besitzer
  1. Wähle unter Für eine weitere Rolle freigeben die Rolle und dann Weiter. Freigegeben ist damit noch nichts.
  2. Lies die Vorschau. Sie zeigt für jede Collection, jeden Bucket und jede Fähigkeit, die das Werkzeug nach eigener Angabe benutzt, was die Mitglieder dieser Rolle erreichen: die Stufe für Lesen und Schreiben, oder erteilt und nicht erteilt.
  3. Wähle Für … freigeben mit dem Namen der Rolle.

Die Vorschau warnt und sperrt nicht. Fehlt der Rolle ein Recht, kannst du trotzdem freigeben. Das Werkzeug scheitert dann an dieser Stelle. An der Rolle erteilen führt auf die Seite der Rolle, wo du das fehlende Recht vergibst, siehe Rechte vergeben. Die Vorschau erteilt selbst nichts.

Eine Freigabe nimmst du auf der Seite der Rolle zurück.

Besitzer und Stellvertreter eintragen

Der Besitzer ist die Ansprechperson für ein Werkzeug. Ein Zugriffsrecht ist das nicht.

Öffne auf der Seite des Werkzeugs Besitzer eintragen, wähle Besitzer und, wenn du willst, einen Stellvertreter, und wähle Speichern. Zur Wahl stehen die Administratorinnen und Administratoren. Später heisst derselbe Weg Ändern.

Fehlt der Besitzer bei einem freigegebenen Werkzeug, meldet es die Übersicht unter Auffälligkeiten. Gesperrt ist dadurch nichts.

Bestätigen, dass es das Werkzeug noch braucht

Besitzer oder Stellvertreter bestätigen ein Werkzeug unter Meine Rechte, im Abschnitt Werkzeuge, für die du zuständig bist, mit Bestätigen. Die Seite des Werkzeugs zeigt unter Als nötig bestätigt, wann und von wem. Ist eine Bestätigung fällig, steht das ebenfalls unter Auffälligkeiten.

Fehler eines Werkzeugs einsehen

Die Seite des Werkzeugs zeigt unter Fehler im Browser, was das Werkzeug gemeldet hat: den Fehler, wo er auftrat, wie oft und wann zuletzt. Eine Person nennt der Eintrag nicht.

Hast du die Ursache behoben, wähle Behoben. Tritt der Fehler wieder auf, ist er wieder offen. Die Instanz bewahrt einen Fehler eine begrenzte Zeit nach dem letzten Auftreten auf. Die Frist steht in der Überschrift des Abschnitts.