Saltar al Contenido Principal

Entregable D4.1 de OCCTET

Instalación de referencia

El entregable D4.1 de OCCTET ofrece el kit de herramientas de código abierto como servicio en la nube basado en contenedores, validado en la cartera de la Fundación Eclipse, en productos de pymes y en proyectos de código abierto populares. Usa la instancia alojada o reproduce la instalación a partir de su material de despliegue público.

En esta página

El kit de herramientas OCCTET, listo para usar

El entregable D4.1 convierte las herramientas del kit de OCCTET en una instalación de referencia: un servicio en la nube basado en contenedores, alojado en la UE por la Fundación Eclipse, que las pymes y los proyectos de código abierto usan sin instalar nada.

Todos los componentes son de código abierto y todo el material de despliegue es público, de modo que cualquier organización puede también reproducir la instalación en su propia infraestructura y mantener su código fuente en casa.

Validada con cargas de trabajo reales

La instalación se probó a la escala de una fundación de código abierto, en productos de pymes y en proyectos de código abierto muy utilizados.

Ver los resultados

Dentro de la instalación de referencia

Cuatro servicios funcionan en un clúster de Kubernetes gestionado en la UE. ORT Server y el Curator comprueban las vulnerabilidades en dos fuentes de datos abiertas: OSV y VulnerableCode, que forma parte de la plataforma federada de metadatos de software del proyecto.

ORT Server

Analiza repositorios con una cadena de tareas, ofrece una interfaz web, una API REST y una CLI, y genera SBOM en SPDX y CycloneDX.

OCCTET Curator

Importa, revisa y evalúa SBOM. Sus servicios asistidos por IA usan un modelo de lenguaje local, así que ningún dato sale de la instalación.

VulnerableCode

Una base de datos abierta de vulnerabilidades que agrega avisos de muchas fuentes y los sirve por Package URL.

Keycloak

Inicio de sesión único compartido por ORT Server y el Curator, con el tema de OCCTET.

Principios de diseño

  • Un único punto de entrada: un solo balanceador de carga sirve todos los nombres de host por HTTPS.
  • Un espacio de nombres por servicio: cada servicio tiene su propia base de datos y su propio ciclo de vida.
  • Helm en todas partes: cada componente se instala y se actualiza como su propia release de Helm.
  • Identidad compartida: una sola cuenta da acceso a ORT Server y al Curator.

Usa la instancia alojada

Las organizaciones que no quieren gestionar la instalación pueden usar la instancia de OCCTET. Tras solicitar el acceso, los usuarios inician sesión una vez con una dirección de correo electrónico o una cuenta de GitHub, y la misma cuenta da acceso a ORT Server y a OCCTET Curator.

Cualquier cuenta puede consultar los resultados de las organizaciones públicas de código abierto de ORT Server: Eclipse projects, Eclipse Research Labs, Renowned FOSS projects y FOSS Validation. Cada pyme trabaja en su propia organización, que solo ven sus miembros. La API, la CLI y los tokens para pipelines de CI de ORT Server permiten el uso automatizado.

¿Listo para probar?

La guía de primeros pasos explica qué preparar y cómo solicitar acceso.

Primeros pasos

Instálala tú mismo

Todo el material de despliegue es público, en el grupo de GitLab de la Fundación Eclipse occtet-eu/reference-installation, bajo licencias de código abierto. Un solo repositorio, occtet-helm-chart, instala toda la plataforma, con una release de Helm por componente.

  1. Prepara un clúster de Kubernetes

    Un clúster de Kubernetes gestionado con almacenamiento en bloque, un balanceador de carga y cuatro nombres de host DNS. La documentación indica el dimensionamiento de la instancia de referencia.

  2. Instala el controlador de ingress y los certificados

    El punto de entrada termina TLS para cada servicio, con certificados de Let’s Encrypt.

  3. Instala el inicio de sesión único

    Keycloak, con el tema de OCCTET y el realm compartido por las herramientas.

  4. Instala las herramientas

    ORT Server, OCCTET Curator y VulnerableCode, cada uno en su propio espacio de nombres.

  5. Publica y comprueba

    Publica los servicios a través del punto de entrada, inicia sesión y lanza un primer análisis.

Repositorios por componente El material de despliegue de OCCTET, en el GitLab de la Fundación Eclipse, y los proyectos de origen en los que se basa.
ComponenteDespliegue de OCCTETProyecto de origen
ORT Serverocctet-ort-server-helm-chartDocumentación · Charts de Helm
Configuración de ORT Serverocctet-ort-server-configConfiguración de ejemplo
OCCTET Curatorocctet-curator-helm-chartGuía de usuario · Chart de Helm
VulnerableCodeocctet-vulnerablecode-helm-chartDocumentación
Inicio de sesión únicoocctet-keycloak · occtet-keycloak-themeDocumentación de Keycloak · Charts de Helm
Campañas sobre carterasocctet-eclipse-projectsAPI de ORT Server
Estadísticas y panelesocctet-stats–

Desarrollo local

Toda la plataforma también funciona en un equipo de trabajo, en un clúster local de minikube. Úsalo para probar la instalación antes de reproducirla en un clúster, o para probar un cambio de un chart, de sus valores o de un script de secretos antes de que se fusione y lo despliegue la CI. Usa los mismos charts, valores y scripts de secretos que producción; solo cambian algunos ajustes de desarrollo.

  1. Clona los repositorios uno al lado del otro

    occtet-helm-chart, occtet-keycloak, occtet-ort-server-helm-chart, occtet-curator-helm-chart y occtet-vulnerablecode-helm-chart.

  2. Instala la plataforma

    make dev-up, en occtet-helm-chart, crea el clúster e instala los secretos y todas las releases, y después muestra la línea que hay que añadir a /etc/hosts.

    En Linux, aumenta antes los límites de inotify del equipo (fs.inotify.max_user_instances=1024): el nodo de minikube los comparte.

  3. Confía en la autoridad de certificación local

    make dev-ca-install la importa en Chrome, Chromium y Firefox. Solo puede firmar nombres bajo occtet.local.

  4. Inicia sesión

    make dev-accounts muestra las contraseñas de las cuentas de desarrollo. Después abre https://ort-server.occtet.local y https://curator.occtet.local.

Diferencias con la instancia de referencia
Instancia de referenciaInstalación local
ClústerKubernetes gestionadominikube con el driver de Docker: 8 CPU, 12 GB de memoria, 60 GB de disco
Nombres de host*.occtet.eu, registros DNS públicos*.occtet.local, en /etc/hosts
CertificadosLet’s EncryptUna autoridad de certificación autofirmada, limitada a occtet.local
RecursosDimensionamiento de producciónSolicitudes de recursos menores; sin modelo de IA local para el Curator; menos workers de VulnerableCode
Inicio de sesión únicoRealm configurado por un administradorRealm de desarrollo importado al arrancar, con una cuenta de administrador
Repositorios de chartsFijados como submódulos de GitClones locales: un cambio se prueba antes de hacer commit

Más allá del proyecto

El proyecto termina el 31 de octubre de 2026. La Fundación Eclipse seguirá alojando la plataforma hasta principios de 2027.

El software no depende de esta instancia. ORT Server se desarrolla en Eclipse Apoapsis, un proyecto de la Fundación Eclipse, y OCCTET Curator y VulnerableCode son proyectos de código abierto en GitHub. Cualquiera puede usarlos, contribuir a ellos, hacer un fork y reproducir la instalación. El entregable también incluye una estimación de los costes de infraestructura para un año y un plan de preparación operativa para un servicio plenamente operativo.

Lee el entregable completo

El D4.1 es un demostrador público del paquete de trabajo 4, dirigido por Double Open. Su documentación está escrita en Markdown y se mantiene junto con el material de despliegue, bajo la licencia CC BY 4.0.

Volver arriba