Minilição · Português

Como publicar seu site pelo GitHub

Publique a página fornecida a partir de um repositório de prática no GitHub e confirme que uma edição posterior chega ao site público.

Começar a aula interativaLer as notas da aula

Para quem é esta lição?

Para quem quer colocar um site no ar e atualizá-lo com confiança. Os arquivos do site já são fornecidos; você pode usar GitHub Desktop e um assistente de programação sem escrever comandos Git.

Antes de começar

Você precisa das suas contas GitHub e Netlify e do GitHub Desktop ou acesso equivalente. Use um repositório e um projeto de hospedagem separados para prática. A página P1 fornecida funciona mesmo sem a aula de site pessoal. As respostas resolvidas são exemplos ilustrativos, não testes realizados na sua conta. Troque as observações de exemplo pelos seus resultados ou indique a etapa que continua bloqueada.

Tempo estimado: 21–33 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. As estimativas não incluem instalar o GitHub Desktop, acessar contas e esperar filas de compilação. O uso da hospedagem depende da conta.

O que você vai aprender

  • Conecte um repositório de prática à hospedagem.
  • Publique uma alteração visível e verifique o resultado público.
  • Localize a etapa que falhou quando a página pública estiver desatualizada.

Arquivos da oficina

Etapa 1

Prepare uma página que consiga reconhecer

Use o site P1 pronto em vez de montar primeiro um site.

Abra os arquivos da oficina e salve index.html, style.css, netlify.toml e .gitignore na mesma pasta de projeto. Abra index.html no computador para ver a página P1 e peça ao assistente para colocar esses arquivos na raiz de um repositório de teste separado.

A página deve mostrar Portfolio version P1 de forma visível. Escolha um repositório e um projeto de hospedagem para prática, verificando que nenhum deles é outro site que já está em produção.

Um exemplo concreto

Use uma única pasta de prática contendo index.html, style.css, netlify.toml e .gitignore. O marcador Portfolio version P1 na página inicial permite reconhecer essa primeira versão depois.

Use o site P1 e os arquivos de publicação fornecidos. Ajude-me a colocá-los na raiz de um repositório de prática separado usando GitHub Desktop, verificar se há arquivos privados nas alterações e conectar o repositório ao meu próprio projeto de prática no Netlify. Pergunte antes de publicar. Explique como confirmar P1 na página pública e depois ajude-me a publicar uma pequena edição P2 sem alterar um site de produção existente.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Coloque seu site no ar pelo GitHub

Ao publicar, você copia uma versão dos seus arquivos para um serviço de hospedagem, onde outras pessoas podem acessá-los.

Sua página local, o repositório GitHub e a implantação na hospedagem são três lugares separados. Salvar localmente não atualiza automaticamente a página pública. Um commit registra uma versão; uma hospedagem conectada pode implantá-la.

Use um projeto novo de prática nesta lição. Garanta que a pasta contém a página inicial e a folha de estilos reais, não uma pasta superior com uma coleção de arquivos sem relação.

Para verificar visualmente a versão, acrescente o parágrafo “Portfolio version P1” antes do primeiro commit. Na tarefa final, mude para P2 junto com sua alteração relevante de conteúdo. O marcador ajuda a comparar arquivo local, commit remoto e página implantada sem adivinhar qual cópia está aberta.

Exemplo resolvido

Alex acrescenta a frase visível “Portfolio version P1”. Essa frase e o ID do commit permitem distinguir uma implantação bem-sucedida de um navegador que ainda mostra a versão antiga.

Extra implementation exercise

Você salvou P1 localmente, mas a página hospedada ainda diz P0. Quais duas etapas de publicação podem estar faltando?

Mostrar uma solução comentada

Confira primeiro o repositório e depois o registro de implantação. Atualizar o navegador não publica uma mudança que nunca chegou à hospedagem.

  • Verifica se a alteração foi registrada em commit e enviada.
  • Verifica se uma implantação bem-sucedida usou esse commit.

Etapa 2

Revise e envie a alteração ao GitHub

Verifique a lista de arquivos antes de publicá-la.

No GitHub Desktop, revise os arquivos alterados com seu assistente. Faça um commit dos arquivos de site pretendidos e envie a branch de prática com push quando estiver pronto. Mantenha arquivos de ambiente e segredos de conta fora do repositório.

Abra o repositório no GitHub e confirme que a página inicial pretendida está na raiz. Se aparecer um arquivo privado nas alterações, remova-o antes de enviar qualquer coisa.

Um exemplo concreto

Confira a lista de arquivos alterados antes de enviá-los. index.html e style.css pertencem à página pública; um arquivo privado .env, não. Depois do push, confira os arquivos remotos em vez de presumir que salvar localmente já chegou ao GitHub.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Coloque os arquivos certos no repositório

Registre um conjunto pequeno de arquivos públicos do site e examine-o antes de enviar.

Caminho guiado: crie um repositório de prática no GitHub e use File → Clone repository no GitHub Desktop para cloná-lo em uma nova pasta local. Acrescente primeiro o .gitignore fornecido à pasta clonada. Depois copie apenas os arquivos públicos do site, com index.html na raiz, e examine as mudanças antes de prepará-las e registrá-las em commit.

No GitHub Desktop, examine Changes e as diferenças, escreva um resumo, faça o commit na branch pretendida e escolha Push origin. Se aparecer Publish branch, publique a branch no remoto. O exemplo de linha de comando é uma alternativa para um clone já inicializado. Uma regra de exclusão Git não remove um segredo já registrado. Se expuser uma chave real, revogue-a e corrija o repositório; excluir o arquivo atual não basta.

Exemplo resolvido

A lista de comandos prepara arquivos específicos do site, não todos os arquivos do computador. Depois mostra a alteração preparada para você verificar o conteúdo do commit.

git add index.html style.css netlify.toml .gitignore
git diff --cached
git commit -m "Add personal website"

Extra implementation exercise

As diferenças preparadas incluem .env com uma chave de serviço. O que fazer antes de enviar?

Mostrar uma solução comentada

Retire o arquivo da área de preparação, mantenha-o fora do controle de versão e examine as diferenças novamente. Se a chave chegou a um remoto ou a outras pessoas, revogue-a em vez de supor que uma regra de exclusão a tornou privada.

Antes de enviar, examine as diferenças preparadas novamente. Se o repositório já tinha commits, examine o histórico e o remoto em busca da credencial sem copiar o valor para um relatório. Faça a rotação de qualquer chave real exposta; acrescentar .gitignore não apaga uma exposição anterior.

  • Retira o arquivo secreto das alterações preparadas.
  • Verifica se a credencial já foi exposta e faz a rotação quando necessário.

Etapa 3

Conecte o repositório à hospedagem

Faça o provedor publicar a pasta que contém a página inicial.

Crie ou escolha seu projeto de prática separado no Netlify e conecte o repositório e a branch pretendidos. Para este site simples fornecido, use a configuração de publicação incluída; não é necessária uma compilação de framework.

Espere o provedor informar que a implantação foi concluída. Abra a URL pública numa janela privada e procure P1; uma indicação de sucesso no painel, por si só, não confirma a página correta.

Um exemplo concreto

Página local: P1. GitHub: P1. A hospedagem informa que publicou, mas a URL pública mostra 404. O próximo passo é verificar se o serviço está publicando a pasta que realmente contém index.html.

Netlify: criar implantações

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Conecte a hospedagem e escolha a pasta de publicação

A hospedagem precisa saber qual repositório usar e qual pasta contém os arquivos públicos.

Na sua conta Netlify, crie um projeto a partir do repositório de prática e escolha a branch de produção pretendida. Autorize apenas o acesso necessário. Para HTML simples, deixe o comando de compilação vazio e publique a raiz do repositório.

O netlify.toml fornecido torna a raiz explícita. Um projeto com framework usaria a saída de compilação do próprio framework; não copie esta configuração para outro projeto sem conferir a estrutura.

Confira a árvore de pastas antes de configurar: raiz do repositório → index.html e style.css. Para este caminho de HTML simples, publish='.' combina com nenhum comando de compilação. A pasta-fonte de um framework não é automaticamente sua saída publicável; as instruções de compilação determinam essa saída.

Exemplo resolvido

Se a raiz contém index.html, publicar “.” serve esse arquivo como página inicial. Publicar uma pasta sem a página inicial compilada pode produzir uma implantação cuja raiz retorna 404.

[build]
  publish = "."

Netlify: criar implantações

Extra implementation exercise

A implantação tem sucesso, mas a página inicial retorna 404. Qual arquivo e configuração você deve comparar?

Mostrar uma solução comentada

Confirme que o diretório selecionado contém index.html. Um envio bem-sucedido não prova que a pasta certa foi enviada.

  • Encontra index.html no repositório ou na saída real da compilação.
  • Compara essa localização com o diretório de publicação.

Etapa 4

Investigue uma página pública desatualizada

Compare o repositório, o registro da hospedagem e o resultado no navegador.

Faça uma pequena edição de conteúdo e identifique a página como P2 com seu assistente. Salve, faça commit e push e depois examine a implantação correspondente na hospedagem. Guarde o registro P1 anterior para comparação.

Verifique qual versão está no GitHub, qual foi implantada pelo provedor e o que a URL pública solicitada mostra. Atualizar o navegador não envia uma edição que ainda não recebeu push.

Um exemplo concreto

GitHub P2 → hospedagem P1 → público P1 aponta para a etapa de publicação. GitHub P2 → hospedagem P2 → público P1 exige conferir a URL solicitada e a resposta entregue. A mesma aparência de página antiga pode ter causas diferentes.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Relacione a página no ar ao commit

Verifique a versão implantada e a experiência do visitante, não apenas um indicador verde.

Abra a URL pública da hospedagem em uma janela privada. Confirme que a página inicial e os estilos carregam sem sua sessão de proprietário. Clique nos links internos e confira o marcador P1.

Compare o commit registrado pela hospedagem com o último commit pretendido do repositório. Uma página desatualizada pode vir de implantação antiga, branch inesperada ou cache. Use as observações para escolher a próxima verificação.

Exemplo resolvido

Um registro útil contém commit, URL da implantação e marcador visível. Se a implantação lista o commit P1, mas a página contém P0, examine a URL solicitada e a resposta antes de mudar configurações aleatórias de compilação.

Extra implementation exercise

O repositório contém P2, mas o registro da implantação indica P1. Isso é principalmente um problema de atualizar o navegador?

Mostrar uma solução comentada

Não. Investigue por que a hospedagem não implantou o commit P2. Só diagnostique o cache do navegador depois de confirmar que a versão pretendida está realmente implantada.

  • Identifica que P2 não foi implantado.
  • Verifica a branch selecionada e o resultado da última compilação.

Etapa 5

Publique e verifique P2

Conclua com uma atualização pública real que você consiga identificar.

Publique a alteração P2 pelo mesmo percurso de prática. Abra o endereço final sem sessão iniciada e experimente o link ou conteúdo afetado. Guarde as identificações de alteração e implantação de P1 e P2 fornecidas pelas ferramentas.

Verifique a identificação e a funcionalidade realmente alterada, não apenas um ícone verde de implantação. Indique qualquer etapa que não conseguiu concluir.

Um exemplo concreto

Uma entrega útil de P2 reúne três elementos: a alteração correspondente no repositório, o registro da hospedagem e a frase nova visível. Um ícone verde sem o conteúdo público esperado deixa a última etapa sem verificação.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sua tarefa: publicar uma segunda versão

Mostre que o fluxo de publicação funciona novamente depois da primeira versão bem-sucedida.

Faça uma mudança visível relevante, como acrescentar a descrição de um projeto. Registre em commit e envie pelo seu próprio repositório. Espere a implantação correspondente e depois verifique a página pública.

Guarde os dois registros de versão. Você usará a ligação entre commits e implantações ao aprender prévias e reversões.

Exemplo resolvido

Seu registro de antes e depois deve dizer o que mudou e identificar os dois commits. Só a URL pública não identifica qual versão alguém viu.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Extra implementation exercise

Publique P2 e forneça evidências de que a hospedagem serve o commit pretendido.

  1. Altere um elemento visível, atualize o marcador de P1 para P2 e examine as diferenças.
  2. Faça o commit e envie; encontre a implantação correspondente.
  3. Teste a URL pública e registre o novo marcador.
Mostrar uma solução comentada

Antes do primeiro commit, coloque 'Portfolio version P1' em um parágrafo visível. Salve, examine as diferenças em Changes no GitHub Desktop, registre apenas index.html/style.css/netlify.toml/.gitignore e envie a branch pretendida. Na visualização de arquivos do GitHub, confirme que os quatro arquivos estão na raiz.

Registre o ID do commit como P1. No Netlify, selecione o mesmo repositório e branch, deixe a compilação vazia e use publish='.'. Relacione o commit da implantação bem-sucedida a P1, abra a URL pública desconectado e leia o marcador. Mude para P2, repita commit, envio e implantação e guarde os dois registros.

Um diagnóstico útil é: repositório=P2, implantação=P1, marcador público=P1 → investigar branch, compilação e estado da implantação. Outro caso é implantação=P2, marcador=P1 → primeiro examinar o host solicitado, a resposta e o cache. Não publique um segredo para testar se o Git consegue escondê-lo; examine as diferenças preparadas e qualquer histórico antes de enviar.

  • O conteúdo público corresponde à alteração P2 e ao commit registrado.
  • Página inicial, CSS e navegação funcionam sem acesso de proprietário.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições