Synaptic Four · Données et recherche

Ferrum

Ferrum partage des données de recherche par des interfaces standard.

En bref

Ferrum est une passerelle GA4GH en Rust. Il tourne en variante edge sur un ordinateur, ou en variante complète avec une base, un stockage objet et un service de connexion. Premiers usages, Apache 2.0.

Premiers usages

Structure

Qui fait quoi, étape par étape.

À gauche, votre établissement avec le stockage, la connexion et le service d’autorisation. Au milieu, Ferrum avec les interfaces. À droite, le partenaire. Les flèches 1 à 5 sont l’exploitation, la recherche, la demande, la décision et la livraison.

Votre établissement

  • Stockage de vos fichiers
  • Connexion
  • Service d’autorisation, décide

Ferrum

  • Interfaces standard
  • vérifie l’autorisation
  • livre le fichier
  • Journal

Partenaire

  • trouve
  • demande
  • télécharge
  1. 1 L’établissement exploite
  2. 2 Le partenaire trouve
  3. 3 Demande
  4. 4 L’établissement décide
  5. 5 Fichier livré

ferrum-gateway

La variante edge et la passerelle complète sont deux variantes du même programme dans un seul répertoire source. La variante décide quelles interfaces sont incluses.

Stockage, connexion, autorisation

La variante complète travaille avec une base (Postgres), un stockage objet (SeaweedFS) et un système de connexion (Keycloak). L’autorisation d’un jeu de données vient de la connexion. Edge utilise des fichiers locaux et n’écoute que sur son propre ordinateur, tant qu’une autre adresse n’est pas réglée.

Journal et heure

Ferrum tient un journal chaîné des événements qu’il enregistre. Le contrôle de santé compare l’horloge du système à un serveur de temps, pool.ntp.org par défaut. Le serveur peut être remplacé.

Interfaces et standards

Le code source de la variante complète contient sept interfaces. Du code présent n’est pas un test de bout en bout.

Interfaces et standards
InterfaceCe que cela signifieVarianteÉtat
DRS un standard pour trouver et récupérer des fichiers les deux
dans le code source
WES un standard pour exécuter des enchaînements d’analyse variante complète seulement dans le code source
TES un standard pour exécuter des enchaînements d’analyse variante complète seulement dans le code source
TRS un standard pour enregistrer des outils d’analyse variante complète seulement dans le code source
htsget un standard pour récupérer des fichiers de séquençage. Dans Ferrum aujourd’hui, des fichiers entiers les deux
fichiers entiers aujourd’hui
Beacon demande si une variante est présente, sans montrer les données les deux
une partie des chemins
Crypt4GH un format de chiffrement pour les fichiers génomiques les deux dans le code source
Passports un standard pour montrer qui peut accéder à quoi. La variante complète les contient depuis ce programme. Quand la connexion est externe, le journal nomme ga4gh-infra variante complète, depuis ce programme
pas dans Edge

Composants en exploitation

Composants en exploitation
ComposantÀ quoi il sertÉtat
Postgres la base de données de la variante complète variante complète
SeaweedFS le stockage objet de la variante complète variante complète
Keycloak le système de connexion de la variante complète variante complète
Docker un parcours pour démarrer un programme avec ses dépendances
sans Docker
Kubernetes un environnement qui fait tourner plusieurs ordinateurs comme un seul
Il n’a pas encore été installé.
Helm un format de paquet pour Kubernetes. Le chart est fourni et n’a pas encore été installé
Il n’a pas encore été installé.

Exploitation

Ferrum peut tourner sur votre propre infrastructure. Edge tourne sur un seul ordinateur, y compris sans Docker et sans serveur de base de données. Le guide indique 8 à 16 Go de mémoire et 50 Go libres pour un ordinateur de laboratoire.
Un chart Helm pour Kubernetes est fourni. Il n’a pas été installé. Le guide d’installation et le manuel d’exploitation sont dans le code source. Ils ne fixent pas de conditions de support.
Dans deux installations testées, aucune connexion sortante n’a été observée. Ce n’est pas un justificatif pour chaque configuration. Le contrôle de l’heure est prévu.

Sécurité

Dans le programme lui-même, la connexion est activée par défaut. Si le fichier de configuration est invalide, Ferrum ne démarre pas.
Ferrum est écrit en Rust. Le code propre au projet contient quatre endroits unsafe dans trois fichiers.

Tests et justificatifs

Les vérifications propres au projet ont réussi le 13 octobre 2026. Ferrum est vérifié avec HelixTest. Une exécution réussie n’est pas un sceau.
Quatre des cinq programmes vérifiés ont donné les mêmes sommes de contrôle en deux exécutions propres.

Licence

Ferrum est sous la licence Apache 2.0. Vous pouvez l’utiliser, le modifier et le transmettre librement, y compris à des fins commerciales.

Code ouvert et licences

Fichier de licence

Maturité

Premiers usages

Justificatifs de Ferrum

Documentation sur GitHub

Rapports techniques

Les rapports publiés appartiennent à Ferrum.

Limites

htsget dans Ferrum renvoie actuellement des fichiers entiers. Les régions sont refusées.
Le Beacon humain offre une partie des chemins du standard. Il manque entre autres les réponses pour les personnes et les échantillons, et les trois niveaux d’accès.
Un Beacon propre aux agents pathogènes est décidé, et il n’est pas construit.
  • Les documents liés ne fixent pas d’horaires de support.
  • Le chart Helm n’a pas été installé.

Vous voulez vérifier l’intégration dans votre environnement ?

Vérifier l’intégration de Ferrum