tag2upload permite que DDs e DMs façam upload simplesmente usando o script git-debpush para enviar uma tag git assinada.
Nota: o serviço ainda não foi implantado! Estamos trabalhando nisso. Por enquanto, nesta página estão descritas algumas coisas que serão verdadeiras no futuro, como se fossem verdadeiras agora. Veja os anúncios em debian-devel-announce.
Links importantes
git-debpush(1) - utilitário de criação de tags - a nova maneira de fazer upload
https://tag2upload.debian.org - Página principal do status do serviço com estatísticas, logs, etc.
debian-tag2upload (at) lists.debian.org - lista de discussão que recebe logs de construção, avisos, etc. (não serve para debates!)
tag2upload(5) - especificação do formato de tag
Instruções de configuração
Antes de usar git-debpush, atualmente é necessário configurar o salsa para notificar o serviço tag2upload quando você envia uma tag, para que o serviço saiba buscar a tag e processar seu upload. (Esperamos que este passo se torne desnecessário em algum momento).
No seu Projeto no gitlab, em Configurações, abra a configuração Webhooks. Use "Adicionar novo webhook" e adicione um webhook da seguinte forma (configurações que não são o padrão são mostradas aqui em negrito):
URL: https://webhook.tag2upload.debian.org/hook/gitlab
- Show full url
Name: tag2upload
- Description: blank
- Secret token: blank
Trigger: Tag push events selected, all others unselected
- Custom webhook template: blank
- SSL verification: enabled
Captura de tela da configuração.
Ao criar o webhook, você pode executar um teste a partir da página de configuração "Webhooks". Selecione o webhook tag2upload, menu "Teste", "Tag push events". Você deve ver um relatório como este no topo da página: Hook executed successfully but returned HTTP 400 error: misconfigured (or malfunctioning) web hook: message field is missing. (This can happen if the gitlab UI "Test" feature is used - in which case this message indicates the hook seems like it might be properly configured.)
Infelizmente é necessário fazer uma configuração toda vez para cada projeto.
Se você fez as coisas na ordem errada, você pode fazer com que a salsa envie o webhook de novo eliminando a tag do repositório e imediatamente reenviando-o (com git-push - não re-execute git-debpush).
Monitoramento e saídas
Seu upload deve resultar em um e-mail para você, com cópia para a lista debian-tag2upload; se bem sucedido, ele aparecerá em dgit fetch e em https://browse.dgit.debian.org (mesmo antes de ter sido aceito pelo repositório ftp). Observe que os(as) apadrinhados(as)/amadrinhados(as) não recebem e-mails do tag2upload, mas apenas do dak; o tag2upload deve fazer feedback para quem assina, não para Changed-By.
A página de serviço do tag2upload pode te mostrar a atividade atual e recente.
debian-tag2upload é uma lista de discussão completamente funcional que aceita inscrições, e distribui e arquiva e-mails, mas o visualizador web da lista e arquivos está quebrado no momento. Enquanto o(a) listmaster tenta entender o problema, se você é um(a) DD e precisa ver os arquivos, estes estão disponíveis no local de sempre em master.debian.org.
Sob Editar na interface do gitlab para um webhook, você pode ver um log das requisições que o gitlab acha que foram feitas.
(Se o webhook estiver configurado, todas as tags serão notificadas para o serviço tag2upload. No entanto, as tags que não se parecem o suficiente com tags tag2upload são ignoradas - você pode ver essas solicitações webhook de tags na interface web do gitlab, mas elas não aparecerão nas páginas de serviço do tag2upload. A interface de usuário(a) da web gitlab mostrará a mensagem "not for us" enviada pelo serviço tag2upload em resposta ao webhook).
API de informações do serviço web
Cada uma das páginas web em https://tag2upload.debian.org também está disponível em um formulário JSON não processado. Basta enviar um cabeçalho Accept: application/json. Esta é uma visão somente de leitura.
O esquema JSON não está documentado e é instável. Mas espero que isso seja útil. Se você estiver usando esse recurso, entre em contato conosco para que possamos tentar evitar que seu código quebre.
Créditos
O tag2upload foi criado por Ian Jackson e Sean Whitton.