Die Webkonsole

Die Webkonsole ist die Browseroberfläche von Arkvory. Sie ist Teil des Servers, Sie installieren sie also nicht separat. Öffnen Sie /console/ unter Ihrer Serveradresse, zum Beispiel http://127.0.0.1:8080/console/ auf dem Server selbst oder https://arkvory.example/console/, nachdem Sie HTTPS eingerichtet haben.

Die Konsole verwendet dieselbe HTTP-API wie der Kommandozeilen-Client und das SDK. Der Server prüft jede Anfrage. Ist eine Schaltfläche ausgeblendet, bedeutet das nur, dass Ihr Konto oder Ihr Schlüssel diesen Vorgang nicht verwenden kann.

Aufbau

Die Seitenleiste gruppiert die Bereiche. Auf einem schmalen Bildschirm wird die Seitenleiste zur Schaltfläche Bereiche.

Gruppe	Bereiche
Bibliothek	Artefakte, Pakete, Dateiverlauf, Artefaktdetails
Übertragungen	Upload, Downloads
Ressourcen	Benutzer und Zugriff, Repositorys, Dienstzugriff, Updates, Backups, Erste Schritte, API & CLI

Die obere Leiste zeigt den Titel des Bereichs, die Schaltflächen Datei hochladen und Feedback sowie die Steuerelemente für Darstellung und Sprache.

Jeder Bereich hat eine eigene Adresse, zum Beispiel #/catalog, #/packages oder #/backups. Ein geöffnetes Artefakt hat die Adresse #/artifact/<repository>/<id>. Sie können diese Adressen als Lesezeichen speichern und an andere weitergeben. Die Adresse enthält nie ein Passwort, einen Schlüssel oder einen Suchtext. Öffnen Sie einen Link, bevor Sie angemeldet sind, öffnet die Konsole ihn nach der Anmeldung.

Einige Bereiche erscheinen nur für bestimmte Benutzer:

Bereich	Wer ihn sieht
Benutzer und Zugriff	Administratoren
Repositorys	Alle angemeldeten Benutzer
Dienstzugriff	Der Wiederherstellungsschlüssel und Operator-Schlüssel mit delegierten Rechten
Updates	Administratoren
Backups	Administratoren und der Wiederherstellungsschlüssel

Anmelden

Die Karte Repository-Verbindung befindet sich oben auf der Seite.

1. Füllen Sie die Felder Benutzername und Passwort aus.
2. Wählen Sie Anmelden. Eine Sitzung dauert 12 Stunden.
3. Die Konsole wählt im Feld Repository das erste Repository, das Sie lesen dürfen. Um in einem anderen Repository zu arbeiten, geben Sie seinen Namen ein oder wählen Sie es aus der Liste.

Um sich statt mit einem Passwort mit einem Schlüssel zu verbinden, öffnen Sie Mit einem Dienst- oder Automatisierungsschlüssel verbinden, fügen Sie den Schlüssel ein und wählen Sie Verbinden. Der Schlüssel bleibt im Speicher dieses Browser-Tabs. Die Konsole speichert ihn nie.

Die Schaltfläche Registrieren erscheint nur, wenn der Administrator die Selbstregistrierung erlaubt. Mit Trennen beenden Sie die Verbindung.

Nach der Anmeldung mit einem Passwort können Sie Mein Passwort ändern und Persönliche Zugriffstoken nutzen. Ein persönliches Zugriffstoken ist ein Schlüssel für Ihre eigenen Tools. Siehe Konten und Zugriff.

Der erste Besitzer

Eine neue Installation hat keine Konten. Unter Windows erstellt das Setup den Besitzer. Bei anderen Installationen erstellen Sie den Besitzer in der Konsole:

1. Öffnen Sie Erste Schritte und erweitern Sie Ersten Besitzer erstellen.
2. Fügen Sie den Wiederherstellungsschlüssel aus config/bootstrap-token.txt im Installationsverzeichnis ein.
3. Geben Sie einen Namen und ein Passwort mit mindestens 12 Zeichen ein und wählen Sie dann Besitzer erstellen.
4. Melden Sie sich mit dem neuen Namen und Passwort an.

Das Formular funktioniert nur, solange es keine Konten gibt. Der Besitzer ist ein Administrator. Außerdem erhält der Besitzer über die Gruppe arkvory-owners Schreibzugriff auf das Repository releases.

Bibliothek

Artefakte

Der Bereich Artefakte listet die veröffentlichten Dateien des Repositorys auf. Suchen Sie nach dem Namen oder nach einem Metadatenwert. Mit Nach Label filtern zeigen Sie ein einzelnes Label an, mit Exakte Metadaten einen exakten Schlüssel mit Wert. Jede Zeile zeigt Name, Größe, Veröffentlichungszeit, Stufen und Labels. Wählen Sie Herunterladen, um eine Datei herunterzuladen, oder Öffnen, um ihre Details zu sehen. Mehr laden zeigt die nächste Seite.

Pakete

Der Bereich Pakete listet registrierte UPack-Versionen auf. Filtern Sie nach UPack-Gruppe und Paketname, legen Sie Sortieren nach und Gruppieren nach fest und wählen Sie dann Anwenden. Die Stufenspalte zeigt, wohin jede Version hochgestuft wurde. Siehe Pakete.

Dateiverlauf

Ein Dateipfad wie builds/game/1.4/GameSetup.exe kann viele Male auf neuen Inhalt verweisen. Jede Änderung ist eine neue Version. Geben Sie in Dateiverlauf einen Pfad ein und wählen Sie Verlauf laden. Sie sehen jede Version mit Autor und Zeit. Sie können jede Version öffnen, um ihren ursprünglichen Inhalt herunterzuladen. Das Wiederherstellen einer alten Version erzeugt eine neue Version; es wird nichts gelöscht. Siehe Dateien und Pfade.

Artefaktdetails

Der Bereich Artefaktdetails zeigt ein einzelnes Artefakt:

• Übersicht: Größe, Hochgeladen und SHA-256 mit der Schaltfläche Kopieren.
• Eigenschaften: Labels, Sammlungen und Build-Metadaten. Wählen Sie Änderungen speichern, um sie zu speichern. Die Datei selbst ändert sich nicht.
• Aktionen: Herunterladen; Download-Link erstellt einen Link, der eine Stunde lang ohne Schlüssel funktioniert; UPack registrieren indiziert ein UPack-Archiv.
• Dateiverknüpfung: Datei zuweisen macht dieses Artefakt zum aktuellen Inhalt eines Dateipfads.
• Hochstufung: Stufe hinzufügen markiert das Artefakt mit einer Stufe, etwa qa oder release. Hochstufen veröffentlicht es in einem anderen Repository. Siehe Hochstufung.
• Manifeste & weitere Dateien: Anhang hinzufügen verknüpft ein Manifest, ein SBOM, eine Signatur, einen Bericht oder eine andere Datei mit diesem Build. Verlauf der Anhänge zeigt frühere Stände.
• Artefakt löschen: Abhängigkeiten prüfen zeigt, was das Artefakt noch verwendet. Zum Löschen fügen Sie die Artefakt-ID ein und wählen Dieses Artefakt löschen. Das Löschen erfordert einen Dienstschlüssel mit der Aktion artifact.delete; eine Anmeldung mit Passwort, ein persönliches Token und der Wiederherstellungsschlüssel können nicht löschen.

Übertragungen

Upload

Wählen Sie in Upload eine Datei aus und dann Hochladen / fortsetzen. Die Konsole berechnet zuerst den SHA-256-Wert der Datei und sendet sie dann in Teilen. Mit Pausieren halten Sie die Übertragung an; die bereits hochgeladenen Teile bleiben erhalten.

Um später fortzufahren, bewahren Sie die Upload-ID auf. Öffnen Sie Upload fortsetzen, wählen Sie dieselbe Datei und geben Sie die Upload-ID ein. Der Browser warnt Sie, bevor Sie die Seite während eines Uploads verlassen. Siehe Übertragungen.

Downloads

Downloads ist eine Warteschlange der Dateien, die Sie aus der Konsole herunterladen. Die Konsole prüft den SHA-256-Wert jeder Datei, bevor sie die endgültige Datei speichert.

• Einstellungen der Warteschlange legt Parallele Downloads (1 bis 8), Startabstand, ms und Max. Wartezeit, Sekunden fest.
• Alle pausieren, Warteschlange fortsetzen, Wartende abbrechen, Alle abbrechen und Fertige entfernen steuern die gesamte Warteschlange.
• Melden Sie sich nach dem Neuladen der Seite erneut an und wählen Sie Warteschlange wiederherstellen. Setzen Sie dann jede Datei fort und wählen Sie, wo sie gespeichert werden soll.

Große Downloads erfordern Chrome oder Edge auf einer sicheren Adresse (HTTPS oder der lokale Rechner). Temporäre Daten bleiben im privaten Speicher des Browsers.

Ressourcen

Benutzer und Zugriff

Hier verwalten Administratoren Personen. Konten listet die Konten auf, Gruppen und Berechtigungen die Gruppen. Verwenden Sie Benutzer erstellen, Passwort zurücksetzen, Gruppe erstellen und Gruppenmitglieder verwalten. Geben Sie in Repository-Zugriff verwalten einer Gruppe den Zugriff Lesen oder Lesen und Schreiben auf ein Repository, das Sie mit seinem Namen angeben. Ein Repository wird nicht in einem eigenen Schritt erstellt: Es existiert, sobald eine Berechtigung oder eine Dienstrichtlinie seinen Namen nennt.

Repositorys

Repositorys zeigt die Repositorys, die Sie sehen können, mit Ihre Berechtigungen. Jede Karte bietet Dateien öffnen, Speicher & Bereinigung (Kontingent, automatische Bereinigung und physische Bereinigung; erfordert einen Dienstschlüssel mit den Aktionen storage.read oder storage.manage) und für Administratoren Zugriff verwalten. Ein gespiegeltes Repository zeigt das Badge Spiegel. Siehe Repositorys und Speicher.

Dienstzugriff

Hier erstellen Sie Konten für Tools und CI-Systeme. Um diesen Bereich zu sehen, verbinden Sie sich mit dem Wiederherstellungsschlüssel oder mit einem Operator-Schlüssel. Wählen Sie Dienstkonto erstellen und legen Sie dann Repository-Berechtigungen fest. Vorlage: Lesen und Vorlage: Veröffentlichen füllen typische Berechtigungssätze aus.

Um einen Schlüssel auszustellen, öffnen Sie Dienstschlüssel und wählen Sie Schlüssel ausstellen. Das Geheimnis wird nur einmal angezeigt. Kopieren Sie es, bestätigen Sie Ich habe das Geheimnis gespeichert und wählen Sie Schlüssel aktivieren. Ein Schlüssel, der nicht aktiviert wird, läuft nach 15 Minuten ab. Mit Rotieren ersetzen Sie einen Schlüssel, mit Widerrufen widerrufen Sie ihn. Mit Delegierte Verwaltung kann der Besitzer einem Operator eingeschränkte Verwaltungsrechte geben.

Updates

Der Bereich Updates zeigt Installierte Version und Neuestes stabiles Release. Wählen Sie Jetzt prüfen oder Update installieren. Aktivieren Sie in Automatische Updates die Option Kompatible stabile Releases automatisch installieren und legen Sie die Wartungsstunde (UTC) fest. Siehe Updates.

Backups

Backups zeigt, ob die Backups in Ordnung sind, das letzte Backup, den nächsten Lauf, den Backup-Agent und den Backup-Speicher. Wählen Sie Jetzt Backup erstellen, um ein Backup zu starten. Wiederherstellungspunkte listet Wiederherstellungspunkte auf; Sie können jedes Byte eines Punkts prüfen oder ihn anheften. Zeitplan und Aufbewahrung legt die tägliche Uhrzeit, die Zeitzone und die Anzahl der aufzubewahrenden Punkte fest. Die Wiederherstellung erfolgt über einen Befehl auf dem Server. Siehe Backups.

Erste Schritte und API-Referenz

Erste Schritte zeigt die ersten Schritte für einen neuen Server. API & CLI listet Beispielbefehle auf. Erlaubte API-Vorgänge laden zeigt die API-Vorgänge, die Ihr aktuelles Konto oder Ihr Schlüssel aufrufen kann.

Feedback

Nach der Anmeldung sendet Feedback eine Nachricht über den Hub an ProAnimaStudio. Sie können bis zu 6 Bilder und eine E-Mail-Adresse für die Antwort hinzufügen. Administratoren können das Serverprotokoll anhängen. Wählen Sie Anhänge anzeigen, um genau zu sehen, was gesendet wird.

Darstellung und Sprache

Darstellung bietet drei Optionen: System, Hell und Dunkel. Sprache listet jede Sprache der Konsole unter ihrem eigenen Namen auf: English, Русский, Español, Français, Deutsch, Português, 中文, 日本語, 한국어, हिन्दी und العربية. Die Seite wechselt sofort, ohne Neuladen und ohne dass Ihre Eingaben verloren gehen; auf Arabisch wird sie von rechts nach links gelesen. Beim ersten Besuch richtet sich die Konsole nach den Sprachen des Browsers und greift sonst auf Englisch zurück. Dokumentation unter API & CLI öffnet diese Dokumentation in der Sprache der Konsole. Der Browser speichert nur das Design und die Sprache, nichts über Ihr Konto oder Ihre Repositorys.

Verwandte Seiten

• Schnellstart
• Konzepte
• Konten und Zugriff
• Fehlerbehebung