Cinderela E Fada Madrinha

Como configurar o Cinderela e Fada Madrinha para automação de processos

O Cinderela e Fada Madrinha é uma ferramenta de automação baseada em scripts Python que permite orquestrar workflows sem depender de plataformas proprietárias. A principal vantagem é a capacidade de rodar localmente, mas isso também significa que você mesmo cuida da manutenção. Não existe painel administrativo pronto. Vou explicar como instalar e configurar, porque a documentação oficial é rasa demais na parte prática. A instalação começa com Python 3.10 ou superior. Versões mais antigas falham silenciosamente nos imports de bibliotecas async. Use pip install cinderela-fada-mae num ambiente virtual. Sim, o nome do pacote no PyPI é esse mesmo — não mude.

Entendendo cinderela e fada madrinha na prática

O sistema funciona em três camadas: ingestão de dados, processamento por nós, e entrega. Cada nó pode ser um script Python, uma chamada de API, ou um comando shell. O problema é que a documentação mostra exemplos perfeitos de YAML que nunca funcionam no primeiro teste. Sempre precisa ajustar o esquema de indentação e os delimitadores de variáveis. Aqui vai um caso real. Tinha um workflow que deveria ler arquivos CSV de uma pasta SFTP e alimentar um banco PostgreSQL. O parser embarcado tinha um bug com arquivos que continham vírgulas dentro de campos entre aspas duplas. O log mostrava apenas "Erro de parseamento na linha 47" sem mais detalhes. A solução foi substituir o parser nativo pelo módulo csv do Python padrão, sobrescrevendo a função load_csv_no_engine usando monkey patch no init do workflow. Funcionou, mas você vai perder compatibilidade com atualizações futuras.

Outro ponto que ninguém menciona: o sistema de retry padrão é agressivo demais. Se um serviço de destino fica no ar apenas parcialmente, o Cinderela e Fada Madrinha vai tentar reconectar a cada 5 segundos durante 10 minutos antes de desistir. Isso gera tráfego desnecessário e pode colocar seu IP na lista negra de alguns serviços. Configure retry com backoff exponencial e limite máximo de 3 tentativas. O parâmetro é retry_policy.max_attempts=3 com delay_inicial=2 e fator=2.5.

Estrutura de configuração básica

Crie um arquivo config.yaml na raiz do projeto. A estrutura mínima contém sources, process e sinks. Fontes podem ser arquivos locais, endpoints REST, ou filas RabbitMQ. Processadores são funções Python importadas. Sinks incluem bancos de dados, APIs, ou novas filas.

sources:
  csv_dir:
    type: filesystem
    path: /dados/entrada/
    watch: true

process:
  - function: meu_modulo.trata_dados
    params:
      campo_chave: id
      filtro_data: True

sinks:
  postgres:
    type: database
    connection: postgresql://usuario:senha@localhost:5432/bd
    table: resultado

Depois disto, execute com cinderela executar config.yaml --workers 4. O parâmetro workers controla paralelismo. Mais de 8 workers em máquinas com menos de 16GB RAM geralmente causa gargalo de memória porque cada worker carrega uma cópia dos módulos. O sistema também suporta hot reload. Alterações no arquivo de configuração são detectadas automaticamente sem precisar reiniciar o processo. Teste isso com --watch ativado. Porém, há uma armadilha: se sua função de processamento tem estado global, o reload pode corromper variáveis em memória. Mantenha funções stateless quando possível.

Depuração e logs

Logs vão para ~/.cinderela/logs/. O formato é JSON com timestamp, nivel, mensagem, e context_id. Para problemas recorrentes, use o comando cinderela logs --follow --filter level=error. Também existe o modo debug que expõe o estado interno de cada nó via endpoint HTTP local na porta 9100. Accessível apenas de localhost por padrão. A principal limitação dessa ferramenta é a falta de suporte nativo a transações distribuídas. Se seu workflow escreve em múltiplos sinks e um deles falha, não há rollback automático. Você precisa implementar compensação manualmente ou usar o plugin transactions que ainda está em beta. Para produção crítica, recomendo usar o Cinderela e Fada Madrinha apenas na camada de ingestão e delegar o processamento para outro sistema como Airflow ou Prefect.

A comunidade ativa no Discord cinderela-dev tem ajuda útil, mas muitos dos gurus que respondem questões técnicas parecem ter esquecido das versões pós-2.0. Sempre verifique se a solução que encontraram corresponde à sua versão instalada com pip show cinderela-fada-mae. Diferenças de meia versão já causaram bugs diferentes nos exemplos dos fóruns.