Glossar
Die Begriffe sind in alphabetischer Reihenfolge aufgeführt. Die Ideen dahinter finden Sie unter Konzepte.
A
Konto
Die Anmeldung einer Person am Server: ein Name mit 3 bis 64 Zeichen und ein Passwort mit 12 bis 128 Zeichen. Gruppen-Gewährungen geben einem Konto Zugriff auf Repositorys. Siehe Konten und Zugriff.
Aktion
Ein genau festgelegtes Recht auf einem Repository, etwa upload.create oder content.read. Dienstschlüssel tragen Aktionen, und die API-Referenz nennt die Aktionen, die jeder Vorgang benötigt. Siehe Authentifizierung.
Administrator
Ein Konto, das Konten, Gruppen, Updates und Backups verwaltet. Ein Administrator liest die Dateien eines Repositorys nur, wenn eine Gruppe ihm diesen Zugriff ebenfalls gewährt. Siehe Konten und Zugriff.
Zulassung
Die Grenze dafür, wie viele Anfragen und Übertragungen der Server gleichzeitig bearbeitet. Darüber wartet eine Übertragung kurz und der Server antwortet mit 503, dem Code busy und einem Retry-After-Header. Siehe Ratenlimits und ausgelastete Server.
Artefakt
Eine unveränderlich gespeicherte Datei mit ihrer SHA-256. Neuer Inhalt erzeugt ein neues Artefakt. Siehe Konzepte.
Anhang
Eine Verknüpfung von einem Build zu einem anderen Artefakt desselben Repositorys: ein Manifest, ein SBOM, eine Signatur, ein Bericht oder eine andere Datei. Ein Build hat bis zu 32 Anhänge. Siehe Konzepte.
B
Backup
Eine geplante Kopie der Datenbank und aller veröffentlichten Inhalte in den Backup-Speicher. Siehe Backups.
Backup-Agent
Der Dienst, der die Kopien erstellt, sie prüft und die Aufbewahrung auf die Wiederherstellungspunkte anwendet. Siehe Backups.
Bearer-Token
Die Art, wie jeder Client einen Nachweis an /api/v1 sendet: der Header Authorization: Bearer <credential>. Siehe Authentifizierung.
Bindung
Ein Eintrag einer Dienstrichtlinie: ein Repository und die darauf erlaubten Aktionen. Eine Richtlinie hat bis zu 64 Bindungen. Siehe Authentifizierung.
Build
Die Ausgabe eines CI-Laufs, gespeichert als Artefakt oder als Paketversion. Siehe Pakete.
C
Katalog
Die Liste der Artefakte in einem Repository mit ihren Namen, Größen, Labels und Stufen. Siehe Artefakt-Referenz.
Obergrenze
Die Grenze einer Delegierung: die Repository-Aktionen, die ein Operator in die Richtlinien und Schlüssel der von ihm verwalteten Konten aufnehmen darf. Der Operator kann seine Obergrenze nicht überschreiten. Siehe Authentifizierung.
Prüfsumme
Die SHA-256, die belegt, dass die Bytes die erwarteten sind. Uploads geben sie an, bevor die Bytes eintreffen, und der Server und die Clients prüfen sie. Siehe Übertragungen.
Bereinigung
Auch physische Bereinigung genannt. Sie gibt den Speicherplatz gelöschter Inhalte im Hintergrund in kleinen Stapeln frei. Siehe Speicher.
Sammlung
Eine benannte Menge von Artefakten. Eine Sammlung ist Teil der Annotationen eines Artefakts. Siehe Konzepte.
Compare-and-Swap
Eine Änderung, die die erwartete Revision nennt, etwa expectedRevision. Kam eine andere Änderung zuvor, antwortet der Server mit 409 und dem Grund revision_mismatch und ändert nichts. Siehe HTTP-API-Überblick.
Abschlussjob
Ein Hintergrundjob des Workers, der einen großen Upload prüft und veröffentlicht. Sie verfolgen ihn mit GET /api/v1/jobs/{id}. Sein Status ist queued, running, completed oder failed. Siehe Upload-Referenz.
Konsole
Die Weboberfläche von Arkvory, bereitgestellt unter /console/. Siehe Die Webkonsole.
CORS
Die Browser-Regel für Seiten, die eine API unter einer anderen Adresse aufrufen. Eine Seite von einem anderen Ursprung funktioniert nur, wenn der Administrator diesen Ursprung in ARKVORY_CORS_ORIGINS auflistet. Siehe Umgebungsvariablen.
Cursor
Der Wert next in einer Ergebnisseite. Senden Sie ihn als after zurück, um die nächste Seite zu lesen; ist next null, ist die Liste vollständig. Siehe HTTP-API-Überblick.
D
Delegierung
Eine Gewährung vom Wiederherstellungsschlüssel an einen Operatorschlüssel: Er darf benannte Dienstkonten mit benannten Verwaltungsaktionen innerhalb einer Obergrenze verwalten. Siehe Authentifizierung.
Digest
Die Inhaltsadresse eines Container-Images, geschrieben sha256:…. Siehe Container-Images.
Download-Link
Ein zeitlich begrenzter Link, der ein Artefakt ohne Schlüssel herunterlädt. Er gilt von 60 Sekunden bis 24 Stunden (standardmäßig 1 Stunde), und niemand kann ihn vor Ablauf widerrufen. Siehe Authentifizierung.
E
ETag
Der Validator eines Downloads: der starke Wert "sha256:<hex>" des Artefakts. Verwenden Sie ihn mit If-Range, um sicher fortzusetzen, und mit If-None-Match, um einen wiederholten Download zu überspringen. Siehe HTTP-API-Überblick.
F
Failover
Clients auf einen Spiegel umschalten, wenn die Quelle verloren geht. Der Operator trennt den Spiegel ab, und er wird zu einem gewöhnlichen Repository, das Änderungen annimmt. Nichts schaltet sich von selbst um. Siehe Spiegel.
Feedback
Ein Bericht mit Screenshots und Protokollen, den ein angemeldeter Benutzer aus der Konsole an ProAnimaStudio sendet. Die Konsole zeigt, was angehängt ist, bevor sie etwas sendet. Siehe Die Webkonsole.
Datei nach Pfad
Eine Datei, die über einen Pfad im Repository angesprochen wird, etwa builds/game/Setup.exe, und ihre früheren Revisionen behält. Siehe Dateien und Pfade.
Dateischlüssel
Ein Geheimnis, dessen SHA-256 in der Schlüsseldatei des Servers (ARKVORY_KEYS_FILE) aufgeführt ist. Der Wiederherstellungsschlüssel ist ein Dateischlüssel. Siehe Authentifizierung.
G
Karenzzeit
Die Zeit, die gelöschter Inhalt auf dem Datenträger bleibt, bevor die Bereinigung ihn entfernt: standardmäßig 24 Stunden. Siehe Speicher.
Gruppe
Eine Menge von Konten, die sich den Repository-Zugriff teilen. Eine Gruppe erhält pro Repository read- oder write-Zugriff („Lesen und Schreiben"). Siehe Konten und Zugriff.
H
Verlauf
Die früheren Revisionen einer Datei nach Pfad oder einer Anhangsmenge. Siehe Dateien und Pfade.
Hub
Der ProAnimaStudio-Dienst unter https://hub.proanima.net, der stabile Releases ankündigt und Feedback entgegennimmt. Siehe Updates.
I
Idempotenzschlüssel
Der Header Idempotency-Key: ein Wert mit 1 bis 128 Zeichen, der eine wiederholte Anfrage nur einmal wirksam werden lässt. Siehe HTTP-API-Überblick.
Image
Ein Container-Image, das in der integrierten Registry gespeichert ist. Siehe Container-Images.
Installationsverzeichnis
Der Ordner mit den Daten, der Konfiguration und den Protokollen: C:\ProgramData\ProAnima\Arkvory unter Windows und /opt/proanima-arkvory unter Linux. Siehe Installation wählen.
L
Label
Ein kurzes Etikett an einem Artefakt, etwa nightly oder tested. Ein Artefakt hat bis zu 32 Labels. Siehe Konzepte.
Lease
Ein Anspruch, den ein Prozess für kurze Zeit hält und erneuern muss, damit nur ein Prozess einen Job ausführt. Der Backup-Agent hält standardmäßig eine Lease von 60 Sekunden, sodass nie zwei Agents gleichzeitig laufen. Siehe Umgebungsvariablen.
Lebendigkeit
Die Antwort von GET /health/live: Der Prozess läuft. Sie ist öffentlich. Siehe System-Referenz.
Sperre
Eine Git-LFS-Dateisperre, die zwei Personen daran hindert, dieselbe Binärdatei zu ändern. Siehe Git LFS.
M
Wartungsstunde
Die Stunde des Tages in UTC, in der automatische Updates installiert werden dürfen. Der Standard ist 03:00. Siehe Updates.
Metadaten
Textfelder eines Artefakts als Schlüssel/Wert: bis zu 32 Felder mit Werten bis zu 1.024 Zeichen. Siehe Konzepte.
Spiegel
Eine schreibgeschützte Kopie eines Repositorys, die eine zweite Installation pflegt, indem sie der Quelle folgt. Siehe Spiegel.
Spiegelquelle
Die Installation, von der ein Spiegel kopiert. Der Spiegel meldet sich dort mit einem schreibgeschützten Schlüssel an. Siehe Spiegel.
Verschieben
Eine Hochstufung, die den Build zusätzlich aus dem Quell-Repository entfernt. Siehe Hochstufung.
O
Erste Schritte
Die ersten Schritte nach der Installation, angezeigt in der Konsole im Abschnitt „Erste Schritte". Siehe Schnellstart.
OpenAPI
Die maschinenlesbare Beschreibung der HTTP-API, bereitgestellt unter /api/v1/openapi.json. Siehe HTTP-API-Überblick.
Besitzer
Das erste Konto, das während der Installation erstellt wird. Es ist Administrator und Mitglied der Gruppe arkvory-owners, die in releases schreiben darf. Siehe Konzepte.
P
Paket
Ein versioniertes UPack-Paket mit einer Gruppe, einem Namen und einer SemVer-Version. Siehe Pakete.
Paketgruppe
Der erste Teil des Namens eines Pakets. Pakete mit demselben Namen in verschiedenen Gruppen sind verschiedene Pakete. Siehe Pakete.
Teil
Ein Stück einer großen Datei, das als eigene Anfrage gesendet wird. Ein Teil ist mindestens 8 MiB groß, außer dem letzten, und höchstens 1 GiB. Siehe Übertragungen.
Berechtigung
Das Recht, eine Aktion auszuführen. Personen erhalten read oder write über Gruppen; Dienstschlüssel erhalten exakte Aktionen. Siehe Authentifizierung.
Persönliches Zugriffstoken
Das Geheimnis einer Person für Skripte und die Kommandozeile. Es beginnt mit pat_, läuft standardmäßig nach 90 Tagen ab (höchstens 365) und ist entweder schreibgeschützt oder lesend und schreibend. Siehe Authentifizierung.
Anheften
Etwas vor dem automatischen Löschen bewahren, etwa einen Wiederherstellungspunkt. Siehe Backups.
Richtlinie
Die gespeicherten Regeln eines Dienstkontos (seine Bindungen), eines Repositorys (seine Speicherrichtlinie) oder des Backup-Plans. Siehe Authentifizierung.
Hochstufen
Das Verb der Hochstufung: einen Build in einem anderen Repository veröffentlichen oder ihn mit einer Stufe markieren. Siehe Hochstufung.
Hochstufung
Einen Build in einem anderen Repository veröffentlichen, ohne ihn erneut hochzuladen. Siehe Hochstufung.
Q
Kontingent
Der meiste Speicherplatz, den ein Repository verwenden darf. Ein neuer Upload, der ihn überschreiten würde, wird mit 507 und dem Grund storage_quota abgelehnt. Siehe Speicher.
R
Range
Der HTTP-Header Range: bytes=start-end, der nach einem Teil einer Datei fragt. Downloads unterstützen einen Range pro Anfrage, was zum Fortsetzen nötig ist. Siehe HTTP-API-Überblick.
Ratenlimit
Eine Grenze dafür, wie oft etwas versucht werden darf. Arkvory begrenzt Anmelde-, Registrierungs-, Passwort- und Feedback-Versuche und antwortet mit 429 und Retry-After. Siehe Authentifizierung.
Lese-Gateway
Ein zusätzlicher reiner Download-API-Prozess auf demselben Speicher. Er beantwortet GET und HEAD und lehnt Änderungen mit 405 ab. Siehe Lese-Gateways.
Bereitschaft
Ob der Server seine Arbeit erledigen kann. GET /health/status ist öffentlich und antwortet mit {"status":"ready"} oder unavailable; GET /health/ready benötigt einen Nachweis und liefert Details. Siehe System-Referenz.
Wiederherstellungsschlüssel
Auch Bootstrap-Schlüssel genannt. Das Geheimnis der Installation in config/bootstrap-token.txt: Es erstellt den Besitzer, verwaltet Dienstkonten und stellt den Zugriff wieder her. Siehe Authentifizierung.
Registry
Ein Server, zu dem Clients wie Docker oder npm pushen und von dem sie pullen. Arkvory hat eine Container-Registry (/v2/) und eine npm-Registry (/npm/). Siehe Clients und Protokolle.
Repository
Ein benannter Raum für Inhalte mit eigenen Zugriffsregeln und eigener Speicherrichtlinie. Siehe Repositorys.
Anfrage-ID
Die Kennung einer Anfrage, zurückgesendet im Header X-Request-Id und in jedem Fehler. Geben Sie sie dem Support. Siehe HTTP-API-Überblick.
Auflösen
Den Build finden, auf den eine Stufe und ein Versionsbereich zeigen. Siehe Hochstufung.
Wiederherstellen
Eine frühere Revision einer Datei wieder aktuell machen, was eine neue Revision hinzufügt. Auch: die gesamte Installation aus einem Wiederherstellungspunkt wiederherstellen. Siehe Dateien und Pfade und Backups.
Wiederherstellungspunkt
Ein vollständiges Backup, das wiederhergestellt werden kann. Siehe Backups.
Fortsetzen
Einen unterbrochenen Upload oder Download von der Stelle aus fortsetzen, an der er gestoppt wurde. Siehe Übertragungen.
Aufbewahrung
Die Regeln dafür, wie lange Inhalte oder Backups aufbewahrt werden. Siehe Speicher.
Aufbewahrungsrichtlinie
Die gespeicherten Aufbewahrungsregeln eines Repositorys: wie viele Builds behalten werden, welche Labels geschützt werden und wie alt ein Build vor der Entfernung sein muss. Sie ist aus, bis ein Administrator sie einschaltet. Siehe Speicher.
Retry-After
Der Header, und das Feld retryAfterSeconds eines Fehlers, der angibt, wie viele Sekunden nach einem 429 oder 503 bis zum nächsten Versuch zu warten sind. Siehe HTTP-API-Überblick.
Revision
Eine nummerierte Version einer Datei nach Pfad, der Annotationen eines Artefakts oder einer Einstellung. Revisionen zählen ab 1 hoch. Siehe HTTP-API-Überblick.
Widerrufen
Einen Schlüssel oder ein Token endgültig ungültig machen. Siehe Authentifizierung.
Rollback
Die Rückkehr zur vorherigen Version nach einem Update, das nicht gestartet ist. Siehe Updates.
Rotieren
Einen Schlüssel durch einen neuen ersetzen, während der alte noch funktioniert. Das Aktivieren des neuen Schlüssels begrenzt den alten auf 24 Stunden. Siehe Authentifizierung.
S
SBOM
Eine Software-Stückliste: die Liste der Komponenten eines Builds. Sie können sie an einen Build anhängen. Siehe Konzepte.
Selbstheilung
Die Dienste starten nach einem Absturz oder einem Stillstand von selbst neu. Siehe Selbstheilung.
SemVer
Semantic Versioning: MAJOR.MINOR.PATCH, mit einem optionalen Pre-Release-Teil, etwa 1.4.2 oder 2.0.0-rc.1. Siehe Pakete.
Dienstkonto
Ein Konto für CI oder Automatisierung. Es hat eine Richtlinie und meldet sich mit Schlüsseln an. Siehe Authentifizierung.
Dienstschlüssel
Das Geheimnis, mit dem sich ein Dienstkonto anmeldet. Es beginnt mit arkvory_, wird einmal angezeigt und muss aktiviert werden. Siehe Authentifizierung.
Sitzung
Eine angemeldete Konsolensitzung. Sie beginnt mit dps_ und dauert 12 Stunden. Siehe Authentifizierung.
SHA-256
Die Hashfunktion, die Arkvory für Artefakte, Teile und Releases verwendet. Sie wird als 64 hexadezimale Kleinbuchstaben geschrieben. Siehe Übertragungen.
Stabiles Release
Ein Release, das ProAnimaStudio für Installationen im stabilen Kanal freigegeben hat. Siehe Updates.
Stufe
Eine Markierung an einem Build wie qa, release oder prod. Siehe Hochstufung.
Oberfläche
Eine der sechs Gruppen von API-Vorgängen: discovery, identity, catalog, transfers, administration und operations. Siehe HTTP-API-Überblick.
T
Tag
Der Name eines Container-Images für eine Version, etwa latest oder 1.4. Siehe Container-Images.
U
UPack
Das Paketformat, das Arkvory registriert: ein Archiv mit einem Manifest namens upack.json, das die Gruppe, den Namen und die Version angibt. Siehe Pakete.
Update
Ein neueres stabiles Release von Arkvory und seine Installation. Siehe Updates.
Upload
Das Senden einer Datei an den Server. Das Wort bezeichnet auch die Upload-Sitzung, die die Datei reserviert. Siehe Übertragungen.
Upload-Sitzung
Eine Reservierung für eine Datei. Sie lebt 7 Tage und wird abgeschlossen, sobald jedes Byte eingetroffen ist. Siehe Upload-Referenz.
V
Backup-Speicher
Der Speicher für Backups: ein Ordner auf einem anderen Datenträger oder eine Netzwerkfreigabe. Siehe Backups.
Version
Eine SemVer-Version eines Pakets, etwa 1.4.2. Siehe Pakete.
Versionsbereich
Eine Menge von Versionen, etwa ^1.4. Siehe Pakete.
W
Worker
Der Dienst, der große Uploads abschließt und Spiegel synchronisiert. Siehe Installation wählen.
Writer
Der API-Prozess, der Änderungen annimmt, im Gegensatz zu einem Lese-Gateway. Siehe Lese-Gateways.