From ce13479e2754aff7e16100d0c4eae831190f5836 Mon Sep 17 00:00:00 2001
From: Tiago Garcia <35657250+TiagoRG@users.noreply.github.com>
Date: Mon, 10 Apr 2023 12:39:18 +0100
Subject: [PATCH] Cloned the guide from gists into here
---
...nfiguração-do-GitHub-CLI-para-autenticação.md | 74 +++++++++++++++++++
1 file changed, 74 insertions(+)
create mode 100644 Guia-simples-e-rápido-para-instalação-e-configuração-do-GitHub-CLI-para-autenticação.md
diff --git a/Guia-simples-e-rápido-para-instalação-e-configuração-do-GitHub-CLI-para-autenticação.md b/Guia-simples-e-rápido-para-instalação-e-configuração-do-GitHub-CLI-para-autenticação.md
new file mode 100644
index 0000000..780d954
--- /dev/null
+++ b/Guia-simples-e-rápido-para-instalação-e-configuração-do-GitHub-CLI-para-autenticação.md
@@ -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
+
+## 3. Selecione o protocolo que utiliza para os seus repositórios.
+Pode verificar o que está a usar vendo o ficheiro ``/.git/config`` na root do repositório local.
+No caso de ser HTTPS:
+
+No caso de ser SSH:
+
+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.
+Nota: Se der clone usando o comando da aba do GitHub CLI, fica a usar HTTPS por isso configure isto com HTTPS.
+
+### 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:
+
+2. Copie o código temporário e clique Enter:
+
+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)
+2. Crie o token com no mínimo os seguintes scopes: 'repo', 'workflow', 'admin:org':
+
+3. Copie o token gerado e cole no terminal após escolher a opção de 'Paste an authentication token'.
+
+
+#### No final deverá aparecer a seguinte mensagem:
+
+
+---
+
+### 3.2. Configurar com SSH:
+Se já tiver uma chave criada, selecione essa mesma chave:
+
+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.
+
+#### No final deverá aparecer a seguinte mensagem:
+
+
+---
+
+### Caso fique alguma dúvida, deixe um comentário em baixo
\ No newline at end of file