La consola web
La consola web es la interfaz de Arkvory en el navegador. Forma parte del servidor, por lo que no se instala por separado. Abra /console/ en la dirección de su servidor, por ejemplo http://127.0.0.1:8080/console/ en el propio servidor o https://arkvory.example/console/ después de configurar HTTPS.
La consola usa la misma API HTTP que el cliente de línea de comandos y el SDK. El servidor comprueba cada solicitud. Si un botón no aparece, significa únicamente que su cuenta o su clave no pueden usar esa operación.
Disposición
La barra lateral agrupa las secciones. En una pantalla estrecha, la barra lateral pasa a ser el botón Secciones.
| Grupo | Secciones |
|---|---|
| Biblioteca | Artefactos, Paquetes, Historial de archivos, Detalles del artefacto |
| Transferencias | Subida, Descargas |
| Recursos | Usuarios y acceso, Repositorios, Acceso de servicios, Actualizaciones, Copias de seguridad, Primeros pasos, API y CLI |
La barra superior muestra el título de la sección, el botón Subir archivo, el botón Comentarios y los controles de apariencia y de idioma.
Cada sección tiene su propia dirección, como #/catalog, #/packages o #/backups. Un artefacto abierto tiene la dirección #/artifact/<repository>/<id>. Puede guardar estas direcciones como marcadores y enviarlas a otras personas. La dirección nunca contiene una contraseña, una clave ni un texto de búsqueda. Si abre un enlace antes de iniciar sesión, la consola lo abre después de que inicie sesión.
Algunas secciones solo aparecen para determinados usuarios:
| Sección | Quién la ve |
|---|---|
| Usuarios y acceso | Administradores |
| Repositorios | Todos los que han iniciado sesión |
| Acceso de servicios | La clave de recuperación y las claves de operador con derechos delegados |
| Actualizaciones | Administradores |
| Copias de seguridad | Los administradores y la clave de recuperación |
Inicio de sesión
La tarjeta Conexión al repositorio está en la parte superior de la página.
- Rellene los campos Nombre de usuario y Contraseña.
- Seleccione Iniciar sesión. Una sesión dura 12 horas.
- En el campo Repositorio, la consola selecciona el primer repositorio que usted puede leer. Para trabajar en otro, escriba su nombre o elíjalo en la lista.
Para conectarse con una clave en lugar de una contraseña, abra Conectarse con una clave de servicio o de automatización, pegue la clave y seleccione Conectar. La clave permanece en la memoria de esta pestaña del navegador. La consola nunca la guarda.
El botón Registrarse aparece solo cuando el administrador permite el autorregistro. El botón Desconectar cierra la conexión.
Después de iniciar sesión con una contraseña, puede usar Cambiar mi contraseña y Tokens de acceso personal. Un token de acceso personal es una clave para sus propias herramientas. Consulte Cuentas y acceso.
El primer propietario
Una instalación nueva no tiene cuentas. En Windows, el instalador crea al propietario. En las demás instalaciones, cree al propietario en la consola:
- Abra Primeros pasos y expanda Crear el primer propietario.
- Pegue la clave de recuperación de
config/bootstrap-token.txt, en el directorio de la instalación. - Introduzca un nombre y una contraseña de al menos 12 caracteres, y seleccione Crear propietario.
- Inicie sesión con el nuevo nombre y la nueva contraseña.
El formulario funciona solo mientras no existan cuentas. El propietario es administrador. Además, obtiene acceso de escritura al repositorio releases mediante el grupo arkvory-owners.
Biblioteca
Artefactos
La sección Artefactos muestra los archivos publicados del repositorio. Busque por nombre o por un valor de metadatos. Use Filtrar por etiqueta para mostrar una etiqueta y Metadatos exactos para una clave y un valor exactos. Cada fila muestra el nombre, el tamaño, la hora de publicación, las etapas y las etiquetas. Seleccione Descargar para descargar un archivo o Abrir para ver sus detalles. El botón Cargar más muestra la página siguiente.
Paquetes
La sección Paquetes muestra las versiones de UPack registradas. Filtre por Grupo UPack y Nombre del paquete, elija Ordenar por y Agrupar por, y seleccione Aplicar. La columna de etapas muestra dónde se ha promovido cada versión. Consulte Paquetes.
Historial de archivos
Una ruta de archivo, como builds/game/1.4/GameSetup.exe, puede apuntar a contenido nuevo muchas veces. Cada cambio es una versión nueva. En Historial de archivos, introduzca una ruta y seleccione Cargar historial. Verá cada versión con su autor y su hora. Puede abrir cualquier versión para descargar su contenido original. Restaurar una versión antigua crea una versión nueva; no elimina nada. Consulte Archivos y rutas.
Detalles del artefacto
La sección Detalles del artefacto muestra un artefacto:
- Resumen: Tamaño, Subido y SHA-256 con un botón Copiar.
- Propiedades: Etiquetas, Colecciones y Metadatos de la compilación. Seleccione Guardar cambios para guardarlos. El archivo en sí no cambia.
- Acciones: Descargar; Enlace de descarga crea un enlace que funciona durante una hora sin clave; Registrar UPack indexa un archivo UPack.
- Referencia de archivo: Asignar archivo convierte este artefacto en el contenido actual de una ruta de archivo.
- Promoción: Agregar etapa marca el artefacto con una etapa, como
qaorelease. Promover lo publica en otro repositorio. Consulte Promoción. - Manifiestos y archivos adicionales: Agregar adjunto vincula un manifiesto, un SBOM, una firma, un informe u otro archivo a esta compilación. Historial de adjuntos muestra los conjuntos anteriores.
- Eliminar artefacto: Comprobar dependencias muestra qué sigue usando el artefacto. Para eliminarlo, pegue el ID del artefacto y seleccione Eliminar este artefacto. Eliminar requiere una clave de servicio con la acción
artifact.delete: una sesión con contraseña, un token personal y la clave de recuperación no pueden eliminar.
Transferencias
Subida
En Subida, elija un archivo y seleccione Subir / reanudar. La consola calcula primero el SHA-256 del archivo y después lo envía en partes. El botón Pausar detiene la transferencia y conserva las partes ya subidas.
Para continuar más tarde, conserve el ID de la subida. Abra Reanudar una subida, seleccione el mismo archivo e introduzca el valor de ID de subida. El navegador le avisa antes de que abandone la página durante una subida. Consulte Transferencias.
Descargas
La sección Descargas es una cola de los archivos que descarga desde la consola. La consola comprueba el SHA-256 de cada archivo antes de guardar el archivo final.
- En Configuración de la cola se establecen Descargas en paralelo (de 1 a 8), Intervalo de inicio, ms y Límite de espera en cola, segundos.
- Los botones Pausar todo, Reanudar cola, Cancelar en espera, Cancelar todo y Quitar finalizadas controlan toda la cola.
- Tras recargar la página, vuelva a iniciar sesión y seleccione Restaurar cola. Después reanude cada archivo y elija dónde guardarlo.
Las descargas grandes requieren Chrome o Edge en una dirección segura (HTTPS o el equipo local). Los datos temporales se quedan en el almacenamiento privado del navegador.
Recursos
Usuarios y acceso
Aquí los administradores gestionan las cuentas de las personas. Cuentas enumera las cuentas y Grupos y permisos enumera los grupos. Use Crear usuario, Restablecer contraseña, Crear grupo y Administrar miembros de grupos. En Administrar acceso a repositorios, conceda a un grupo acceso Lectura o Lectura y escritura a un repositorio por su nombre. Un repositorio no tiene un paso de creación independiente: existe en cuanto lo nombra una concesión de acceso o una política de servicio.
Repositorios
La sección Repositorios muestra los repositorios que usted puede ver, con el apartado Sus permisos. Cada tarjeta tiene Abrir archivos, Almacenamiento y limpieza (cuota, limpieza automática y limpieza física; requiere una clave de servicio con las acciones storage.read o storage.manage) y, para los administradores, Administrar acceso. Un repositorio espejo muestra la insignia Espejo. Consulte Repositorios y Almacenamiento.
Acceso de servicios
Aquí se crean cuentas para herramientas y sistemas de CI. Para ver esta sección, conéctese con la clave de recuperación o con una clave de operador. Seleccione Crear cuenta de servicio y después defina Permisos de repositorio. Los botones Conjunto de lectura y Conjunto de publicación rellenan conjuntos de permisos habituales.
Para emitir una clave, abra Claves de servicio y seleccione Emitir clave. El secreto se muestra una sola vez. Cópielo, confirme la opción He guardado el secreto y seleccione Activar clave. Una clave que no se activa caduca a los 15 minutos. Use Rotar para sustituir una clave por otra y Revocar para cancelarla de forma definitiva. La sección Administración delegada permite al propietario conceder a un operador derechos administrativos limitados.
Actualizaciones
La sección Actualizaciones muestra la Versión instalada y la Última versión estable. Seleccione Comprobar ahora o Instalar actualización. En Actualizaciones automáticas, active Instalar automáticamente las versiones estables compatibles y elija la Hora de mantenimiento (UTC). Consulte Actualizaciones.
Copias de seguridad
La sección Copias de seguridad muestra si las copias de seguridad están en buen estado, la última copia, la próxima ejecución, el agente de copias de seguridad y el almacén de copias. Seleccione Crear copia ahora para iniciar una copia. El apartado Puntos de restauración enumera los puntos de restauración; puede verificar cada byte de un punto o fijarlo. El apartado Programación y retención define la hora diaria, la zona horaria y cuántos puntos se conservan. La restauración es un comando que se ejecuta en el servidor. Consulte Copias de seguridad.
Primeros pasos y referencia de la API
La sección Primeros pasos muestra los primeros pasos para un servidor nuevo. La sección API y CLI enumera comandos de ejemplo. El botón Cargar las operaciones de API permitidas muestra las operaciones de la API que puede invocar su cuenta o clave actual.
Comentarios
Después de iniciar sesión, el botón Comentarios envía un mensaje a ProAnimaStudio a través del hub. Puede agregar hasta 6 imágenes y una dirección de correo electrónico para recibir la respuesta. Los administradores pueden adjuntar el registro del servidor. Seleccione Mostrar lo que se adjunta para ver exactamente qué se envía.
Apariencia e idioma
El control Apariencia tiene tres opciones: Sistema, Claro y Oscuro. El control Idioma enumera todos los idiomas de la consola con su propio nombre: English, Русский, Español, Français, Deutsch, Português, 中文, 日本語, 한국어, हिन्दी y العربية. La página cambia al instante, sin recargarse y sin perder lo que haya escrito; en árabe se lee de derecha a izquierda. En la primera visita, la consola sigue los idiomas del navegador y, si ninguno coincide, recurre al inglés. El botón Documentación de la sección API y CLI abre esta documentación en el idioma de la consola. El navegador guarda solo el tema y el idioma, nada sobre su cuenta ni sobre sus repositorios.