Pular para o conteúdo
IA-OS // subir-na-web
Curso de Introdução · Guia 3 de 3Colocar seu sistema na internet

ETAPA 3 DE 9ETAPA 3 DE 12ETAPA 3 20 MIN

Guardar o código no GitHub

Conta no GitHub com duas etapas, o GitHub CLI, um repositório privado e o primeiro push.

Seu computadorMeu computador é

O GitHub é o site onde o código fica guardado, com todo o histórico de commits. Os dois caminhos deste guia pegam o código de lá: cada vez que você manda uma mudança para o GitHub, o servidor publica sozinho.

O seu repositório vai ser privado: só você vê o código. O sistema no ar continua aberto para quem tiver o endereço; o que fica escondido é o código.

Criar a conta

Se você já tem conta no GitHub, pule para Ligar a verificação em duas etapas.

  1. Abra github.com/signup.
  2. Use o seu e-mail principal, uma senha forte e só sua (guarde no gerenciador de senhas) e escolha um nome de usuário. O nome de usuário aparece para todo mundo: use algo que você não se importe de mostrar.
  3. O GitHub manda um código para o seu e-mail. Digite na página para confirmar.
  4. Quando perguntar o plano, fique no Free (grátis). Ele já tem repositórios privados.

Ligar a verificação em duas etapas

Com as duas etapas, quem descobrir a sua senha ainda não entra: falta o código que só o seu celular gera. Numa conta que publica o seu sistema, isso não é opcional.

  1. No GitHub, clique na sua foto (canto de cima, à direita) e em Settings.
  2. No menu da esquerda, Password and authentication.
  3. Em Two-factor authentication, clique em Enable two-factor authentication.
  4. Escolha Authenticator app e leia o QR code com um aplicativo autenticador no celular (o Google Authenticator, o Microsoft Authenticator ou o do seu gerenciador de senhas). Digite o código de 6 números que o aplicativo mostra.
  5. O GitHub mostra os códigos de recuperação. Baixe e guarde junto com a senha, no gerenciador: eles são a única saída se você perder o celular.

Instalar o GitHub CLI

O GitHub CLI é o comando gh: com ele, o terminal cria o repositório e faz o login no GitHub sem você copiar endereço ou senha.

NO WINDOWS

No Windows PowerShell:

winget install --id GitHub.cli -e --source winget

Quando terminar, feche o PowerShell e abra de novo: o Windows só encontra o comando novo numa janela nova. Depois entre na pasta outra vez com cd ~/meu-primeiro-sistema.

NO MAC

No Terminal:

brew install gh

Ele já fica pronto na mesma janela.

Entrar no GitHub pelo terminal

gh auth login

Ele faz algumas perguntas. Use as setas para escolher e Enter para confirmar:

  1. Where do you use GitHub? → GitHub.com
  2. What is your preferred protocol for Git operations? → HTTPS
  3. Authenticate Git with your GitHub credentials? → Yes
  4. How would you like to authenticate GitHub CLI? → Login with a web browser

Ele mostra um código de uso único (como ABCD-1234) e pede Enter. O navegador abre no GitHub: entre na sua conta, cole o código e clique em Authorize. Volte ao terminal: ele termina com Logged in as e o seu nome de usuário.

O login fica guardado no cofre de senhas do sistema (o do Windows ou o Keychain do Mac), não num arquivo da pasta.

Criar o repositório privado e mandar o código

Dentro da pasta meu-primeiro-sistema, um comando só, igual nos dois sistemas:

gh repo create meu-primeiro-sistema --private --source=. --remote=origin --push

O que cada pedaço faz:

  • gh repo create meu-primeiro-sistema cria um repositório com esse nome na sua conta.
  • --private deixa o repositório privado. Não tire.
  • --source=. usa a pasta onde você está (o ponto quer dizer "aqui").
  • --remote=origin liga a pasta ao repositório com o nome origin, o nome de costume.
  • --push manda os seus commits para lá. Esse envio se chama push.

Ele responde com o endereço do repositório, algo como https://github.com/seu-usuario/meu-primeiro-sistema. Abra no navegador: os arquivos da demo estão lá, e ao lado do nome aparece Private.

Não deu certo? Veja o que fazer
  • gh não é reconhecido ou command not found: gh: no Windows, feche e abra o PowerShell de novo depois de instalar. No Mac, rode brew install gh outra vez e veja se termina sem erro.
  • Name already exists on this account: você já tem um repositório com esse nome. Troque o nome no comando, por exemplo meu-primeiro-sistema-2.
  • Unable to add remote "origin": a pasta ainda está ligada a outro repositório (o npm run comecar do guia anterior não rodou). Rode npm run comecar e depois o gh repo create de novo. O repositório já pode ter sido criado: se der Name already exists, rode só git remote add origin https://github.com/seu-usuario/meu-primeiro-sistema.git e git push -u origin main, trocando seu-usuario pelo seu.
  • A resposta foi PUBLIC: o --private ficou de fora. Deixe privado agora mesmo: gh repo edit --visibility private --accept-visibility-change-consequences.
  • shallow update not allowed: a pasta ainda está sem o histórico completo. Volte à etapa Atualizar a demo, rode o git pull de lá de novo (copiando a linha inteira, com o --depth=2147483647) e depois git push -u origin main.
  • git push pediu usuário e senha: o passo 3 do gh auth login ficou como No. Rode gh auth setup-git e tente de novo. Nunca digite a senha do GitHub no terminal.

Travou nesta etapa? Me conta o que aconteceu.

ESTE GUIA FAZ PARTE DE UM CURSO

Curso de Introdução

Três guias, na ordem, para sair do zero e ter o seu próprio sistema funcionando com a ajuda do Claude. Não precisa saber programar.

Este é o guia 3 de 3.

Ver o curso completo →