stubbi/hermes-operator

O que hermes-operator faz?

Operador Kubernetes de nível de produção para o nousresearch/hermes-agent: especificação declarativa, padrões de segurança, backups S3, atualização automática OCI com rollback, coexistência GitOps baseada em SSA, migração OpenClaw.

Visão Geral

O stubbi/hermes-operator é um operador Kubernetes de nível de produção, construído em Go com Kubebuilder. Ele gerencia todo o ciclo de vida de instâncias do nousresearch/hermes-agent no seu cluster Kubernetes.

Funcionalidades

• Especificação Declarativa (HermesAgent CRD): Defina o estado desejado do seu hermes-agent via um Custom Resource do Kubernetes.
• Padrões de Segurança: Aplicação de políticas de segurança como runAsNonRoot, readOnlyRootFilesystem, e seccomp por padrão.
• Backups S3: Automatize e agende backups do estado do agente para buckets Amazon S3.
• Atualização Automática OCI com Rollback: Atualize automaticamente para novas versões de imagem OCI; em caso de falha, o rollback é automático.
• Coexistência GitOps (SSA): Integração perfeita com ferramentas GitOps (ArgoCD, Flux) usando Server-Side Apply (SSA).
• Migração OpenClaw: Facilita a migração de cargas de trabalho do OpenClaw para o Kubernetes.

Pré-requisitos

• Cluster Kubernetes 1.22+
• kubectl configurado
• Acesso a um registro de contêiner OCI
• Credenciais AWS configuradas (para backups S3)

Instalação

Usando Helm

helm repo add stubbi https://stubbi.github.io/charts
helm install hermes-operator stubbi/hermes-operator

Usando YAML

kubectl apply -f https://raw.githubusercontent.com/stubbi/hermes-operator/main/config/install.yaml

Uso Rápido

1. Crie um CustomResource HermesAgent para definir seu agente:

apiVersion: agents.hermes.stubbi.io/v1alpha1
kind: HermesAgent
metadata:
  name: meu-hermes
spec:
  image: nousresearch/hermes-agent:latest
  replicas: 2
  backups:
    s3:
      bucket: meus-backups-hermes
      schedule: "0 */6 * * *"
  security:
    runAsNonRoot: true
    readOnlyRootFilesystem: true

2. Aplique o recurso:

kubectl apply -f meu-hermes.yaml

3. Monitore o estado:

kubectl get hermetsagent
kubectl describe hermetsagent meu-hermes

Documentação

Para documentação completa, incluindo configuração avançada, solução de problemas e guias de migração, consulte a pasta docs.

Contribuindo

Veja CONTRIBUTING.md para diretrizes.

Licença

Apache 2.0 – veja LICENSE.