DEV Community

Cover image for Como subir seu primeiro repositório no GitHub: um guia passo a passo.
Lorena
Lorena

Posted on

Como subir seu primeiro repositório no GitHub: um guia passo a passo.

Fazer o deploy do seu site é uma tarefa importante para torná-lo acessível na internet e alcançar um público maior. Por isso, subir seu repositório no GitHub é uma ótima maneira de compartilhar seu projeto e torná-lo disponível para outros usuários.

Para isso, você precisa ter certeza de que o git está instalado no seu computador.

1. Verificando a instalação

Você pode verificar a instalação no terminal ou com prompt de comando usando:

git --version
Enter fullscreen mode Exit fullscreen mode

Caso ele não esteja instalado, você pode instalá-lo seguindo as instruções por aqui.

2. Configurando o Git

Configurar o Git é um passo importante para trabalhar com repositórios em seu computador. Felizmente, é fácil fazer isso usando alguns comandos simples no terminal. Siga as etapas abaixo para configurar suas informações de usuário:

  • Abra o terminal em seu computador.

  • Digite o seguinte comando para definir seu nome de usuário, substituindo "[nome]" pelo seu próprio nome:

git config --global user.name "[nome]"
Enter fullscreen mode Exit fullscreen mode
  • Em seguida, digite o seguinte comando para definir seu endereço de e-mail, substituindo "[endereco-de-email]" pelo seu próprio endereço de e-mail:
git config --global user.email "[endereco-de-email]"
Enter fullscreen mode Exit fullscreen mode

Essa parte está pronta. Mas lembre-se de adaptar os comandos para seu caso específico.

3. Criando um repositório

Para começar a usar o Git, é necessário criar um novo repositório no GitHub. Veja como fazer:

  • Acesse o seu GitHub e clique em "New".

Print da página inicial do GitHub, onde mostra o botão New em destaque

  • Preencha as informações necessárias, que é basicamente escolher um nome para o repositório e escolher se quer público ou privado, indico que deixe público mesmo e clique em "Creat repository".

Print da página de criar um novo repositório

  • Na página do repositório recém-criado, salve o link HTTPS gerado.

Print do link HTTPS

4. Configurando projeto local

Agora que você tem o link HTTPS do seu repositório, é hora de configurar seu projeto local. Estou usando o VSCode para isso.

  • Abra o terminal do seu projeto com o atalho Ctrl + ' ou Ctrl + j.

  • Inicie a pasta como um repositório do Git através do comando:

git init
Enter fullscreen mode Exit fullscreen mode

O git init é um comando do Git que cria um novo repositório Git em uma pasta existente. Em outras palavras, ele prepara uma pasta para que você possa começar a usar o Git para controlar as mudanças em seus arquivos.

5. Adicionando arquivos

Agora que você configurou o Git e iniciou o repositório, é hora de adicionar seus arquivos para preparar o commit. Para isso, utilize o seguinte comando no terminal do Visual Studio Code.

git add .
Enter fullscreen mode Exit fullscreen mode

6. Criando commit

Em seguida, crie um commit para os arquivos que você deseja subir para o repositório. Utilize o comando:

 git commit -m "primeiro commit"
Enter fullscreen mode Exit fullscreen mode

O comando git commit -m 'primeiro commit' é usado para salvar as mudanças que você fez no seu projeto em um registro permanente no Git. O texto dentro das aspas ("primeiro commit") é uma mensagem que você adiciona para explicar o que mudou no seu projeto desde o último commit.

O -m é de mensagem e ela ajuda outras pessoas a entenderem o que foi alterado e por que.

7. Subindo arquivos para o GitHub

Agora, é hora de subir seus arquivos para o GitHub. Lembra do link HTTPS que geramos no passo 3? Utilize o comando abaixo para adicionar o repositório remoto ao seu projeto local.

git remote add origin <link gerado> 
Enter fullscreen mode Exit fullscreen mode

O git remote add é a forma de dizer para o Git qual é o repositório remoto que deve ser usado para salvar as suas mudanças. É como se você estivesse indicando ao Git onde ele deve enviar as suas alterações para que elas possam ser salvas na nuvem.

8. Enviando arquivos para repositório remoto

Em seguida, utilize o comando:

git push -u origin master 
Enter fullscreen mode Exit fullscreen mode

Para enviar seus arquivos para o repositório remoto. Isso pode demorar um pouco, dependendo do tamanho dos arquivos, não se preocupe.

O git push é a forma de dizer ao Git que você quer enviar as suas mudanças para o repositório remoto. O -u significa "upstream", que é uma forma de definir o repositório remoto padrão para que você não precise digitar o nome do repositório toda vez que fizer o push.

O origin é o nome dado ao repositório remoto que você definiu anteriormente com o comando git remote add. Já o master é o nome da branch principal, onde geralmente estão as versões mais estáveis do seu código.

Prontinho! Agora você já pode visualizar seus arquivos no GitHub. Atualize a página do seu repositório e verá que eles estarão lá. Você pode usá-los para fazer deploy no GitHub Pages ou na Vercel. Muito legal, né?

Ah! Se você quiser enviar atualizações desse seu mesmo projeto, você não precisa fazer tudo isso de novo. Você só vai precisar usar os seguintes comandos para enviar as atualizações: git add ., git commit -m "mensagem do seu commit" e git push -u origin master.

É só lembrar de seguir essa ordem: adicionar as alterações, descrevê-las e enviá-las para o Github.

Espero que tenha te ajudado e comece a documentar o seu progresso no GitHub hoje mesmo. :)

Top comments (3)

Collapse
 
chuudoloonadev profile image
b

Finalmente um tutorial que consegui entender e seguir os passos, muito obrigada!!!

Collapse
 
miiluke profile image
lucas

Obrigado!!!! Me ajudou muito :))

Collapse
 
loresgarcia profile image
Lorena

aaah que bom :D