Skip to main content

Adicionando o código localmente hospedado no GitHub

Se o código for armazenado localmente no computador e for controlado pelo Git ou não controlado por nenhum VCS (sistema de controle de versão), você poderá importar o código para o GitHub usando a GitHub CLI ou os comandos Git.

Platform navigation

Sobre a adição do código-fonte existente para GitHub

Importar seu código-fonte para o GitHub facilita que você e outras pessoas trabalhem juntas em projetos e gerenciem códigos. O GitHub ajuda você a colaborar, controlar alterações e organizar tarefas, simplificando a criação e o gerenciamento de projetos. Para obter mais informações, confira "Sobre o GitHub e o Git".

Se você tiver um código-fonte armazenado localmente no computador que é controlado pelo Git ou não controlado por nenhum VCS (sistema de controle de versão), adicione o código ao GitHub digitando comandos em um terminal. Você pode fazer isso digitando comandos do Git diretamente ou usando GitHub CLI.

A GitHub CLI é uma ferramenta de código aberto para uso do GitHub na linha de comando do computador. GitHub CLI pode simplificar o processo de adicionar um projeto existente a GitHub usando a linha de comando. Para saber mais sobre GitHub CLI, confira "Sobre o a CLI do GitHub".

Observação: se você tiver mais familiaridade com uma interface de usuário de apontar e clicar, considere a possibilidade de adicionar seu projeto com o GitHub Desktop. Para obter mais informações, confira "Adicionar um repositório do computador local ao GitHub Desktop".

Se o código-fonte for controlado por um VCS diferente, como o Mercurial, o Subversion ou o Controle de Versão do Team Foundation, você precisará converter o repositório no Git para adicionar o projeto ao GitHub.

Aviso: nunca use git add, commit ou push com informações confidenciais para um repositório remoto. As informações confidenciais pode incluir, entre outros:

Para obter mais informações, confira "Remover dados confidenciais de um repositório".

Como inicializar um repositório Git

Se o código hospedado localmente não for controlado por nenhum VCS, a primeira etapa será inicializar um repositório Git. Se o projeto já for controlado pelo Git, vá para "Como importar um repositório Git com a linha de comando".

  1. Abra TerminalTerminalGit Bash.

  2. Navegue até o diretório raiz do projeto.

  3. Inicialize o diretório local como um repositório Git. Por padrão, o branch inicial é chamado main.

    Se estiver usando o Git 2.28.0 ou uma versão posterior, você poderá definir o nome do branch padrão usando -b.

    git init -b main
    

    Se estiver usando o Git 2.27.1 ou uma versão anterior, você poderá definir o nome do branch padrão usando git symbolic-ref.

    git init && git symbolic-ref HEAD refs/heads/main
    
  4. Adicione os arquivos ao novo repositório local. Isso faz stage deles para o primeiro commit.

    $ git add .
    # Adds the files in the local repository and stages them for commit. Para cancelar o preparo de um arquivo, use 'git reset HEAD ARQUIVO'.
    
  5. Faça commit dos arquivos com stage em seu repositório local.

    $ git commit -m "First commit"
    # Commits the tracked changes and prepares them to be pushed to a remote repository. Para remover esse commit e modificar o arquivo, use "git reset --soft HEAD~1", faça o commit e adicione o arquivo novamente.
    

Como importar um repositório Git com a linha de comando

Depois de inicializar um repositório Git, você poderá efetuar push do repositório para o GitHub usando a GitHub CLI ou o Git.

Como adicionar um repositório local ao GitHub com a GitHub CLI

  1. Para criar um repositório para seu projeto no GitHub, use o subcomando gh repo create. Quando solicitado, selecione Enviar um repositório local existente ao GitHub e digite o nome desejado para seu repositório. Caso você deseje que o seu projeto pertença a uma organização em vez da sua conta de usuário, especifique o nome da organização e o nome do projeto com organization-name/project-name.

  2. Siga as instruções interativas. Para adicionar o repositório remoto e efetuar push dele, confirme com Sim quando solicitado para adicionar o repositório remoto e efetuar push dos commits para o branch atual.

  3. Como alternativa, para ignorar todos os prompts, forneça o caminho para o repositório com o sinalizador --source e passe um sinalizador de visibilidade (--public, --private ou --internal). Por exemplo, gh repo create --source=. --public. Especifique um repositório remoto com o sinalizador --remote. Para enviar seus commits por push, passe o sinalizador --push. Para obter mais informações sobre os possíveis argumentos, confira o manual da GitHub CLI.

Como adicionar um repositório local ao GitHub usando o Git

Antes de adicionar seu repositório local a GitHub usando o Git, você deve autenticar em GitHub na linha de comando. Para obter mais informações, confira "Sobre a autenticação no GitHub".

  1. Crie um repositório no GitHub.com. Para evitar erros, não inicialize o novo repositório com arquivos LEIAME, de licença ou gitignore. É possível adicionar esses arquivos após push do projeto no GitHub. Para obter mais informações, confira "Criar um repositório".

  2. Na parte superior do repositório na página de Configuração Rápida de GitHub.com, clique em para copiar a URL do repositório remote.

    Captura de tela do cabeçalho "Configuração Rápida" em um repositório. Ao lado da URL do repositório remoto, um ícone de dois quadrados sobrepostos está realçado com um contorno laranja.

  3. Abra TerminalTerminalGit Bash.

  4. Altere o diretório de trabalho atual para seu projeto local.

  5. Para adicionar a URL do repositório remoto ao qual o repositório local será enviado, execute o seguinte comando. Substitua REMOTE-URL pela URL completa do repositório no GitHub.

    git remote add origin REMOTE-URL
    

    Para obter mais informações, confira "Gerenciar repositórios remote".

  6. Para verificar se você definiu a URL remota corretamente, execute o seguinte comando.

    git remote -v
    
  7. Para enviar as alterações em seu repositório local ao GitHub.com, execute o seguinte comando.

    git push -u origin main
    

    Se a ramificação padrão não for denominada "main", substitua "main" pelo nome da ramificação padrão. Para obter mais informações, confira "Sobre ramificações".

  1. Crie um repositório no GitHub.com. Para evitar erros, não inicialize o novo repositório com arquivos LEIAME, de licença ou gitignore. É possível adicionar esses arquivos após push do projeto no GitHub. Para obter mais informações, confira "Criar um repositório".

  2. Na parte superior do repositório na página de Configuração Rápida de GitHub.com, clique em para copiar a URL do repositório remote.

    Captura de tela do cabeçalho "Configuração Rápida" em um repositório. Ao lado da URL do repositório remoto, um ícone de dois quadrados sobrepostos está realçado com um contorno laranja.

  3. Abra TerminalTerminalGit Bash.

  4. Altere o diretório de trabalho atual para seu projeto local.

  5. Para adicionar a URL do repositório remoto ao qual o repositório local será enviado, execute o seguinte comando. Substitua REMOTE-URL pela URL completa do repositório no GitHub.

    git remote add origin REMOTE-URL
    

    Para obter mais informações, confira "Gerenciar repositórios remote".

  6. Para verificar se você definiu a URL remota corretamente, execute o seguinte comando.

    git remote -v
    
  7. Para enviar as alterações em seu repositório local ao GitHub.com, execute o seguinte comando.

    git push origin main
    

    Se a ramificação padrão não for denominada "main", substitua "main" pelo nome da ramificação padrão. Para obter mais informações, confira "Sobre ramificações".

  1. Crie um repositório no GitHub.com. Para evitar erros, não inicialize o novo repositório com arquivos LEIAME, de licença ou gitignore. É possível adicionar esses arquivos após push do projeto no GitHub. Para obter mais informações, confira "Criar um repositório".

  2. Na parte superior do repositório na página de Configuração Rápida de GitHub.com, clique em para copiar a URL do repositório remote.

    Captura de tela do cabeçalho "Configuração Rápida" em um repositório. Ao lado da URL do repositório remoto, um ícone de dois quadrados sobrepostos está realçado com um contorno laranja.

  3. Abra TerminalTerminalGit Bash.

  4. Altere o diretório de trabalho atual para seu projeto local.

  5. Para adicionar a URL do repositório remoto ao qual o repositório local será enviado, execute o seguinte comando. Substitua REMOTE-URL pela URL completa do repositório no GitHub.

    git remote add origin REMOTE-URL
    

    Para obter mais informações, confira "Gerenciar repositórios remote".

  6. Para verificar se você definiu a URL remota corretamente, execute o seguinte comando.

    git remote -v
    
  7. Para enviar as alterações em seu repositório local ao GitHub.com, execute o seguinte comando.

    git push origin main
    

    Se a ramificação padrão não for denominada "main", substitua "main" pelo nome da ramificação padrão. Para obter mais informações, confira "Sobre ramificações".

Leitura adicional