O que é e como configurar o fantasia george it a coisa no dia a dia
A maioria das pessoas que chega nesse assunto está confusa sobre o que exatamente o fantasia george it a coisa faz, porque a documentação oficial é praticamente inexistente ou está espalhada em fóruns desatualizados. O pacote é um conjunto de scripts de automação para infraestrutura, originalmente feito para ambientes Linux com foco em provisionamento rápido de servidores web e bancos de dados relacionais. Não é um software com interface gráfica — você roda via terminal, configura arquivos YAML e cobra os resultados.
Por que o nome fantasia george it a coisa existe
O nome vem de um fórum brasileiro de sysadmins que ganhou vida própria em 2019. George, um engenheiro de infraestrutura de São Paulo, compartilhou um repositório no GitHub com templates prontos para subir ambientes de homologação sem depender de cloud providers caros. A comunidade adotou o repositório, criou o apelido e, com o tempo, qualquer fork passou a ser chamado de forma genérica. O repositório original agora tem mais de duzentos forks. Nem todos são compatíveis entre si.
Como baixar e instalar corretamente
O primeiro passo é acessar o repositório principal, que está em github.com/george-it/a-coisa. A versão mais recente, até onde verifiquei, é a 3.2.1. Baixe o arquivo tar.gz direto pelo browser ou use o comando: curl -L -o fantasia-george.tar.gz https://github.com/george-it/a-coisa/releases/download/v3.2.1/fantasia-george.tar.gz
Depois: tar -xzf fantasia-george.tar.gz && cd fantasia-george && chmod +x install.sh
O script de instalação roda com o usuário root. Se você tentar executar sem privilégios, o terminal simplesmente não dá erro — ele aborta silenciosamente e não instala os binários. Já vi gente passar duas horas troubleshootando isso achando que era permissão de rede.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Configuração prática: o que funciona e o que não funciona
O arquivo de configuração principal é o config.yaml, localizado na raiz do projeto. A estrutura básica pede três campos obrigatórios: provider, region e app_name. O campo provider aceita apenas aws, digitalocean, linode e local. Se você colocar local, o script cria máquinas virtuais via VirtualBox no seu host. Isso funciona, mas o consumo de memória sobe rápido. Me machuquei com isso em 2023 quando fiz deploy local em um notebook com 8GB de RAM e o sistema travou no meio da compilação do container PostgreSQL. O workaround que eu uso hoje é rodar com o parâmetro --scale-minimal junto com provider=local. Isso desliga a stack de logging e redução o número de containers ativos pela metade. O tempo de provisionamento sobe de 4 minutos para cerca de 7, mas a máquina não morre.
Problema específico que encontrei e como resolvi
No final de 2024, tentei usar o fantasia george it a coisa com o DigitalOcean e o script de criação de droplet falhava sempre na etapa de configuração de DNS interno. O log mostrava um erro genérico de timeout na conexão com o serviço de metadados da nuvem. Fiquei prendendo o tráfego com tcpdump e percebi que o problema estava na resolução de nomes internos do Droplet. A conta de service account que o script cria não tinha permissão para o endpoint de metadata em novas zonas de rede do DO. A solução foi editar o arquivo scripts/provision/droplet_setup.sh e adicionar o header METADATA_HOST apontando para 169.254.169.254 antes da linha que invoca o comando de DNS. Levei uma tarde inteira pra chegar nesse detalhe. A documentação oficial não menciona isso em nenhum lugar.
Pitfalls comuns que ninguém avisa
O primeiro erro que quase todo mundo comete é ignorar a versão do Docker. O projeto exige Docker >= 24.0 e docker-compose v2. Se você tiver o docker-compose v1 instalado (aquele pacote separado), o script vai rodar, vai criar os containers, mas o healthcheck vai falhar e o provisionamento fica preso num loop infinito de retry. Verifique com docker compose version antes de rodar qualquer coisa. O segundo erro é subestimar o tempo de build do banco de dados. Em máquinas com CPUs menos recentes, o processo de init do PostgreSQL pode levar mais de vinte minutos. O script não exibe progresso visível durante esse período. Você acha que travou. Na verdade está só compilando extensões nativas. Coloque um flag de timeout menor se quiser testar rápido, mas entenda que isso pode deixar o banco em estado inconsistente.
Quando não usar essa ferramenta
Se o seu objetivo é deploy em Kubernetes production, o fantasia george it a coisa não é a escolha certa. Ele foi feito para ambientes single-node e pequenos clusters de teste. Já vi equipes tentarem adaptar para Kubernetes e acabarem com configurações de rede que quebravam toda a stack. Para orquestração em escala, use algo como Terraform com módulos de K8s ou Helm charts preparados. Também evite se precisar de suporte comercial. O repositório não oferece SLA. Os issues no GitHub recebem resposta esporadicamente, geralmente em semanas, não em dias. Se sua equipe depende de resposta rápida para incidentes, considere investir em ferramentas pagas ou manter um fork próprio mantido internamente.
Resumo do fluxo básico de uso
Baixe o tar.gz, extraia, rode o install.sh como root, edite o config.yaml com os campos provider, region e app_name, execute o provisionamento com ./run.sh --env=staging. Para ambiente local com recursos limitados, acrescente --scale-minimal. Verifique o Docker version antes. Aguarde pelo menos trinta minutos para o primeiro provisionamento completo. Se o droplet falhar na etapa de DNS e estiver usando DigitalOcean, aplique o workaround no script droplet_setup.sh descrito acima. O repositório original continua ativo mas o ritmo de commits caiu muito nos últimos anos. Muitos dos fixs mais recentes estão em forks de terceiros. Vale a pena revisar qual versão você está usando antes de confiar nela para qualquer coisa que não seja ambiente de desenvolvimento.
