1. Achei que depois do Excel vinha um site. Por que apareceu um centro logístico?
Quem trabalhou principalmente com planilhas entra no desenvolvimento web e pergunta:
Eu não queria só publicar um site?
HTML ainda parece razoável.
Então aparecem Git, GitHub, repository, branch, commit, build, deploy, Worker, D1, KV, DNS, CDN e CI/CD.
Você sai da vila inicial e, no lugar de um inimigo fraco, encontra “Introdução a Sistemas Distribuídos”.
A confusão tem uma causa estrutural. No Excel, muita coisa termina dentro do mesmo aplicativo. Em um serviço web, escrever, armazenar, transformar, executar, distribuir e registrar são camadas separadas.
2. O problema real não é dificuldade. São camadas puladas
Não existe uma única trilha de estudo, mas conceitualmente as camadas costumam crescer assim:
- escrever arquivos
- controlar mudanças com Git
- guardar e colaborar no GitHub
- fazer build
- fazer deploy
- executar APIs
- conectar banco de dados
- automatizar
- tratar retry e falhas
Com IA e templates, hoje alguém pode ir do passo 1 ao 9 muito rápido.
É ótimo.
Mas a cabeça não consegue acompanhar.
Ontem você aprendeu “GitHub guarda código”. Hoje alguém diz “Workers Builds root”, “D1 binding” e “KV tem eventual consistency”.
É como aprender a usar uma geladeira e, no dia seguinte, administrar a logística de uma fábrica de alimentos.
3. O que é GitHub? Um depósito de projetos com histórico
O centro do GitHub é gerenciar arquivos e alterações em repositórios Git.
Um projeto web pode conter artigos, HTML, CSS, JavaScript, configuração, testes e scripts.
Commits registram o que mudou e quando.
Modelo simples:
GitHub = depósito de projetos + histórico de alterações
GitHub Pages também pode hospedar sites estáticos e GitHub Actions pode automatizar build, testes e deploy.
Por isso a fronteira parece confusa.
O depósito tem uma pequena fábrica dentro.
Mas o centro continua sendo código, colaboração e histórico.
4. O que é Cloudflare? A fábrica que também ganhou loja, depósito, caminhões e segurança
Cloudflare pode:
- servir sites
- executar lógica de servidor com Workers
- fazer build e deploy
- guardar SQL com D1
- guardar chave-valor com KV
- distribuir globalmente
- gerenciar DNS
- aplicar segurança
- executar processos duráveis com Workflows
Chamar apenas de “hospedagem” é pouco.
É mais parecido com:
fábrica + loja + depósito + centro de distribuição + sala de segurança
E o banco de dados também fica ali.
GitHub e Cloudflare se sobrepõem em alguns pontos, mas o foco central é diferente.
5. O que é Build? Transformar o projeto em produto
Os arquivos do repositório normalmente ainda não são o site final.
Frameworks como Astro transformam conteúdo, componentes, configuração e código em HTML, CSS e JavaScript prontos para distribuição.
Essa transformação é o Build.
Cloudflare Workers Builds pode detectar um push num repositório Git conectado, executar um build command e depois um deploy command.
Então:
GitHub = caixa do modelo
Build = montagem
Deploy = colocar o produto na prateleira
Logs de build são longos porque são relatórios da linha de produção.
Você queria ver o site.
Recebeu o relatório industrial.
6. D1 e KV — os dois guardam dados, então por que existem dois?
D1 é o banco de dados SQL da Cloudflare. Guarda dados em tabelas e usa SQL no estilo do SQLite para buscar as linhas que atendem a uma condição.
Pense como um livro oficial com linhas, colunas, consultas e relações.
KV guarda um nome junto com seu valor. Por exemplo, o nome “modo do site” pode ter o valor “normal”.
Por exemplo:
- site_mode → normal
- feature_x → true
- user_123_theme → dark
É como um dicionário gigante.
KV é ótimo para leitura rápida e cache global, mas usa eventual consistency. A Cloudflare explica que outra localização pode temporariamente enxergar um valor antigo, às vezes por 60 segundos ou mais.
Então:
D1 = livro oficial
KV = dicionário rápido ou quadro de post-its
“Não dava para guardar tudo num banco só?” é uma pergunta humana excelente.
Sistemas distribuídos não têm obrigação de ser simpáticos.
7. Qual deles é melhor para rodar sozinho?
Depende da tarefa.
GitHub Actions automatiza jobs como build, test e deploy quando eventos acontecem no repositório.
Cloudflare Workers pode funcionar continuamente como API. Workflows lembra quais etapas terminaram, tenta de novo as que falharam, espera quando necessário e continua de onde parou.
Metáfora:
GitHub = engenheiro bom em projeto, alteração e reparo
Cloudflare = fábrica automática boa em executar um processo definido
Para investigar e corrigir código, GitHub é o centro natural.
Para “leve o processo até o fim e tente de novo se falhar”, Cloudflare é o centro natural.
São funções diferentes.
8. Quando todo mundo aprende isso? Nem todo mundo aprende
GitHub aparece bastante em cursos de computação, laboratórios e empregos de software.
Cloudflare, AWS, GCP, bancos de dados e CI/CD muitas vezes só entram na vida da pessoa quando ela precisa colocar e operar um serviço real.
Um profissional não técnico pode passar a carreira inteira sem tocar em Cloudflare Workers.
Economia, contabilidade, vendas, RH e operações podem usar Excel por muitos anos sem infraestrutura web.
Então não é “todo mundo sabia menos eu”.
É:
você abriu a caixa de ferramentas de outra profissão.
Uma pessoa pode estudar utilidade marginal e depois ser atropelada por eventual consistency.
Não costuma ser a mesma disciplina.
9. Conclusão — não memorize tudo. Saiba quem faz o quê
Este mapa já ajuda:
| Nome | Resumo |
|---|---|
| GitHub | projetos e histórico |
| Build | transformar fonte em produto |
| Deploy | colocar produto em produção |
| Cloudflare Workers | execução de servidor |
| D1 | livro SQL |
| KV | dicionário chave-valor rápido |
| GitHub Actions | automação do GitHub |
| Cloudflare Workflows | trabalhos longos que lembram onde pararam |
Com isso, quando algo falha você já pode perguntar: GitHub, Build, Worker ou DB?
Só essa classificação já reduz muito o caos.
A capacidade estourou não porque você entende devagar.
Você saiu de uma ferramenta de um cômodo chamada Excel e entrou na sala de manutenção de um shopping inteiro.
Queria trocar uma lâmpada.
Agora estão explicando o sistema corta-fogo.
- GitHub Docs, What is GitHub Pages? https://docs.github.com/en/pages/getting-started-with-github-pages/what-is-github-pages
- GitHub Docs, Understanding GitHub Actions https://docs.github.com/en/actions/get-started/understand-github-actions
- Cloudflare Docs, Workers Builds https://developers.cloudflare.com/workers/ci-cd/builds/
- Cloudflare Docs, Workers Builds Configuration https://developers.cloudflare.com/workers/ci-cd/builds/configuration/
- Cloudflare Docs, D1 https://developers.cloudflare.com/d1/
- Cloudflare Docs, How KV works https://developers.cloudflare.com/kv/concepts/how-kv-works/
- Cloudflare Docs, Workflows https://developers.cloudflare.com/workflows/
