NeoFS REST Gateway v0.17.0, S3 Gateway v0.43.0 ajoute un jeton de session v2
Neo SPCC a récemment publié des versions mises à jour des deux passerelles d'accès NeoFS – REST Gateway v0.17.0 et S3 Gateway v0.43.0. Les deux versions introduisent la prise en charge du jeton de session v2, dépendent du SDK NeoFS Go RC18 et nécessitent Go 1.25 ou supérieur pour être construites.
Les passerelles servent d'interfaces principales pour les applications interagissant avec le stockage décentralisé NeoFS. La passerelle REST fournit un accès à l'API HTTP, tandis que la passerelle S3 offre une interface compatible Amazon S3. Le jeton de session v2, introduit pour la première fois dans NeoFS Node v0.51.0, permet un contrôle d'accès plus granulaire pour les opérations sur les conteneurs et les objets et remplace l'approche mixte précédente de session et de jeton de support. Les deux passerelles prenant désormais en charge le nouveau format, la mise à niveau coordonnée qui a commencé avec NeoFS Node v0.52.0 et le SDK RC18 est terminée sur la pile NeoFS.
Passerelle REST v0.17.0
Le principal ajout de la version 0.17.0 est une API de gestion des attributs de conteneur, exposant de nouveaux points de terminaison REST pour les opérations GET et PUT sur les attributs de conteneur. Les attributs du conteneur sont des métadonnées clé-valeur qui contrôlent le comportement et les autorisations du conteneur. Auparavant, leur gestion nécessitait une interaction directe du protocole. La nouvelle API apporte cette fonctionnalité à toute application utilisant l'interface REST.
La version inclut également une validation complète des jetons de session v2 et un correctif pour un problème de production où des jetons de support HTTP non valides provoquaient une panique. Plusieurs points de terminaison obsolètes, notamment les API de recherche et de conteneur put, ont été supprimés, ainsi que les options de configuration containers_ops_poll_interval et containers_ops_timeout. Les mises à jour de dépendance incluent le passage de Neo-Go de la v0.116.0 à la v0.118.0.
Passerelle S3 v0.43.0
S3 Gateway v0.43.0 propose une refonte complète du mappage d'objets de téléchargement en plusieurs parties, résolvant un bogue qui empêchait les téléchargements de plus de 300 parties et corrigeant les erreurs lors de la récupération de parties individuelles à partir d'objets en plusieurs parties. La nouvelle architecture introduit une structure hiérarchique avec des chaînes divisées au niveau partie et au niveau objet, éliminant plusieurs attributs de métadonnées intermédiaires utilisés par le système précédent.
La refonte en plusieurs parties est importante pour les utilisateurs travaillant avec des fichiers volumineux via l'interface S3, car le plafond précédent de 300 parties plafonnait effectivement la taille maximale des fichiers. La nouvelle architecture supprime cette contrainte tout en garantissant des métadonnées et des hachages de charge utile corrects pour les pièces individuelles.
Parallèlement à la refonte en plusieurs parties, la taille maximale d'une seule partie a été réduite de 5 Go à 4 Go pour s'aligner sur les capacités de NeoFS. La taille minimale des pièces reste à 5 Mio selon la spécification S3. Les opérateurs qui envisagent de tenir compte de la différence doivent noter que la spécification AWS S3 autorise jusqu'à 5 Go par pièce.
La prise en charge de l’authentification par jeton de session v2 complète les changements majeurs. Comme pour la passerelle REST, l'option de configuration containers_ops_poll_interval a été supprimée. Les mises à jour de dépendance incluent neo-go v0.118.0, NATS v1.49.0 et AWS SDK v2 v1.41.2.
Les deux versions de passerelle sont disponibles sur GitHub aux liens ci-dessous : https://github.com/nspcc-dev/neofs-rest-gw/releases/tag/v0.17.0 https://github.com/nspcc-dev/neofs-s3-gw/releases/tag/v0.43.0