{"id":37127,"date":"2025-02-04T18:08:45","date_gmt":"2025-02-04T21:08:45","guid":{"rendered":"https:\/\/www.locaweb.com.br\/ajuda\/?post_type=ht_kb&#038;p=37127"},"modified":"2025-02-04T18:08:45","modified_gmt":"2025-02-04T21:08:45","slug":"configurar-github","status":"publish","type":"ht_kb","link":"https:\/\/www.locaweb.com.br\/ajuda\/wiki\/configurar-github\/","title":{"rendered":"Como configurar o GitHub em 5 passos?"},"content":{"rendered":"<p>O GitHub \u00e9 uma plataforma poderosa para hospedagem de c\u00f3digo-fonte e colabora\u00e7\u00e3o em projetos. Neste artigo, vamos explorar <strong>como configurar o GitHub<\/strong> e daremos os passos iniciais para usar essa ferramenta de maneira eficiente.<\/p>\n<p>Vamos abordar desde a instala\u00e7\u00e3o at\u00e9 o upload do seu primeiro projeto. Prepare-se para aprender tudo o que voc\u00ea precisa para come\u00e7ar a usar o <a href=\"https:\/\/www.locaweb.com.br\/blog\/temas\/codigo-aberto\/github\/\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub<\/a>!<\/p>\n<h2>1. Pr\u00e9-requisitos para configurar o GitHub<\/h2>\n<p>Antes de mais nada, vamos garantir que voc\u00ea tenha tudo o que precisa para configurar o GitHub corretamente. Veja, a seguir, os dois primeiros passos.<\/p>\n<h3>Instalar o Git<\/h3>\n<p>Para usar o GitHub, o primeiro passo \u00e9 instalar o Git em sua m\u00e1quina.<\/p>\n<p>O Git \u00e9 um sistema de controle de vers\u00e3o que permite que voc\u00ea acompanhe as mudan\u00e7as nos arquivos do seu projeto ao longo do tempo. Ele \u00e9 fundamental para trabalhar com o GitHub.<\/p>\n<p>Passo a passo para instalar o Git:<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Acesse o <a href=\"https:\/\/git-scm.com\/downloads\" target=\"_blank\" rel=\"noopener noreferrer\">site oficial do Git<\/a>;<\/li>\n<li>Baixe o instalador adequado para o seu sistema operacional (Windows, macOS ou Linux);<\/li>\n<li>Siga as instru\u00e7\u00f5es de instala\u00e7\u00e3o padr\u00e3o;<\/li>\n<li>Ap\u00f3s a instala\u00e7\u00e3o, abra o terminal ou Git Bash (a depender do seu sistema) e execute o comando: <em>git &#8211;version.<\/em><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<p>Se tudo estiver correto, <strong>voc\u00ea ver\u00e1 a vers\u00e3o do Git instalada<\/strong>.<\/p>\n<h3>Criar uma conta no GitHub<\/h3>\n<p>Agora que voc\u00ea tem o Git instalado, o pr\u00f3ximo passo \u00e9 criar uma conta no GitHub. Isso \u00e9 necess\u00e1rio para voc\u00ea poder hospedar os seus projetos e colaborar com outras pessoas desenvolvedoras.<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Acesse o <a href=\"https:\/\/github.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">site do GitHub<\/a>;<\/li>\n<li>Clique em &#8220;Sign up&#8221; e preencha as suas informa\u00e7\u00f5es de cadastro;<\/li>\n<li>Ap\u00f3s criar a sua conta, voc\u00ea poder\u00e1 configurar e criar reposit\u00f3rios no GitHub.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h2>2. Configura\u00e7\u00e3o do Git local<\/h2>\n<p>Agora que voc\u00ea tem o Git instalado e j\u00e1 possui a sua conta no GitHub, \u00e9 hora de configurar o sistema em sua m\u00e1quina local.<\/p>\n<h3>Configurar nome de usu\u00e1rio e e-mail<\/h3>\n<p>Uma das primeiras coisas a se fazer ap\u00f3s instalar o Git \u00e9 configurar o seu nome de usu\u00e1rio e e-mail. Esses dados ser\u00e3o usados para <strong>associar os commits que voc\u00ea realizar ao seu perfil no GitHub<\/strong>.<\/p>\n<p>Abra o Git Bash e execute os seguintes comandos:<\/p>\n<pre><em>git config --global user.name \"Seu Nome\"<\/em>\r\n\r\n<em>git config --global user.email \"seuemail@exemplo.com\"<\/em><\/pre>\n<p>Esses dados ficam registrados no Git e qualquer commit que voc\u00ea fizer ter\u00e1 essas informa\u00e7\u00f5es.<\/p>\n<h3>Verificar a instala\u00e7\u00e3o e a configura\u00e7\u00e3o inicial<\/h3>\n<p>Ap\u00f3s configurar o seu nome e e-mail, \u00e9 bom verificar se tudo foi configurado corretamente. Execute o seguinte comando para <strong>checar as configura\u00e7\u00f5es<\/strong>: <em>git config &#8211;list.<\/em><\/p>\n<p>Esse comando vai mostrar todas as configura\u00e7\u00f5es do Git, como seu nome, e-mail e outros par\u00e2metros.<\/p>\n<h2>3. Gerar e adicionar uma chave SSH<\/h2>\n<p>Uma das maneiras mais seguras de se conectar ao GitHub \u00e9 por meio de uma chave SSH. Isso<strong> elimina a necessidade de digitar a sua senha todas as vezes<\/strong> que for interagir com o GitHub.<\/p>\n<h3>Gerar a chave SSH<\/h3>\n<p>Para gerar uma chave SSH, execute o seguinte comando no terminal:<\/p>\n<pre><em>ssh-keygen -t rsa -b 4096 -C \"seuemail@exemplo.com\"<\/em><\/pre>\n<p>Esse comando cria uma<strong> chave SSH com seguran\u00e7a de 4096 bits<\/strong> e associa essa chave ao seu e-mail.<\/p>\n<h3>Adicionar a chave SSH ao GitHub<\/h3>\n<p>Depois de gerar a chave, voc\u00ea precisa adicion\u00e1-la \u00e0 sua conta no GitHub. Para isso, execute o seguinte comando para <strong>visualizar a chave p\u00fablica gerada<\/strong>:<\/p>\n<pre><em>cat ~\/.ssh\/id_rsa.pub.<\/em><\/pre>\n<p>Copie a chave gerada e, em seguida, siga os seguintes passos no GitHub:<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Acesse as configura\u00e7\u00f5es da sua conta no GitHub;<\/li>\n<li>V\u00e1 at\u00e9 &#8220;SSH and GPG keys&#8221;;<\/li>\n<li>Clique em &#8220;New SSH key&#8221;, cole a chave copiada e salve.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<p>Agora voc\u00ea pode se conectar ao GitHub de forma segura com a sua chave SSH.<\/p>\n<h2>4. Criar e conectar um reposit\u00f3rio<\/h2>\n<p>Agora que voc\u00ea tem o Git configurado e a chave SSH instalada, o pr\u00f3ximo passo \u00e9 criar um reposit\u00f3rio local e conect\u00e1-lo ao seu reposit\u00f3rio no GitHub.<\/p>\n<h3>Criar um reposit\u00f3rio local<\/h3>\n<p>Para criar um reposit\u00f3rio local, <strong>escolha uma pasta no seu computador<\/strong> e execute os seguintes comandos:<\/p>\n<pre><em>cd caminho\/da\/pasta<\/em>\r\n\r\n<em>git init<\/em><\/pre>\n<p>Isso vai criar um novo reposit\u00f3rio Git dentro dessa pasta. Agora, voc\u00ea pode come\u00e7ar a adicionar arquivos e fazer commits.<\/p>\n<h3>Ligar o reposit\u00f3rio local ao GitHub<\/h3>\n<p>Para conectar o seu reposit\u00f3rio local ao GitHub, voc\u00ea precisa criar um reposit\u00f3rio remoto.<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Acesse a sua conta no GitHub;<\/li>\n<li>Clique em &#8220;New Repository&#8221; e crie um novo reposit\u00f3rio;<\/li>\n<li>No seu terminal, adicione o reposit\u00f3rio remoto com o seguinte comando:<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<pre><em>git remote add origin git@github.com:seunome\/nome-do-repositorio.git<\/em><\/pre>\n<p>Agora, o seu reposit\u00f3rio local est\u00e1 conectado ao reposit\u00f3rio no GitHub.<\/p>\n<h2>5. Subir o seu primeiro projeto ao GitHub<\/h2>\n<p>Chegou a hora de colocar o seu c\u00f3digo no GitHub! Vamos ver os passos necess\u00e1rios para subir o seu primeiro projeto.<\/p>\n<h3>Adicionar arquivos ao reposit\u00f3rio<\/h3>\n<p>Primeiro, adicione os arquivos do seu projeto ao reposit\u00f3rio local:<\/p>\n<pre><em>git add.<\/em><\/pre>\n<p>Isso incluir\u00e1 todos os arquivos da pasta nesse reposit\u00f3rio.<\/p>\n<h3>Realizar o commit das mudan\u00e7as<\/h3>\n<p>Depois de adicionar os arquivos, o pr\u00f3ximo passo \u00e9 fazer um commit. O commit \u00e9 como<strong> tirar uma &#8220;foto&#8221; das altera\u00e7\u00f5es feitas no c\u00f3digo<\/strong>:<\/p>\n<pre><em>git commit -m \"Meu primeiro commit\".<\/em><\/pre>\n<p>O par\u00e2metro <em>-m<\/em> permite que voc\u00ea adicione uma mensagem para explicar as mudan\u00e7as feitas.<\/p>\n<h3>Subir (push) o projeto ao GitHub<\/h3>\n<p>Agora, para enviar o seu c\u00f3digo para o GitHub, use o comando:<\/p>\n<pre><em>git push -u origin master.<\/em><\/pre>\n<p>Isso vai enviar o seu c\u00f3digo para o reposit\u00f3rio remoto.<\/p>\n<h2>O que \u00e9 GitHub e por que us\u00e1-lo?<\/h2>\n    \t\t<div class=\"hts-toggle  \"  >\r\n    \t\t\t<div class=\"hts-toggle__title\">Clique aqui: <em>O que \u00e9 GitHub e por que us\u00e1-lo?<\/em><\/div>\r\n    \t\t\t<div class=\"hts-toggle__content\">\r\n    \t\t\t\t<div class=\"hts-toggle__contentwrap\">\r\n    \t\t\t\t\t<\/p>\n<p>O GitHub \u00e9 uma <strong>plataforma popular de hospedagem de c\u00f3digo<\/strong> que facilita o armazenamento e a colabora\u00e7\u00e3o em projetos de software.<\/p>\n<p>Por meio do Git, um sistema de controle de vers\u00e3o, ele permite que os times de desenvolvimento acompanhem as altera\u00e7\u00f5es em seus projetos ao longo do tempo.<\/p>\n<p>O GitHub <strong>facilita a colabora\u00e7\u00e3o entre equipes<\/strong> e permite a cria\u00e7\u00e3o de reposit\u00f3rios para gerenciar e compartilhar c\u00f3digo com outras pessoas que programam.<\/p>\n<p>Al\u00e9m disso, ele oferece recursos como forks, pull requests e issues, que ajudam a organizar o desenvolvimento em equipe.<\/p>\n<p>Uma das principais vantagens do GitHub \u00e9 a possibilidade de <a href=\"https:\/\/www.locaweb.com.br\/hospedagem-de-sites-com-dominio-gratis\/\" target=\"_blank\" rel=\"noopener noreferrer\">hospedagem de sites<\/a> diretamente na plataforma com o GitHub Pages, o que permite que voc\u00ea publique sites est\u00e1ticos de maneira simples e gratuita.<\/p>\n<p>A integra\u00e7\u00e3o com a <a href=\"https:\/\/www.locaweb.com.br\/cloud\/cloud-server-pro\/\" target=\"_blank\" rel=\"noopener noreferrer\">cloud server<\/a> do GitHub <strong>garante acesso ao c\u00f3digo de qualquer lugar<\/strong>, o que facilita o trabalho remoto e o gerenciamento de projetos em qualquer dispositivo conectado \u00e0 internet.<\/p>\n<p>\n    \t\t\t\t<\/div>\r\n    \t\t\t<\/div><!-- \/ht-toggle-content -->\r\n    \t\t<\/div>\r\n    \t\t\n<h2>Git vs GitHub: entenda a diferen\u00e7a<\/h2>\n    \t\t<div class=\"hts-toggle  \"  >\r\n    \t\t\t<div class=\"hts-toggle__title\">Clique aqui: <em>Git vs GitHub: entenda a diferen\u00e7a<\/em><\/div>\r\n    \t\t\t<div class=\"hts-toggle__content\">\r\n    \t\t\t\t<div class=\"hts-toggle__contentwrap\">\r\n    \t\t\t\t\t<\/p>\n<p>Git e GitHub s\u00e3o ferramentas essenciais no mundo do desenvolvimento de software, mas com fun\u00e7\u00f5es distintas. <strong>Git \u00e9 um sistema de controle de vers\u00f5es<\/strong>, uma ferramenta local usada para rastrear altera\u00e7\u00f5es no c\u00f3digo-fonte ao longo do tempo.<\/p>\n<p>Ele permite que os times de desenvolvimento fa\u00e7am altera\u00e7\u00f5es em seus projetos, revertam mudan\u00e7as e colaborem de forma eficiente ao manter o hist\u00f3rico completo de modifica\u00e7\u00f5es.<\/p>\n<p><strong>O GitHub \u00e9 uma plataforma baseada na web que hospeda reposit\u00f3rios Git.<\/strong> Ele oferece funcionalidades extras, como colabora\u00e7\u00e3o em tempo real, controle de vers\u00f5es compartilhadas e integra\u00e7\u00e3o com outras ferramentas.<\/p>\n<p>Embora o Git seja usado no computador local para gerenciar o c\u00f3digo, o GitHub facilita o compartilhamento e a colabora\u00e7\u00e3o online, o que torna o trabalho em equipe mais organizado e acess\u00edvel.<\/p>\n<p>Portanto, <strong>Git \u00e9 o &#8220;motor&#8221; de controle de vers\u00f5es, e o GitHub \u00e9 o &#8220;local&#8221;<\/strong> em que os projetos podem ser compartilhados e gerenciados colaborativamente.<\/p>\n<p>\n    \t\t\t\t<\/div>\r\n    \t\t\t<\/div><!-- \/ht-toggle-content -->\r\n    \t\t<\/div>\r\n    \t\t\n<h2>Conclus\u00e3o e boas pr\u00e1ticas no uso do GitHub<\/h2>\n    \t\t<div class=\"hts-toggle  \"  >\r\n    \t\t\t<div class=\"hts-toggle__title\">Clique aqui: <em>Conclus\u00e3o e boas pr\u00e1ticas no uso do GitHub<\/em><\/div>\r\n    \t\t\t<div class=\"hts-toggle__content\">\r\n    \t\t\t\t<div class=\"hts-toggle__contentwrap\">\r\n    \t\t\t\t\t<\/p>\n<p>Agora que voc\u00ea aprendeu como configurar o GitHub, pode come\u00e7ar a usar essa ferramenta poderosa em seus projetos. Mas, al\u00e9m de configurar, \u00e9 importante seguir algumas boas pr\u00e1ticas para garantir que o seu trabalho seja eficiente e organizado.<\/p>\n<h3>Dicas para manter o seu reposit\u00f3rio organizado<\/h3>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li><strong>Use branches<\/strong>: crie branches para trabalhar em diferentes funcionalidades ou corre\u00e7\u00f5es sem afetar o c\u00f3digo principal;<\/li>\n<li><strong>Fa\u00e7a commits pequenos e frequentes<\/strong>: isso facilita o rastreamento de altera\u00e7\u00f5es e a colabora\u00e7\u00e3o;<\/li>\n<li><strong>Adicione um arquivo README<\/strong>: explique o que seu projeto faz, como us\u00e1-lo e como contribuir;<\/li>\n<li><strong>Mantenha um hist\u00f3rico de commits claro<\/strong>: evite mensagens vagas e use descri\u00e7\u00f5es significativas para que todos possam entender rapidamente o prop\u00f3sito de cada altera\u00e7\u00e3o;<\/li>\n<li><strong>Evite arquivos grandes ou desnecess\u00e1rios<\/strong>: mantenha o seu reposit\u00f3rio leve e focado ao evitar adicionar arquivos que n\u00e3o s\u00e3o essenciais para o projeto;<\/li>\n<li><strong>Organize o seu c\u00f3digo com pastas e conven\u00e7\u00f5es<\/strong>: crie uma estrutura de pastas clara e siga conven\u00e7\u00f5es de nomea\u00e7\u00e3o para facilitar a navega\u00e7\u00e3o e a manuten\u00e7\u00e3o do c\u00f3digo.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<p>Ao seguir essas boas pr\u00e1ticas, voc\u00ea garante que o seu reposit\u00f3rio seja eficiente e f\u00e1cil de trabalhar, tanto para voc\u00ea quanto para outras pessoas que colaboram. Com isso, o seu projeto se torna mais organizado e o processo de desenvolvimento mais \u00e1gil.<\/p>\n<p>\n    \t\t\t\t<\/div>\r\n    \t\t\t<\/div><!-- \/ht-toggle-content -->\r\n    \t\t<\/div>\r\n    \t\t\n<h3>Manter o reposit\u00f3rio atualizado<\/h3>\n    \t\t<div class=\"hts-toggle  \"  >\r\n    \t\t\t<div class=\"hts-toggle__title\">Clique aqui: <em>Manter o reposit\u00f3rio atualizado<\/em><\/div>\r\n    \t\t\t<div class=\"hts-toggle__content\">\r\n    \t\t\t\t<div class=\"hts-toggle__contentwrap\">\r\n    \t\t\t\t\t<\/p>\n<p>Manter o seu reposit\u00f3rio no GitHub sempre atualizado \u00e9 essencial para garantir o bom andamento do seu projeto e facilitar a colabora\u00e7\u00e3o.<\/p>\n<p>Entre outras a\u00e7\u00f5es, voc\u00ea deve sincronizar frequentemente o seu c\u00f3digo com o reposit\u00f3rio remoto, por meio de comandos, como<\/p>\n<pre><em>git pull<\/em><\/pre>\n<p>para baixar as \u00faltimas atualiza\u00e7\u00f5es feitas por outras pessoas desenvolvedoras, e<\/p>\n<pre><em>git push<\/em><\/pre>\n<p>para enviar as suas mudan\u00e7as para o GitHub.<\/p>\n<p>Manter essa sincroniza\u00e7\u00e3o em dia <strong>evita diverg\u00eancias e facilita a integra\u00e7\u00e3o do c\u00f3digo<\/strong>.<\/p>\n<p>Al\u00e9m disso, \u00e9 fundamental fazer merge de branches quando for necess\u00e1rio integrar novas funcionalidades ou corre\u00e7\u00f5es ao c\u00f3digo principal. Ao fazer o merge, \u00e9 importante testar o c\u00f3digo para garantir que tudo funcione corretamente.<\/p>\n<p>Outro ponto essencial \u00e9 resolver conflitos de maneira r\u00e1pida e eficaz. Quando duas pessoas alteram a mesma parte do c\u00f3digo, podem ocorrer conflitos, e resolv\u00ea-los prontamente evita problemas no futuro.<\/p>\n<p>Manter o reposit\u00f3rio atualizado tamb\u00e9m<strong> facilita a colabora\u00e7\u00e3o<\/strong> e garante que todos os membros da equipe trabalhem com a vers\u00e3o mais recente do c\u00f3digo, o que melhora a efici\u00eancia e a qualidade do trabalho coletivo.<\/p>\n<p>Voc\u00ea pensa em come\u00e7ar a <a href=\"https:\/\/www.locaweb.com.br\/blog\/temas\/primeiros-passos\/trabalhar-como-freelancer-online\/\" target=\"_blank\" rel=\"noopener noreferrer\">trabalhar como freelancer de desenvolvimento<\/a>? Leia o nosso artigo e descubra como organizar os seus projetos e conquistar clientes!<\/p>\n<p>\n    \t\t\t\t<\/div>\r\n    \t\t\t<\/div><!-- \/ht-toggle-content -->\r\n    \t\t<\/div>\r\n    \t\t\n","protected":false},"excerpt":{"rendered":"<p>O GitHub \u00e9 uma plataforma poderosa para hospedagem de c\u00f3digo-fonte e colabora\u00e7\u00e3o em projetos. Neste artigo, vamos explorar como configurar o GitHub e daremos os passos iniciais para usar essa ferramenta de maneira eficiente. Vamos abordar desde a instala\u00e7\u00e3o at\u00e9 o upload do seu primeiro projeto. Prepare-se para aprender tudo&#8230;<\/p>\n","protected":false},"author":50,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[118],"ht-kb-tag":[],"class_list":["post-37127","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-vps-locaweb"],"_links":{"self":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/37127","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/users\/50"}],"replies":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/comments?post=37127"}],"version-history":[{"count":1,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/37127\/revisions"}],"predecessor-version":[{"id":37128,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/37127\/revisions\/37128"}],"wp:attachment":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/media?parent=37127"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-category?post=37127"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-tag?post=37127"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}