Vai al contenuto principale

Deliverable OCCTET D4.1

Installazione di riferimento

Il deliverable OCCTET D4.1 esegue il toolkit open source come servizio cloud containerizzato, convalidato sul portafoglio della Eclipse Foundation, su prodotti di PMI e su progetti open source popolari. Usa l'istanza ospitata o riproduci l'installazione a partire dal materiale di deployment pubblico.

In questa pagina

Il toolkit OCCTET, pronto all'uso

Il deliverable D4.1 trasforma gli strumenti del toolkit OCCTET in un’installazione di riferimento: un servizio cloud containerizzato, ospitato nell’UE dalla Eclipse Foundation, che PMI e progetti open source usano senza installare nulla.

Ogni componente è open source e tutto il materiale di deployment è pubblico: qualsiasi organizzazione può quindi anche riprodurre l’installazione sulla propria infrastruttura e mantenere il codice sorgente al proprio interno.

Convalidata su carichi di lavoro reali

L’installazione è stata messa alla prova sulla scala di una fondazione open source, su prodotti di PMI e su progetti open source molto diffusi.

Scopri i risultati

Dentro l'installazione di riferimento

Quattro servizi girano su un cluster Kubernetes gestito nell’UE. ORT Server e il Curator verificano le vulnerabilità su due fonti di dati aperte: OSV e VulnerableCode, che fa parte della piattaforma federata di metadati software del progetto.

ORT Server

Analizza i repository con una pipeline di job, offre un’interfaccia web, una REST API e una CLI e genera SBOM SPDX e CycloneDX.

OCCTET Curator

Importa, cura e valuta le SBOM. I suoi servizi assistiti dall’IA usano un modello linguistico locale, quindi nessun dato esce dall’installazione.

VulnerableCode

Un database aperto delle vulnerabilità che aggrega advisory da numerose fonti e li rende disponibili per Package URL.

Keycloak

Single sign-on condiviso da ORT Server e dal Curator, con il tema OCCTET.

Principi di progettazione

  • Un unico punto di ingresso: un solo load balancer serve tutti i nomi host in HTTPS.
  • Un namespace per servizio: ogni servizio ha il proprio database e il proprio ciclo di vita.
  • Helm ovunque: ogni componente viene installato e aggiornato come release Helm a sé stante.
  • Identità condivisa: un solo account apre ORT Server e il Curator.

Usa l'istanza ospitata

Le organizzazioni che non vogliono gestire l’installazione possono usare l’istanza OCCTET. Dopo una richiesta di accesso, gli utenti accedono una sola volta con un indirizzo e-mail o un account GitHub, e lo stesso account apre ORT Server e l’OCCTET Curator.

Ogni account può consultare i risultati delle organizzazioni open source pubbliche di ORT Server: Eclipse projects, Eclipse Research Labs, Renowned FOSS projects e FOSS Validation. Ogni PMI lavora nella propria organizzazione, visibile solo ai suoi membri. L’API, la CLI e i token di ORT Server per le pipeline CI coprono l’uso automatizzato.

Pronto a provare?

La guida ai primi passi spiega cosa preparare e come richiedere l’accesso.

Primi passi

Installalo tu stesso

Tutto il materiale di deployment è pubblico, nel gruppo GitLab della Eclipse Foundation occtet-eu/reference-installation, con licenze open source. Un solo repository, occtet-helm-chart, installa l’intera piattaforma, con una release Helm per componente.

  1. Prepara un cluster Kubernetes

    Un cluster Kubernetes gestito con storage a blocchi, un load balancer e quattro nomi host DNS. La documentazione indica il dimensionamento dell’istanza di riferimento.

  2. Installa l'ingress controller e i certificati

    Il punto di ingresso termina il TLS per ogni servizio, con certificati di Let’s Encrypt.

  3. Installa il single sign-on

    Keycloak, con il tema OCCTET e il realm condiviso dagli strumenti.

  4. Installa gli strumenti

    ORT Server, OCCTET Curator e VulnerableCode, ciascuno nel proprio namespace.

  5. Pubblica e verifica

    Pubblica i servizi tramite il punto di ingresso, accedi ed esegui una prima analisi.

Repository per componente Il materiale di deployment OCCTET, sul GitLab della Eclipse Foundation, e i progetti upstream su cui si basa.
ComponenteDeployment OCCTETProgetto upstream
ORT Serverocctet-ort-server-helm-chartDocumentazione · Chart Helm
Configurazione di ORT Serverocctet-ort-server-configConfigurazione di esempio
OCCTET Curatorocctet-curator-helm-chartGuida utente · Chart Helm
VulnerableCodeocctet-vulnerablecode-helm-chartDocumentazione
Single sign-onocctet-keycloak · occtet-keycloak-themeDocumentazione di Keycloak · Chart Helm
Campagne di portafoglioocctet-eclipse-projectsAPI di ORT Server
Statistiche e dashboardocctet-stats–

Sviluppo locale

L’intera piattaforma gira anche su una workstation, su un cluster minikube locale. Usalo per provare l’installazione prima di riprodurla su un cluster, oppure per testare una modifica a un chart, ai suoi valori o a uno script dei secret prima che venga integrata e distribuita dalla CI. Usa gli stessi chart, valori e script dei secret della produzione; cambiano solo alcune impostazioni di sviluppo.

  1. Clona i repository uno accanto all'altro

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

  2. Installa la piattaforma

    make dev-up, in occtet-helm-chart, crea il cluster e installa i secret e tutte le release, poi mostra la riga da aggiungere a /etc/hosts.

    Su Linux, aumenta prima i limiti inotify della workstation (fs.inotify.max_user_instances=1024): il nodo minikube li condivide.

  3. Considera attendibile l'autorità di certificazione locale

    make dev-ca-install la importa in Chrome, Chromium e Firefox. Può firmare solo nomi sotto occtet.local.

  4. Accedi

    make dev-accounts mostra le password degli account di sviluppo. Poi apri https://ort-server.occtet.local e https://curator.occtet.local.

Che cosa cambia rispetto all'istanza di riferimento
Istanza di riferimentoInstallazione locale
ClusterKubernetes gestitominikube con il driver Docker: 8 CPU, 12 GB di memoria, 60 GB di disco
Nomi host*.occtet.eu, record DNS pubblici*.occtet.local, in /etc/hosts
CertificatiLet’s EncryptUn’autorità di certificazione autofirmata, limitata a occtet.local
RisorseDimensionamento di produzioneRichieste ridotte; nessun modello di IA locale per il Curator; meno worker VulnerableCode
Single sign-onRealm configurato da un amministratoreRealm di sviluppo importato all’avvio, con un account amministratore
Repository dei chartFissati come sottomoduli GitCloni locali: una modifica viene testata prima del commit

Oltre il progetto

Il progetto termina il 31 ottobre 2026. La Eclipse Foundation continua a ospitare la piattaforma fino all’inizio del 2027.

Il software non dipende da questa istanza. ORT Server è sviluppato in Eclipse Apoapsis, un progetto della Eclipse Foundation, mentre OCCTET Curator e VulnerableCode sono progetti open source su GitHub. Chiunque può usarli, contribuire, crearne un fork e riprodurre l’installazione. Il deliverable fornisce inoltre una stima dei costi di infrastruttura su un anno e un piano di preparazione operativa per un servizio pienamente operativo.

Leggi il deliverable completo

D4.1 è un dimostratore pubblico del Work Package 4, guidato da Double Open. La sua documentazione è scritta in Markdown e mantenuta insieme al materiale di deployment, con licenza CC BY 4.0.

Torna su