Developers

Aparência

Vai integrar o Zarv Agent (on-premise) com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar o Zarv Agent (on-premise). Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/edge-agent/installation
- Instalação: https://developers.zarv.com/edge-agent/installation
- Registro: https://developers.zarv.com/edge-agent/enrollment
- Configuração: https://developers.zarv.com/edge-agent/configuration
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

O agente é um software instalado em máquina do cliente, não uma API que você chama: siga os passos de instalação, registro e configuração na ordem documentada, e use os arquivos e comandos exatamente como aparecem nas páginas.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: instalar, registrar e configurar o agente no meu ambiente]

Instalação ​

A instalação é um único comando, em qualquer sistema operacional. O pacote é autocontido (ffmpeg, runtime de inferência e modelos já inclusos) e, nos métodos nativos, o serviço zarv-agent sobe sozinho no boot via systemd.

Escolha o método ​

sh
curl -fsSL https://collector.zarv.com/agent/install-apt.sh | sh
sh
curl -fsSL https://collector.zarv.com/agent/install-rpm.sh | sh
sh
curl -fsSL https://collector.zarv.com/agent/install.sh | sh
powershell
irm https://collector.zarv.com/agent/install.ps1 | iex
sh
docker compose up -d

Recomendação

Em Debian/Ubuntu e RHEL/Fedora, prefira os pacotes nativos (APT/RPM): eles registram o serviço zarv-agent com auto-start no boot e se atualizam pelo próprio repositório sob controle da Zarv. Use Docker apenas em sistemas sem pacote nativo.

O que o instalador faz ​

Tomando o APT como exemplo, o script:

  1. Adiciona o repositório de pacotes da Zarv e sua chave de assinatura.
  2. Instala o pacote zarv-agent (já inclui ffmpeg, runtime e modelos).
  3. Aponta o agente para o plano de controle da Zarv.
  4. Registra e inicia o serviço systemd zarv-agent, habilitado no boot.

O fluxo do RPM é equivalente.

Registro ​

Depois de instalar, registre o dispositivo:

  1. Abra a interface local em http://localhost:8088.
  2. Cole a chave de enrollment gerada no painel da Zarv.
  3. Pronto — a partir daí a Zarv controla atualizações e features por OTA.

Detalhes em Registro.

Verificação ​

Confirme que o serviço está rodando e habilitado no boot:

sh
systemctl is-enabled zarv-agent   # → enabled
systemctl is-active  zarv-agent   # → active
systemctl status     zarv-agent

Verifique a versão em execução nos logs:

sh
journalctl -u zarv-agent | grep "starting"

E que a interface local responde:

sh
curl -fsS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8088/   # → 200

Layout no disco (instalação nativa) ​

CaminhoConteúdo
/usr/local/bin/zarv-agentBinário do agente.
/lib/systemd/system/zarv-agent.serviceUnit systemd (auto-start no boot).
/etc/default/zarv-agentVariáveis de ambiente do serviço (conffile).
/var/lib/zarv-agentEstado persistente: banco SQLite, blobs, config.env.
/opt/zarv/{bin,lib,models}ffmpeg, libs e modelos embutidos.

O serviço roda como o usuário de sistema sem privilégios zarv-agent.

Configuração local ​

Variáveis de ambiente ficam em /etc/default/zarv-agent. As mais comuns estão em Configuração. Após editar, reinicie:

sh
sudo systemctl restart zarv-agent

Desinstalação ​

sh
sudo apt-get remove --purge zarv-agent
sh
sudo dnf remove zarv-agent
sh
docker rm -f zarv-agent

Próximos passos ​