La console web
La console web est l’interface d’Arkvory dans le navigateur. Elle fait partie du serveur : vous ne l’installez pas séparément. Ouvrez /console/ sur l’adresse de votre serveur, par exemple http://127.0.0.1:8080/console/ sur le serveur lui-même, ou https://arkvory.example/console/ une fois HTTPS configuré.
La console utilise la même API HTTP que le client en ligne de commande et le SDK. Le serveur vérifie chaque requête. Lorsqu’un bouton est masqué, cela signifie seulement que votre compte ou votre clé ne peut pas effectuer cette opération.
Disposition
La barre latérale regroupe les sections. Sur un écran étroit, elle devient le bouton Sections.
| Groupe | Sections |
|---|---|
| Bibliothèque | Artefacts, Paquets, Historique des fichiers, Détails de l’artefact |
| Transferts | Téléversement, Téléchargements |
| Ressources | Utilisateurs et accès, Dépôts, Accès des services, Mises à jour, Sauvegardes, Premiers pas, API et CLI |
La barre supérieure affiche le titre de la section, le bouton Téléverser un fichier, le bouton Commentaires et les commandes d’apparence et de langue.
Chaque section a sa propre adresse, comme #/catalog, #/packages ou #/backups. Un artefact ouvert a l’adresse #/artifact/<repository>/<id>. Vous pouvez mettre ces adresses en favori et les envoyer à d’autres personnes. L’adresse ne contient jamais de mot de passe, de clé ni de texte de recherche. Si vous ouvrez un lien avant de vous connecter, la console l’ouvre après votre connexion.
Certaines sections n’apparaissent que pour certains utilisateurs :
| Section | Qui la voit |
|---|---|
| Utilisateurs et accès | Les administrateurs |
| Dépôts | Toute personne connectée |
| Accès des services | La clé de récupération, et les clés d’opérateur disposant de droits délégués |
| Mises à jour | Les administrateurs |
| Sauvegardes | Les administrateurs et la clé de récupération |
Connexion
La carte Connexion au dépôt se trouve en haut de la page.
- Renseignez Nom d’utilisateur et Mot de passe.
- Sélectionnez Se connecter. Une session dure 12 heures.
- La console sélectionne dans Dépôt le premier dépôt que vous pouvez lire. Pour travailler dans un autre dépôt, saisissez son nom ou choisissez-le dans la liste.
Pour vous connecter avec une clé plutôt qu’avec un mot de passe, ouvrez Se connecter avec une clé de service ou d’automatisation, collez la clé et sélectionnez Connecter. La clé reste dans la mémoire de cet onglet du navigateur. La console ne l’enregistre jamais.
S’inscrire n’apparaît que si l’administrateur autorise l’inscription libre. Se déconnecter met fin à la connexion.
Après une connexion par mot de passe, vous pouvez utiliser Changer mon mot de passe et Jetons d’accès personnels. Un jeton d’accès personnel est une clé pour vos propres outils. Voir Comptes et accès.
Le premier propriétaire
Une nouvelle installation n’a aucun compte. Sous Windows, le programme d’installation crée le propriétaire. Pour les autres installations, créez le propriétaire dans la console :
- Ouvrez Premiers pas et développez Créer le premier propriétaire.
- Collez la clé de récupération qui se trouve dans
config/bootstrap-token.txt, dans le répertoire d’installation. - Saisissez un nom et un mot de passe d’au moins 12 caractères, puis sélectionnez Créer le propriétaire.
- Connectez-vous avec le nouveau nom et le mot de passe.
Le formulaire ne fonctionne que tant qu’il n’existe aucun compte. Le propriétaire est un administrateur. Il obtient aussi l’accès en écriture au dépôt releases par l’intermédiaire du groupe arkvory-owners.
Bibliothèque
Artefacts
Artefacts liste les fichiers publiés du dépôt. Recherchez par nom ou par valeur de métadonnée. Utilisez Filtrer par étiquette pour n’afficher qu’une étiquette, et Métadonnées exactes pour une clé et une valeur exactes. Chaque ligne indique le nom, la taille, l’heure de publication, les étapes et les étiquettes. Sélectionnez Télécharger pour télécharger un fichier, ou Ouvrir pour en voir les détails. Charger plus affiche la page suivante.
Paquets
Paquets liste les versions UPack enregistrées. Filtrez avec Groupe UPack et Nom du paquet, choisissez Trier par et Regrouper par, puis sélectionnez Appliquer. La colonne des étapes indique où chaque version est promue. Voir Paquets.
Historique des fichiers
Un chemin de fichier, tel que builds/game/1.4/GameSetup.exe, peut pointer plusieurs fois vers un nouveau contenu. Chaque modification est une nouvelle version. Dans Historique des fichiers, saisissez un chemin et sélectionnez Charger l’historique. Vous voyez chaque version avec son auteur et son heure. Vous pouvez ouvrir n’importe quelle version pour télécharger son contenu d’origine. Restaurer une ancienne version crée une nouvelle version ; rien n’est supprimé. Voir Fichiers et chemins.
Détails d’un artefact
Détails de l’artefact affiche un artefact :
- Résumé : Taille, Téléversé le et SHA-256 avec un bouton Copier.
- Propriétés : Étiquettes, Collections et Métadonnées du build. Sélectionnez Enregistrer les modifications pour les enregistrer. Le fichier lui-même ne change pas.
- Actions : Télécharger ; Lien de téléchargement crée un lien qui fonctionne pendant une heure sans clé ; Enregistrer le paquet UPack indexe une archive UPack.
- Lien de fichier : Associer le fichier fait de cet artefact le contenu actuel d’un chemin de fichier.
- Promotion : Ajouter une étape marque l’artefact avec une étape, par exemple
qaourelease. Promouvoir le publie dans un autre dépôt. Voir Promotion. - Manifestes et fichiers supplémentaires : Ajouter une pièce jointe associe à ce build un manifeste, un SBOM, une signature, un rapport ou un autre fichier. Historique des pièces jointes affiche les ensembles précédents.
- Supprimer l’artefact : Vérifier les dépendances montre ce qui utilise encore l’artefact. Pour le supprimer, collez l’ID de l’artefact et sélectionnez Supprimer cet artefact.
Transferts
Téléversement
Dans Téléversement, choisissez un fichier et sélectionnez Téléverser / reprendre. La console calcule d’abord le SHA-256 du fichier, puis l’envoie par parties. Pause interrompt le transfert et conserve les parties déjà téléversées.
Pour reprendre plus tard, conservez l’ID du téléversement. Ouvrez Reprendre un téléversement, sélectionnez le même fichier et renseignez ID de téléversement. Le navigateur vous avertit avant que vous quittiez la page pendant un téléversement. Voir Transferts.
Téléchargements
Téléchargements est une file des fichiers que vous téléchargez depuis la console. La console vérifie le SHA-256 de chaque fichier avant d’enregistrer le fichier final.
- Paramètres de la file définit Téléchargements parallèles (de 1 à 8), Intervalle de démarrage, ms et Attente maximale dans la file, secondes.
- Tout suspendre, Reprendre la file, Vider la file, Tout annuler et Retirer les terminés pilotent l’ensemble de la file.
- Après un rechargement de la page, reconnectez-vous et sélectionnez Restaurer la file. Reprenez ensuite chaque fichier et choisissez où l’enregistrer.
Les gros téléchargements nécessitent Chrome ou Edge sur une adresse sécurisée (HTTPS ou l’ordinateur local). Les données temporaires restent dans le stockage privé du navigateur.
Ressources
Utilisateurs et accès
Les administrateurs gèrent ici les personnes. Comptes liste les comptes ; Groupes et autorisations liste les groupes. Utilisez Créer un utilisateur, Réinitialiser le mot de passe, Créer un groupe et Gérer les membres des groupes. Dans Gérer l’accès aux dépôts, donnez à un groupe l’accès Lecture ou Lecture et écriture à un dépôt, désigné par son nom. Un dépôt ne se crée pas séparément : il existe dès qu’un accès accordé ou une politique de service le nomme.
Dépôts
Dépôts affiche les dépôts que vous pouvez voir, avec Vos autorisations. Chaque carte propose Ouvrir les fichiers, Stockage et nettoyage (quota, nettoyage automatique et nettoyage physique) et, pour les administrateurs, Gérer l’accès. Un dépôt en miroir affiche le badge Miroir. Voir Dépôts et Stockage.
Accès des services
C’est ici que vous créez les comptes des outils et des systèmes de CI. Pour voir cette section, connectez-vous avec la clé de récupération ou avec une clé d’opérateur. Sélectionnez Créer un compte de service, puis définissez Autorisations sur les dépôts. Préréglage lecture et Préréglage publication remplissent des jeux d’autorisations types.
Pour émettre une clé, ouvrez Clés de service et sélectionnez Émettre la clé. Le secret n’est affiché qu’une seule fois. Copiez-le, confirmez J’ai enregistré le secret et sélectionnez Activer la clé. Une clé qui n’est pas activée expire au bout de 15 minutes. Utilisez Renouveler pour remplacer une clé et Révoquer pour la révoquer. Administration déléguée permet au propriétaire de donner à un opérateur des droits d’administration limités.
Mises à jour
Mises à jour affiche Version installée et Dernière version stable. Sélectionnez Vérifier maintenant ou Installer la mise à jour. Dans Mises à jour automatiques, activez Installer automatiquement les versions stables compatibles et choisissez Heure de maintenance (UTC). Voir Mises à jour.
Sauvegardes
Sauvegardes indique si les sauvegardes sont saines, la dernière sauvegarde, la prochaine exécution, l’agent de sauvegarde et le stockage des sauvegardes. Sélectionnez Sauvegarder maintenant pour lancer une sauvegarde. Points de restauration liste les points de restauration ; vous pouvez vérifier chaque octet d’un point ou l’épingler. Planification et rétention définit l’heure quotidienne, le fuseau horaire et le nombre de points à conserver. La restauration est une commande à exécuter sur le serveur. Voir Sauvegardes.
Premiers pas et référence de l’API
Premiers pas présente ce qu’il faut faire en premier sur un nouveau serveur. API et CLI liste des exemples de commandes. Charger les opérations d’API autorisées affiche les opérations d’API que votre compte ou votre clé actuel peut appeler.
Commentaires
Une fois connecté, Commentaires envoie un message à ProAnimaStudio par l’intermédiaire du hub. Vous pouvez ajouter jusqu’à 6 images et une adresse e-mail pour recevoir une réponse. Les administrateurs peuvent joindre le journal du serveur. Sélectionnez Afficher ce qui est joint pour voir exactement ce qui est envoyé.
Apparence et langue
Apparence propose trois options : Système, Clair et Sombre. Langue liste chaque langue de la console sous son propre nom : English, Русский, Español, Français, Deutsch, Português, 中文, 日本語, 한국어, हिन्दी et العربية. La page change aussitôt, sans rechargement et sans perdre ce que vous avez saisi ; en arabe, elle se lit de droite à gauche. À la première visite, la console suit les langues du navigateur et se rabat sur l’anglais. Documentation dans API et CLI ouvre cette documentation dans la langue de la console. Le navigateur n’enregistre que le thème et la langue, rien sur votre compte ni sur vos dépôts.