Como utilizar a ferramenta de criação de issues
O objetivo dessa ferramenta é automatizar a criação de issues que possuem um template padrão. Atualmente, as issues que se encaixam nesse contexto são as issues de solicitação de coleta e as issues de teste de generalização. Tendo isso em mente, esse tutorial irá apresentar como utilizar o gerador de issues nesses dois contextos.
Inicialmente, é necessário que você crie uma token para acesso ao GitHub. Os passos para criação da token são:
- Settings;
- Developer settings;
- Personal access tokens; e
- Generate new token;
Obs.: É importante que você dê a token acesso a escrita!
Após a criação da token, vamos de fato utilizar a ferramenta de criação de issues.
A ferramenta de geração de issues está rodando na infra do MPMG. Para acessá-la é necessário que você tenha:
- Login e Senha do DCC;
- Login e Senha no MPMG.
Para realizar o acesso você deve fazer um túnel SSH, utilizando o seguinte comando no terminal.
ssh -Y -N -L localhost:8060:localhost:8060 vm_f01
Nesse caso, vm_f01 é o nome dado para a nossa vm no arquivo de configuração SSH. Caso você não tenha esses dados acesse nosso canal de informações no Discord.
Após fazer acesso com seu login e senha, você deve acessar no seu navegador o caminho:
http://localhost:8060/
Após realizar o acesso, essa será a interface que você irá visualizar.
- Campo onde você deve entrar com a token criada no Github;
- Nome do repositório onde você deseja criar as issues;
- Nome do seu usuário no GitHub;
- Nome da Tag da issue a ser criada (e.g. Licitação, Despesas, Pagamentos);
- Qual o tipo de issue, Solicitação de Coleta? Issue de teste de generalização?;
- Carregamento do arquivo com os dados a serem criados.
Você deve carregar na ferramenta um arquivo ".json" no seguinte padrão:
{"<NOME DO MUNICIPIO>": "<LINK DO PORTAL>", "<NOME DO MUNICIPIO 2>": "<LINK DO PORTAL>"}
Um exemplo preenchido que você pode usar para teste é apresentado a seguir:
{"Sete Lagoas": "https://transparencia.setelagoas.mg.gov.br/transparencia", "Governador Valadares": "link"}
["<NOME DO MUNICIPIO>", "<NOME DO MUNICIPIO 2>"]
Um exemplo preenchido que você pode usar para teste é apresentado a seguir:
["Sete Lagoas", "Governador Valadares"]
- Preencher os campos
- Subir o arquivo de confirmação
- Clicar em Show issues
- Após visualizar as issues você confirma que visualizou
- Confirma ou não a criação das issues
- Clica na botão criar issues.
Caso tudo tenha dado certo, você receberá uma mensagem falando que as issues foram criadas com sucesso!