Carol Apps batch e online
Carol Apps permitem executar código na infraestrutura da Carol a partir de uma imagem Docker. A imagem contém o código da aplicação, suas dependências e o comando de inicialização, permitindo utilizar a linguagem e as ferramentas necessárias ao projeto.
As aplicações podem ser executadas em dois formatos: batch e online. O manifesto define a imagem utilizada por cada processo e suas configurações de execução.
| Formato | Finalidade |
|---|---|
| Batch App | Execução de tarefas com início e fim, sob demanda ou por agendamento. |
| Online App | Disponibilização contínua de APIs e serviços HTTP. |
Do código à execução
O desenvolvimento segue quatro etapas: código e Dockerfile → build na Carol → imagem Docker → execução do processo. O manifesto conecta essas etapas ao informar a origem do código, a imagem e as configurações de cada processo.
Dockerfile, imagem, contêiner e manifesto
| Termo | Papel no Carol App |
|---|---|
| Dockerfile | Arquivo com as instruções para construir a imagem, incluindo dependências e comando de inicialização. |
| Build | Etapa que utiliza o Dockerfile e os arquivos do projeto para construir a imagem. |
| Imagem Docker | Pacote com o código e o ambiente necessários à aplicação. Pode ser reutilizado em várias execuções. |
| Contêiner | Ambiente criado a partir da imagem para executar a aplicação. |
| Manifesto | Arquivo JSON que descreve os processos do app, suas imagens e configurações. Um Carol App pode reunir processos batch e online. |
Pré-requisitos
O desenvolvimento requer uma tenant de desenvolvimento, que é o ambiente da Carol onde o app será criado e validado, permissão para editar Carol Apps e um repositório Git acessível pela plataforma.
Os exemplos locais podem ser executados com Python 3.13 ou Docker. Conectores, modelos de dados e pipelines SQL são necessários apenas quando utilizados pela aplicação.
Documentação compartilhada
- Build e atualização: criação do app, construção de imagens e atualização de versões.
- Manifesto e configuração: referência dos campos, variáveis de ambiente e Settings.
- Logs, Storage e tipos de instância: referências para a operação.
Os exemplos estão disponíveis em static/examples/carol-apps neste repositório e para download nas páginas de cada formato.