Configurando git para enviar para o github <a href="configurando_git_para_enviar_para_o_github.html" target="_blank" title="Pressione aqui para expandir este documento em nova aba."

Para conectar-se ao github.com é necessário criar um chave do protocolo SSH (Secure Shell Protocol), que fornece um canal seguro em uma rede não segura da seguinte forma:
```
    
    # Gerando uma chave ssh na pasta ~/ssh
    ssh-keygen -t ed25519 -C "seu_email@qualquercoisa.com"           

    # Adicionando sua chave SSH ao agente ssh
    eval "$(ssh-agent -s)"

    # Adicione sua chave privada SSH ao agente ssh. 
    # Se você criou sua chave com um nome diferente ou se está adicionando uma 
    # chave existente com um nome diferente, substitua id_ed25519 no comando 
    # pelo nome de seu arquivo de chave privada:
    # Mais informação: https://linux.die.net/man/1/ssh-add
    ssh-add ~/.ssh/id_ed25519
```
1. NOTAS:
  1. Se você estiver usando um sistema legado que não suporta o algoritmo Ed25519, use:
```
  ssh-keygen -t rsa -b 4096 -C "paulosspacheco"
```
  2. Dependendo do seu ambiente, pode ser necessário usar um comando diferente.
    1. Por exemplo, pode ser necessário usar o acesso root executando sudo -s -H antes de iniciar o ssh-agent ou pode ser necessário usar exec ssh-agent bash ou exec ssh-agent zsh para executar o ssh-agent.
  3. Após adicionar a chave no agente ssh, é necessário registrar no servidor github.
  4. Caso ocorra algum error na autenticação: Veja esse link
  5. Caso troque a chave ssh é necessário clonar o repositório fazer as alterações necessárias e enviar novamente para o remoto. (Passei o um dia para entender isso)
  6. REFERÊNCIAS:
    1. Requisitos de autenticação de token para operações Git.
      1. Criação de um token de acesso pessoal
      2. Novo token de acesso pessoal
Entre no github para adicionar uma nova chave SSH à sua conta GitHub.
Criando repositório no github e configurando a máquina cliente:

Suponha que o grupo seja mi e o projeto seja maricarai então:


   # criando uma pasta para os arquivos do git separado da pasta corrente que se deseja versionar
   git init --separate-git-dir ../maricarai.git 

   # Associa o repositório remoto ao repositório local.          
   git remote add origin git@github.com:paulosspacheco/maricarai.git

   # Cria um ramo para a versão     
     git branch -M main                           

   # Adiciona todos os arquivo da pasta que se quer versionar
   git add .        

   # Finaliza a transação do comando git add e registra o nome das alterações feitas       
   git commit -m "Descreva as alterações feitas"

   # Envia as alterações locais para o repositório remoto.
   git push -u origin main                  
   
   # Pull requests (Solicitações de pull)

ATENÇÃO
1. Lei sobre Pull Requests para finalizar o processo de atualização
2. Como criar seu primeiro pull request no GitHub

Verificando as chaves SSH existentes

Digite ls -al ~/.ssh para ver se as chaves SSH existentes estão presentes.

     
     $ ls -al ~/.ssh
     # Lists the files in your .ssh directory, if they exist

Verifique a lista de diretórios para ver se você já possui uma chave SSH pública. Por padrão, os nomes de arquivo das chaves públicas com suporte para o GitHub são um dos seguintes.
1. ~/.ssh/id_rsa.pub
2. ~/.ssh/id_ecdsa.pub
3. ~/.ssh/id_ed25519.pub
Copie a chave pública SSH gerada para a área de transferência.
Acesse o site github e cole a chave que está na área de transferência.
Comando para saber se a chave ssh está associada ao github:


   git status

REFERÊNCIAS