TiagoRG
/
uaveiro-leci
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Cloned the guide from gists into here

Tiago Garcia 2023-04-10 12:39:18 +01:00
commit ce13479e27
1 changed files with 74 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
Guia-simples-e-rápido-para-instalação-e-configuração-do-GitHub-CLI-para-autenticação.md Normal file

@ -0,0 +1,74 @@
# Guia simples e rápido para instalação e configuração do GitHub CLI para autenticação
## Porquê usar isto?
* Facilidade de não ter de andar com tokens/chaves atrás,
* Outras funcionalidades que pode ver [esta página](https://cli.github.com/)
---
# Instalação
### Debian (Ubuntu incluído)
```sudo apt install gh```
### RedHat
```sudo dnf install gh```
Se não for suficiente veja [este guia](https://github.com/cli/cli/blob/trunk/docs/install_linux.md#fedora-centos-red-hat-enterprise-linux-dnf)
### ArchLinux
```sudo pacman -S github-cli```
### Outras distribuições veja a [guide do github](https://github.com/cli/cli/blob/trunk/docs/install_linux.md)
---
# Configuração
## 1. Executar o comando para iniciar o menu:
```gh auth login```
## 2. Selecionar GitHub.com
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092941690446286939/image.png)
## 3. Selecione o protocolo que utiliza para os seus repositórios.
Pode verificar o que est&aacute; a usar vendo o ficheiro ``/.git/config`` na root do repositório local.<br>
No caso de ser HTTPS:<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092943612796481606/image.png)<br>
No caso de ser SSH:<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092944030825971803/image.png)<br>
Pode também alterar o que usa mudando para o link que obtém clicando no botão verde 'Code' na página do repositório.<br>
Nota: Se der clone usando o comando da aba do GitHub CLI, fica a usar HTTPS por isso configure isto com HTTPS.<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092944839135473765/image.png)
### 3.1. Configurar com HTTPS (recomendado):
Aqui pode configurar usando o browser ou usando um token.
#### 3.1.1. Usando o web browser:
1. Selecione a primeira opção:<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092945796296622101/image.png)<br>
2. Copie o código temporário e clique Enter:<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092946617851715654/image.png)<br>
3. Cole o código temporário na caixa da janela do browser, clique em 'Continue' e de seguida em 'Authorize'. Deve também autorizar o acesso do GitHub CLI às organizações pretendidas.
#### 3.1.2. Usando o token HTTPS:
1. Deve ir ao GitHub para criar o token. Vá a Settings > Developer Settings > Personal Access Tokens > Tokens (classic) > Generate New Token (classic)<br>
2. Crie o token com no mínimo os seguintes scopes: 'repo', 'workflow', 'admin:org':<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092948861158424646/image.png)<br>
3. Copie o token gerado e cole no terminal após escolher a opção de 'Paste an authentication token'.<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092957787883057152/image.png)
#### No final deverá aparecer a seguinte mensagem:<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092956883058442310/image.png)
---
### 3.2. Configurar com SSH:
Se já tiver uma chave criada, selecione essa mesma chave:<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092954931314577448/image.png)<br>
Se não tiver nenhuma chave pode criar na hora, pode colocar uma palavra-passe (opcional) e depois selecione 'Login with a web browser' e segue o passo 3.1.1.<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092956316479258755/image.png)
#### No final deverá aparecer a seguinte mensagem:<br>
![](https://cdn.discordapp.com/attachments/1092941584091316244/1092956224116494416/image.png)
---
### Caso fique alguma d&uacute;vida, deixe um coment&aacute;rio em baixo