Criando novos repositórios GitHub

Acriação de novos repositórios no GitHub é tão simples como apertar um botão. Neste post explicarei algumas alternativas que vão simplificar, ainda mais, este processo. Além disso teremos total integração de nosso novo repositório com projeto planner. Vamos que vamos 🚀🚀🚀!!!!

Criação convencional

Para criar um novo repositório GitHub basta acessar a aba Repositories da organização/user GitHub desejado e selecionar a opção New repository no canta superior direito da tela. Como exemplo, incluo abaixo, a tela da organização automatiza-mg:

A tela a seguir servirá para configurações básicas deste novo repositório¹:

Repositório criado é hora de começarmos a incluir nossos arquivos. Foi exatamente pensando nisso que o GitHub criou os templates de repositórios. Com eles, é possível, criar repositórios já com os arquivos mínimos desejados para nosso futuro projeto. Neste sentido, criei o nosso repositorio-template. Sua utilização é tão simples quanto a mostrada inicialmente, com o benefício de já criarmos um repositório com:

• Arquivo .gitignore, que auxilia na utilização local da ferramenta git.
• Arquivo CHANGELOG.md, que auxilia na documentação, resumida, das modificações ocorridas no projeto.
• Arquivo README.md, que poderá ser utilizada como documentação inicial sobre aquele repositório.
• Pasta .github/workflows com GitHub actions para integração do novo repositório com nosso planner.

Criação turbinada

Legal, mas como utilizá-lo? Simples. Vá até a página do repositorio-template e clique em Use this template no canto superior direito da tela:

Depois realize as configurações iniciais:

Prontinho. Repositório criado e pronto para ser utilizado. Caso queira levar o mesmo para seu computador basta fazer o clone² com o endereço do novo repositório criado³:

Actions reutilizáveis

Bom, estamos quase lá. Para que nossos actions reutilizáveis funcionem precisamos cadastrar secrets nas configurações do projeto. Acesse as configurações gerais do GitHub utilizando o usuário admin dcd-github-admin⁴:

Vá até Developer settings no canto inferior esquerdo da página:

Selecione a opção para criação de um token clássico:

E inclua as configurações necessárias para o novo token:

Como padrão:

• Campo Note deverá ser preenchido no padrão organizacao-repo-name.
• Campo Expiration deverá ser preenchido como No expiration.
• Opções repo e project deverão ser marcadas antes de clicar em Generate token no final da página.

O token criado é mostrado apenas uma vez, então não se esqueça de anotar.

Agora, basta voltar nas configurações do novo repositório criado e cadastrar um novo Secret.

Para integração com nosso planner precisamos cadastrar o Secret GH_TOKEN⁵:

Por fim, cadastra o Secret PROJECT_NUMBER, conforme print abaixo⁶:

Prontinho

Bom, você poderia ter parado na criação do novo repositório via template. Mas como somos muito organizados e queremos manter todo nosso trabalho sincronizado no planner vamos sempre preferir perder 5 minutinhos configurando nossos actions, certo? 😀😀😀

---

1. Tente, ao máximo, criar repositórios públicos. Pense sempre se haverá alguma informação sensível e, caso haja, matenha o repositório privado. ↩

2. git clone <endereco-novo-repositorio> ↩

3. Máquinas da Cidade Administrativa podem não aceitar endereços SSH. ↩

4. Credenciais disponíveis no nosso dataset de acessos. Caso seja solicitado autenticação em dois fatores peça auxílio para algum colega que já acessa este usuário. Para entender melhor porque utilizar este usuário leia o post Criação de usuário para adminstração geral GitHub ↩

5. Orientações também disponíveis aqui. ↩

6. Número do projeto planner é 1, conforme pode ser observado no final da url do projeto. ↩

Comentários