O console web
O console web é a interface do Arkvory no navegador. Ele faz parte do servidor, então você não o instala separadamente. Abra /console/ no endereço do seu servidor, por exemplo http://127.0.0.1:8080/console/ no próprio servidor ou https://arkvory.example/console/ depois de configurar o HTTPS.
O console usa a mesma API HTTP que o cliente de linha de comando e o SDK. O servidor verifica cada solicitação. Quando um botão está oculto, isso significa apenas que sua conta ou sua chave não pode usar aquela operação.
Layout
A barra lateral agrupa as seções. Em uma tela estreita, a barra lateral vira o botão Seções.
| Grupo | Seções |
|---|---|
| Biblioteca | Artefatos, Pacotes, Histórico de arquivos, Detalhes do artefato |
| Transferências | Upload, Downloads |
| Recursos | Usuários e acesso, Repositórios, Acesso de serviços, Atualizações, Backups, Primeiros passos, API e CLI |
A barra superior mostra o título da seção, o botão Enviar arquivo, o botão Feedback e os controles de aparência e de idioma.
Cada seção tem o próprio endereço, como #/catalog, #/packages ou #/backups. Um artefato aberto tem o endereço #/artifact/<repository>/<id>. Você pode salvar esses endereços nos favoritos e enviá-los a outras pessoas. O endereço nunca contém uma senha, uma chave nem um texto de busca. Se você abrir um link antes de entrar, o console o abre depois que você entrar.
Algumas seções aparecem somente para alguns usuários:
| Seção | Quem vê |
|---|---|
| Usuários e acesso | Administradores |
| Repositórios | Todos que estão conectados |
| Acesso de serviços | A chave de recuperação e as chaves de operador com direitos delegados |
| Atualizações | Administradores |
| Backups | Administradores e a chave de recuperação |
Entrar
O cartão Conexão com o repositório fica no topo da página.
- Preencha os campos Nome de usuário e Senha.
- Selecione Entrar. Uma sessão dura 12 horas.
- O console preenche o campo Repositório com o primeiro repositório que você pode ler. Para trabalhar em outro repositório, digite o nome dele ou escolha-o na lista.
Para se conectar com uma chave em vez de uma senha, abra Conectar com uma chave de serviço ou de automação, cole a chave e selecione Conectar. A chave fica na memória desta aba do navegador. O console nunca a salva.
O botão Cadastrar-se aparece somente quando o administrador permite o autocadastro. O botão Desconectar encerra a conexão.
Depois de entrar com uma senha, você pode usar Alterar minha senha e Tokens de acesso pessoal. Um token de acesso pessoal é uma chave para as suas próprias ferramentas. Consulte Contas e acesso.
O primeiro proprietário
Uma instalação nova não tem contas. No Windows, o instalador cria o proprietário. Nas outras instalações, crie o proprietário no console:
- Abra Primeiros passos e expanda Criar o primeiro proprietário.
- Cole a chave de recuperação de
config/bootstrap-token.txt, no diretório da instalação. - Informe um nome e uma senha de pelo menos 12 caracteres e selecione Criar proprietário.
- Entre com o novo nome e a nova senha.
O formulário só funciona enquanto não há contas. O proprietário é um administrador. Ele também recebe acesso de gravação ao repositório releases por meio do grupo arkvory-owners.
Biblioteca
Artefatos
A seção Artefatos lista os arquivos publicados do repositório. Pesquise por nome ou por um valor de metadados. Use Filtrar por rótulo para mostrar um único rótulo e Metadados exatos para uma chave e um valor exatos. Cada linha mostra o nome, o tamanho, o horário de publicação, os estágios e os rótulos. Selecione Baixar para baixar um arquivo ou Abrir para ver os detalhes dele. O botão Carregar mais mostra a próxima página.
Pacotes
A seção Pacotes lista as versões UPack registradas. Filtre por Grupo UPack e Nome do pacote, escolha Ordenar por e Agrupar por e selecione Aplicar. A coluna de estágios mostra onde cada versão foi promovida. Consulte Pacotes.
Histórico de arquivos
Um caminho de arquivo, como builds/game/1.4/GameSetup.exe, pode apontar para conteúdo novo muitas vezes. Cada alteração é uma nova versão. Em Histórico de arquivos, informe um caminho e selecione Carregar histórico. Você vê cada versão com o autor e o horário. Você pode abrir qualquer versão para baixar o conteúdo original dela. Restaurar uma versão antiga cria uma nova versão; nada é excluído. Consulte Arquivos e caminhos.
Detalhes do artefato
A seção Detalhes do artefato mostra um artefato:
- Resumo: Tamanho, Enviado em e SHA-256 com um botão Copiar.
- Propriedades: Rótulos, Coleções e Metadados do build. Selecione Salvar alterações para armazená-los. O arquivo em si não muda.
- Ações: Baixar; Link de download cria um link que funciona por uma hora sem uma chave; Registrar UPack indexa um arquivo UPack.
- Referência de arquivo: Atribuir arquivo torna este artefato o conteúdo atual de um caminho de arquivo.
- Promoção: Adicionar estágio marca o artefato com um estágio, como
qaourelease. Promover o publica em outro repositório. Consulte Promoção. - Manifestos e arquivos adicionais: Adicionar anexo vincula um manifesto, um SBOM, uma assinatura, um relatório ou outro arquivo a este build. Histórico de anexos mostra os conjuntos anteriores.
- Excluir artefato: Verificar dependências mostra o que ainda usa o artefato. Para excluir, cole o ID do artefato e selecione Excluir este artefato.
Transferências
Upload
Em Upload, escolha um arquivo e selecione Enviar / retomar. O console primeiro calcula o SHA-256 do arquivo e depois o envia em partes. O botão Pausar interrompe a transferência e mantém as partes já enviadas.
Para continuar depois, guarde o ID do upload. Abra Retomar um upload, selecione o mesmo arquivo e preencha o campo ID do upload. O navegador avisa antes de você sair da página durante um upload. Consulte Transferências.
Downloads
A seção Downloads é uma fila dos arquivos que você baixa pelo console. O console verifica o SHA-256 de cada arquivo antes de salvar o arquivo final.
- Em Configurações da fila, você define Downloads paralelos (de 1 a 8), Intervalo de início, ms e Limite de espera na fila, segundos.
- Os botões Pausar tudo, Retomar fila, Cancelar em espera, Cancelar tudo e Remover concluídos controlam a fila inteira.
- Depois de recarregar a página, entre novamente e selecione Restaurar fila. Em seguida, retome cada arquivo e escolha onde salvá-lo.
Downloads grandes exigem o Chrome ou o Edge em um endereço seguro (HTTPS ou o computador local). Os dados temporários ficam no armazenamento privado do navegador.
Recursos
Usuários e acesso
Os administradores gerenciam as pessoas aqui. O bloco Contas lista as contas; o bloco Grupos e permissões lista os grupos. Use Criar usuário, Redefinir senha, Criar grupo e Gerenciar membros dos grupos. Em Gerenciar acesso a repositórios, dê a um grupo o acesso Leitura ou Leitura e gravação a um repositório pelo nome. Um repositório não tem uma etapa de criação separada: ele passa a existir assim que uma regra de acesso ou uma política de serviço o menciona.
Repositórios
A seção Repositórios mostra os repositórios que você pode ver, com Suas permissões. Cada cartão tem Abrir arquivos, Armazenamento e limpeza (cota, limpeza automática e limpeza física) e, para os administradores, Gerenciar acesso. Um repositório espelhado mostra o selo Espelho. Consulte Repositórios e Armazenamento.
Acesso de serviços
Aqui você cria contas para ferramentas e sistemas de CI. Para ver esta seção, conecte-se com a chave de recuperação ou com uma chave de operador. Selecione Criar conta de serviço e depois defina Permissões nos repositórios. Os botões Predefinição de leitura e Predefinição de publicação preenchem conjuntos de permissões típicos.
Para emitir uma chave, abra Chaves de serviço e selecione Emitir chave. O segredo é exibido uma única vez. Copie-o, confirme Salvei o segredo e selecione Ativar chave. Uma chave que não é ativada expira após 15 minutos. Use Rotacionar para substituir uma chave e Revogar para cancelá-la. A seção Administração delegada permite que o proprietário dê a um operador direitos administrativos limitados.
Atualizações
A seção Atualizações mostra a Versão instalada e a Última versão estável. Selecione Verificar agora ou Instalar atualização. Em Atualizações automáticas, ative Instalar automaticamente versões estáveis compatíveis e escolha a Hora de manutenção (UTC). Consulte Atualizações.
Backups
A seção Backups mostra se os backups estão em ordem, o último backup, a próxima execução, o agente de backup e o armazenamento de backups. Selecione Fazer backup agora para iniciar um backup. A lista Pontos de restauração mostra os pontos de restauração; você pode verificar cada byte de um ponto ou fixá-lo. Em Agendamento e retenção, você define o horário diário, o fuso horário e quantos pontos manter. A restauração é um comando no servidor. Consulte Backups.
Primeiros passos e referência da API
A seção Primeiros passos mostra os primeiros passos para um servidor novo. A seção API e CLI lista comandos de exemplo. O botão Carregar operações de API permitidas mostra as operações da API que sua conta ou chave atual pode chamar.
Feedback
Depois de entrar, o botão Feedback envia uma mensagem para a ProAnimaStudio por meio do hub. Você pode adicionar até 6 imagens e um endereço de e-mail para receber a resposta. Os administradores podem anexar o log do servidor. Selecione Mostrar o que será anexado para ver exatamente o que será enviado.
Aparência e idioma
A opção Aparência tem três valores: Sistema, Claro e Escuro. A lista Idioma mostra todos os idiomas do console pelo nome próprio de cada um: English, Русский, Español, Français, Deutsch, Português, 中文, 日本語, 한국어, हिन्दी e العربية. A página muda na hora, sem recarregar e sem perder o que você digitou; em árabe, ela é lida da direita para a esquerda. Na primeira visita, o console segue os idiomas do navegador e, se nenhum estiver disponível, usa o inglês. O link Documentação em API e CLI abre esta documentação no idioma do console. O navegador salva apenas o tema e o idioma, nada sobre sua conta ou seus repositórios.