Ir para o conteúdo
Promovaweb

Plugins e scripts

StayCloudVPS Agêntica

Uma VPS para os seus agentes trabalharem dia e noite

Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

Montar minha VPS Agêntica

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

Toda task do Kestra vem de um plugin, identificado pelo tipo completo, como io.kestra.plugin.core.log.Log, num catálogo oficial com mais de 2.600 plugins. As tasks de script rodam código em Python, Node.js, Shell e outras linguagens, num processo do worker ou num container Docker escolhido pelo task runner.

Sumário da página

  1. O tipo da task diz de onde ela vem
  2. O catálogo oficial
  3. Imagem slim e imagem completa
  4. Scripts como tasks
  5. Process e Docker
  6. Tasks de IA e o servidor MCP
  7. Plugins próprios

O tipo da task diz de onde ela vem

Cada task de um flow tem uma linha type com um nome longo, como io.kestra.plugin.core.log.Log ou io.kestra.plugin.core.http.Request. Esse nome é o endereço da task dentro de um plugin. A primeira parte indica o pacote, a do meio o grupo de tasks e a última a task. Quando você lê core.http.Request, já sabe que a task faz uma requisição HTTP e que ela vem do núcleo do Kestra.

A documentação define os plugins como os blocos de construção das tasks, que conectam o Kestra a outros sistemas. O núcleo traz as tasks básicas, como a de log e a de requisição HTTP. Os bancos e os serviços de nuvem chegam por plugins separados. Cada plugin tem as próprias tasks e, em vários casos, os próprios triggers de polling.

O catálogo oficial

O catálogo do Kestra anuncia mais de 2.600 plugins, organizados em seis categorias, como IA, nuvem e infraestrutura. Cada plugin tem uma página com as propriedades da task e um flow completo de exemplo. A mesma documentação aparece dentro do editor do Kestra, com autocompletar das propriedades enquanto você escreve o YAML.

O README resume o alcance: plugins para extrair registros de bancos, de armazenamentos em nuvem e de APIs e para rodar scripts em qualquer linguagem. Na stack de uma agência, isso cobre o PostgreSQL e o MySQL dos apps, os buckets S3, as APIs de pagamento e de ERP e os avisos no Slack ou no Discord.

Imagem slim e imagem completa

O quickstart usa a imagem kestra/kestra:latest-slim, que vem sem plugins para o download ficar pequeno. Com a variável KESTRA_PLUGINS_AUTO_INSTALL_ENABLED=true, o Kestra baixa do Maven Central cada plugin que um flow usar pela primeira vez. A imagem kestra/kestra:latest já traz todos os plugins embutidos.

A escolha pesa na operação. A imagem slim deixa o servidor com só o que as suas rotinas usam, mas precisa de acesso ao Maven Central na primeira execução de cada plugin. A imagem completa funciona sem esse acesso e ocupa mais disco. Num servidor com saída de rede restrita, a completa evita a surpresa de um flow novo que falha porque não conseguiu baixar o plugin.

Scripts como tasks

As tasks de script são o caminho para o código que já existe. O README cita Python, Node.js, R, Go e Shell. O script pode ficar escrito dentro do próprio flow, num bloco de texto, ou num arquivo do namespace, compartilhado por vários flows. O script recebe inputs e outputs de tasks anteriores por expressões e devolve arquivos e valores para as tasks seguintes.

Na prática, o backup que hoje é um script Shell chamado pelo cron vira uma task de script dentro de um flow. O código continua o mesmo. O que muda é tudo ao redor dele: a agenda está no trigger, as tentativas no bloco retry, o aviso de falha na lista errors e a saída do script no histórico da execução.

  1. Task de script

    O flow declara a linguagem, o código ou o arquivo do namespace e as dependências.

  2. Task runner

    Decide onde o código roda: no próprio worker (Process) ou num container (Docker).

  3. Execução do código

    O script roda com os inputs e os arquivos que recebeu das tasks anteriores.

  4. Saídas guardadas

    Arquivos gerados vão para o armazenamento interno. Valores e logs ficam na execução.

O caminho de uma task de script, da definição no flow ao resultado guardado, com os task runners abertos da documentação.

Process e Docker

A documentação descreve os task runners como a peça que decide onde o código de uma task de script roda: no host do worker, num container ou numa infraestrutura remota. Os dois task runners da edição open source vêm embutidos no Kestra.

Task runnerOnde o código rodaQuando faz sentido
ProcessComo processo local no worker, sem a camada do container.Scripts rápidos que usam ferramentas já instaladas na imagem do Kestra.
DockerNum container Docker, marcado na documentação como o padrão.Scripts com dependências próprias, como uma versão específica do Python ou do pg_dump.
RemotosKubernetes e serviços de lote das nuvens, como AWS Batch e Google Batch.Cargas pesadas fora do servidor do Kestra, na edição Enterprise.

O Docker isola cada script num ambiente previsível. A versão do Python, as bibliotecas e os binários vêm da imagem escolhida. Um script não interfere no outro. Por isso o comando do quickstart monta o docker.sock do host dentro do container do Kestra: é por esse socket que o worker cria os containers das tasks. Num servidor de produção, esse acesso ao Docker do host merece a mesma atenção que qualquer outro acesso administrativo.

Tasks de IA e o servidor MCP

O README coloca os agentes de IA e os workflows de RAG como tipos de task. Um flow pode chamar um modelo de linguagem como etapa, entre uma consulta ao banco e o envio de um relatório. No sentido contrário, o servidor MCP embutido expõe os flows como ferramentas para agentes compatíveis. As Agent Skills do projeto conectam assistentes de código ao Kestra.

Isso coloca o Kestra nos dois lados de uma automação com IA. Ele chama o modelo dentro de uma rotina com agenda e histórico. E também oferece rotinas prontas para um agente executar, com as mesmas tentativas e o mesmo registro de qualquer outra execução.

Plugins próprios

Quando nenhum plugin do catálogo atende, existem dois caminhos. O mais comum é a task HTTP Request, que conversa com qualquer API REST e guarda a resposta como output. O outro é escrever um plugin próprio, como fazem os plugins oficiais, em repositórios separados. A licença Apache 2.0 do Kestra não obriga um plugin seu a seguir a mesma licença. A licença do Kestra traz os detalhes.

O próximo hub acompanha o que acontece depois que as tasks começam a rodar: os estados, os logs e as falhas de cada execução.