Como enviar um projeto existente para o GitHub
Introdução
GitHub é uma ferramenta de gerenciamento Git hospedada na nuvem. Git é um controle de versão distribuído, o que significa que todo o repositório e histórico ficam onde quer que você os coloque. As pessoas tendem a usar o GitHub em seus negócios ou fluxo de trabalho de desenvolvimento como uma solução de hospedagem gerenciada para backups de seus repositórios. O GitHub vai ainda mais longe, permitindo que você se conecte com colegas de trabalho, amigos, organizações e muito mais.
Neste tutorial, você aprenderá como pegar um projeto existente no qual está trabalhando e enviá-lo para que ele também exista no GitHub.
Como enviar um projeto existente para o GitHub
- Crie um novo repositório GitHub
- Inicialize o Git na pasta do projeto
- Inicialize o repositório Git
Implante seus aplicativos do GitHub usando DigitalOcean App Platform. Deixe a DigitalOcean se concentrar em dimensionar seu aplicativo.
Pré-requisitos
Para inicializar o repositório e enviá-lo ao GitHub, você precisará de:
- Uma conta GitHub gratuita
git
instalado em sua máquina local
Passo 1 — Crie um novo repositório GitHub
Faça login no GitHub e crie um novo repositório vazio. Você pode optar por inicializar um README ou não. Realmente não importa porque vamos substituir tudo neste repositório remoto de qualquer maneira.
Aviso: no restante deste tutorial, assumiremos que seu nome de usuário do GitHub é sammy
e o repositório que você criou se chama < mark>meu-novo-projeto
. É importante que você substitua esses espaços reservados pelo seu nome de usuário e nome do repositório reais.
Passo 2 — Inicialize o Git na pasta do projeto
No seu terminal, execute os seguintes comandos após navegar até a pasta que deseja adicionar.
Passo 3 – Inicialize o repositório Git
Certifique-se de estar no diretório raiz do projeto que deseja enviar para o GitHub e execute:
Nota: Se você já possui um repositório Git inicializado, você pode pular este comando.
git init
Esta etapa cria um diretório .git
oculto na pasta do projeto, que o software git
reconhece e usa para armazenar todos os metadados e histórico de versões do projeto.
Adicione os arquivos ao índice do Git
git add -A
O comando git add
é usado para informar ao git quais arquivos incluir em um commit, e o argumento -A
(ou --all
) significa "incluir tudo ".
Confirmar arquivos adicionados
git commit -m 'Added my project'
O comando git commit
cria um novo commit com todos os arquivos que foram “adicionados”. O -m
(ou --message
) define a mensagem que será incluída junto com o commit, usada para referência futura para entender o commit. Neste caso, a mensagem é: 'Adicionado meu projeto'
.
Adicione uma nova origem remota
git remote add origin git@github.com:sammy/my-new-project.git
Observação: Lembre-se de que você precisará substituir as partes destacadas do nome de usuário e do nome do repositório pelo seu próprio nome de usuário e nome do repositório.
No git, um “remoto” refere-se a uma versão remota do mesmo repositório, que normalmente está em um servidor em algum lugar (neste caso, GitHub). “Origem ” é o nome padrão que o git dá a um servidor remoto (você pode ter vários controles remotos), então git remote add origin
instrui o git a adicionar a URL do controle remoto padrão servidor para este repositório.
Enviar para GitHub
git push -u -f origin main
O sinalizador -u
(ou --set-upstream
) define a origem
remota como a referência upstream. Isso permite que você execute posteriormente os comandos git push
e git pull
sem precisar especificar uma origin
, pois sempre queremos o GitHub nesse caso.
O sinalizador -f
(ou --force
) significa force. Isso substituirá automaticamente tudo no diretório remoto. Estamos usando-o aqui para substituir o README padrão que o GitHub inicializou automaticamente.
Nota: se você não incluiu o README padrão ao criar o projeto no GitHub, o sinalizador -f
não é realmente necessário.
Todos juntos
git init
git add -A
git commit -m 'Added my project'
git remote add origin git@github.com:sammy/my-new-project.git
git push -u -f origin main
Implante um repositório GitHub na DigitalOcean
Agora que você tem seu repositório GitHub, basta um clique para implantar esse repositório e torná-lo ativo usando a DigitalOcean App Platform.
Conclusão
Agora, você está pronto para rastrear remotamente as alterações do seu código no GitHub! Como próxima etapa, use a série de tutoriais Introdução ao GitHub e projetos de código aberto para dominar o Github.
Você pode usar o Cheatsheet do Github e mantê-lo como referência.
Depois de começar a colaborar com outras pessoas no projeto, você vai querer saber como criar uma solicitação pull.