OOS est le service de stockage objet d’OUTSCALE. Un stockage objet ne gère ni disques ni systèmes de fichiers : il stocke des objets (un fichier et ses métadonnées), rangés dans des conteneurs appelés buckets, et accessibles par une API HTTPS. Il convient aux grands volumes de données non structurées : sauvegardes, archives, images, vidéos, journaux, fichiers d’un site web statique, etc.
Trois notions structurent le service :
un bucket appartient à une Région et porte un nom unique dans toute cette Région, tous comptes OUTSCALE confondus ;
un objet est identifié dans son bucket par sa clé (key), par exemple index.html ou rapports/2026/octobre.csv ;
un bucket n’a pas de dossiers : la partie rapports/2026/ d’une clé est un simple préfixe, que les outils affichent comme une arborescence.
OOS repose sur la technologie RING de Scality et est compatible avec l’API S3 (Simple Storage Service) d’AWS. Tout outil compatible S3 peut donc l’utiliser, à condition de lui indiquer l’endpoint OOS de la Région, c’est-à-dire l’adresse de l’API. Pour la Région eu-west-2, l’endpoint est https://oos.eu-west-2.outscale.com.
Le tableau suivant liste les endpoints OOS de chaque Région :
Remarque : un endpoint est une adresse d’API, que vous indiquez aux outils (octl, AWS CLI, SDK). Ce n’est pas une page web à ouvrir dans un navigateur.
Dans ce lab, vous travaillez uniquement depuis le terminal de votre poste de travail, sans VM ni Net :
avec octl, vous créez un bucket privé, vous y déposez des objets, vous activez le versioning, vous partagez un objet par URL pré-signée et vous publiez un site web statique (parties 1 à 7) ;
avec AWS CLI, vous accédez au même bucket et vous y synchronisez un dossier local (partie 8) : les deux outils manipulent les mêmes objets, car ils appellent la même API.
d’octl, installé et configuré avec le profil default dans le Lab 05 ;
d’AWS CLI version 2.13 ou ultérieure, installé et configuré dans le Lab 05 (étapes 4.1 à 4.4) ;
des connaissances acquises dans le Lab 05 (octl, options --jq et -o, endpoints des API).
Ce lab ne réutilise aucune ressource OUTSCALE des labs précédents.
Le lab utilise la région eu-west-2.
Important : octl évolue rapidement. Ce lab a été rédigé avec octl v0.0.35. Si une commande ne se comporte pas comme décrit, vérifiez votre version avec octl --version et consultez l’aide intégrée avec octl storage <commande> --help.
Le profil default s’affiche, avec la Région eu-west-2. Si la commande échoue, reprenez la partie 2 du Lab 05.
Affichez l’aide des commandes de stockage :
Terminal window
octlstorage--help
octl regroupe les commandes OOS sous octl storage (alias octl oos) : bucket pour les buckets, object pour les objets et api pour appeler directement une méthode de l’API S3. octl utilise les access keys et la Région du profil default et en déduit l’endpoint https://oos.eu-west-2.outscale.com.
Le nom d’un bucket doit être unique dans toute la Région eu-west-2, tous comptes OUTSCALE confondus. Il doit :
contenir entre 3 et 63 caractères ;
commencer par une lettre minuscule ou un chiffre ;
contenir uniquement des lettres minuscules, des chiffres et des tirets (-) ;
ne pas avoir la forme d’une adresse IP.
Le nom d’un bucket ne peut plus être modifié après sa création.
Enregistrez le nom de votre bucket dans une variable du shell, en remplaçant <INITIALES> par vos initiales en minuscules et <NOMBRE> par un nombre de votre choix :
Terminal window
BUCKET=architecte-lab07-<INITIALES>-<NOMBRE>
echo $BUCKET
Par exemple : architecte-lab07-ej-427.
Créez un dossier de travail pour les fichiers du lab et placez-vous dedans :
Terminal window
mkdir-p~/architecte-lab07&&cd~/architecte-lab07
Remarque : la variable BUCKET n’existe que dans le terminal où vous l’avez définie. Si vous ouvrez un nouveau terminal, définissez-la de nouveau.
La ligne Resolving alias to [...] indique la méthode de l’API S3 exécutée par octl : ici, CreateBucket. La réponse contient l’emplacement du bucket (location).
Remarque : si la commande renvoie l’erreur BucketAlreadyExists, le nom est déjà utilisé dans la Région, peut-être par un autre compte. Choisissez un autre nombre à l’étape 1.2.
Le premier argument (index.html) est la clé de l’objet dans le bucket.
--body indique le chemin du fichier local à envoyer.
octl détecte le type du fichier (Detected mime-type: text/html) et l’enregistre dans les métadonnées de l’objet. Un navigateur saura ainsi afficher la page au lieu de la télécharger.
Déposez un deuxième objet, dont la clé contient un préfixe :
octl affiche l’avertissement not displaying binary data to terminal et n’affiche rien. Pour protéger le terminal, octl n’y affiche que le texte brut : il analyse le début de l’objet, et une page HTML n’est pas considérée comme du texte brut.
Téléchargez l’objet index.html dans un fichier local avec l’option -O (--out-file), puis affichez le fichier :
Par défaut, déposer un objet avec une clé existante remplace l’objet, et supprimer un objet le supprime définitivement. Le versioning conserve toutes les versions de chaque objet : une modification ou une suppression accidentelle devient réversible.
Important : une fois activé, le versioning ne peut plus être désactivé, seulement suspendu (Suspended). La commande octl storage bucket versioning disable appelle d’ailleurs l’API avec le statut Suspended. Quand le versioning est suspendu, les nouvelles versions ne sont plus conservées, mais les versions existantes restent stockées.
-c (--columns) choisit les colonnes du tableau, chacune sous la forme <titre>:<expression jq>, séparées par ||.
L’objet index.html possède deux versions : la version actuelle (Actuelle à true), que vous venez de déposer, et la version précédente, déposée à l’étape 3.2.
Remarque : la version précédente de index.html a un identifiant null. Elle a été déposée avant l’activation du versioning : OOS conserve ces objets avec l’identifiant de version null.
Les deux versions de index.html existent toujours, mais aucune n’est la version actuelle.
Dans un bucket versionné, une suppression sans identifiant de version ne supprime aucune donnée : OOS ajoute un marqueur de suppression (delete marker), qui devient la version actuelle de l’objet. L’objet disparaît des listes, mais ses versions restent stockées, et facturées.
La commande octl storage object versions n’affiche que les versions d’objets. L’option -o raw affiche la réponse complète de la méthode ListObjectVersions, qui contient aussi la liste DeleteMarkers. Le marqueur de suppression de index.html y apparaît, avec IsLatest à true.
L’option -y est obligatoire ici. Sans elle, octl affiche d’abord l’objet à supprimer (méthode HeadObject) pour vous demander une confirmation. Or l’objet est justement masqué par le marqueur de suppression : HeadObject échoue et octl s’arrête avant de supprimer quoi que ce soit.
Un objet privé n’est accessible qu’avec les access keys de votre compte. Une URL pré-signée donne accès à un objet précis, pendant une durée limitée, à toute personne qui possède l’URL, sans compte OUTSCALE et sans rendre l’objet public.
--expires fixe la durée de validité de l’URL, par exemple 30s, 10m ou 1h. Sans cette option, l’URL est valable 15 minutes.
L’URL contient votre access key, la date de création, la durée de validité (X-Amz-Expires, en secondes) et une signature calculée avec votre secret key. Votre secret key n’apparaît pas dans l’URL.
Téléchargez l’objet avec l’URL pré-signée :
Terminal window
curl-s"$URL"
Le contenu du fichier s’affiche. Vous pouvez aussi ouvrir l’URL dans un navigateur.
Attendez 2 minutes, puis relancez la même commande :
Terminal window
curl-s-o/dev/null-w"%{http_code}\n""$URL"
La commande affiche le code 403 : l’URL a expiré.
Attention : toute personne qui possède une URL pré-signée valide peut télécharger l’objet. Choisissez une durée de validité aussi courte que possible et ne publiez jamais une URL pré-signée.
Une ACL (Access Control List) est attachée à chaque bucket et à chaque objet. Elle liste des bénéficiaires (grantees) et la permission accordée à chacun : READ, WRITE, READ_ACP (lire l’ACL), WRITE_ACP (modifier l’ACL) ou FULL_CONTROL.
L’ACL contient un seul bénéficiaire, de type CanonicalUser : le propriétaire, identifié par son ID utilisateur S3, avec la permission FULL_CONTROL. Le champ displayname du propriétaire contient l’ID de votre compte OUTSCALE.
La commande octl storage object acl configure n’accepte pas d’ACL prédéfinie : vous appelez directement la méthode PutObjectAcl de l’API S3 avec octl storage api, comme vous l’avez fait avec octl iaas api dans les Labs 05 et 06.
Un deuxième bénéficiaire apparaît, de type Group, avec l’URI http://acs.amazonaws.com/groups/global/AllUsers et la permission READ : tout le monde peut lire l’objet.
La page Version 2 s’affiche. L’objet rapports/2026/octobre.csv reste privé.
Important : une ACL s’applique à un objet, et non à une clé. Chaque nouvelle version d’un objet reçoit l’ACL indiquée lors de son dépôt, private par défaut. Si vous déposez une nouvelle version de index.html sans l’option --acl public-read, elle ne sera plus publique.
Remarque : pour partager un bucket ou un objet avec un autre compte OUTSCALE sans le rendre public, accordez une permission à son ID utilisateur S3, par exemple avec l’option --grant-read 'id=<ID_UTILISATEUR_S3>' de la commande octl storage bucket acl configure. Une nouvelle ACL remplace toujours l’ACL précédente : indiquez dans la même commande toutes les permissions à conserver.
Un bucket peut servir directement un site web statique : des pages HTML, des feuilles de style, des scripts exécutés dans le navigateur, des images. Aucun traitement n’est exécuté côté serveur : une application PHP ou Python ne peut pas être hébergée dans un bucket. En revanche, le front-end d’une application (Angular, React, Vue, etc.) peut l’être.
Ouvrez cette adresse dans votre navigateur. La page Mon site web statique, Version 2, s’affiche.
Ajoutez page-inexistante.html à la fin de l’adresse. La page d’erreur Erreur 404 s’affiche.
Remarque : l’adresse du site web (oos-website) est différente de l’endpoint de l’API (oos). Seuls les objets publics sont servis par le site : si vous retirez l’ACL public-read de index.html, le site renvoie une erreur d’accès.
OOS est compatible avec l’API S3 : vous pouvez gérer le même bucket avec AWS CLI, ou avec tout autre outil compatible S3 (s3cmd, rclone, Cyberduck, SDK AWS, etc.).
Remarque : si vous avez ouvert un nouveau terminal depuis le début du lab, placez-vous de nouveau dans le dossier de travail et redéfinissez la variable BUCKET (étape 1.2) :
Terminal window
cd~/architecte-lab07
BUCKET=architecte-lab07-<INITIALES>-<NOMBRE>
8.1 Enregistrer l’endpoint OOS dans la configuration
Dans le Lab 05, vous avez enregistré l’endpoint FCU dans le fichier ~/.aws/config. Vous y ajoutez maintenant l’endpoint OOS.
Ouvrez le fichier ~/.aws/config avec un éditeur de texte.
Remplacez son contenu par le suivant :
[default]
region= eu-west-2
output= json
services= outscale-eu-west-2
request_checksum_calculation= when_required
response_checksum_validation= when_required
[services outscale-eu-west-2]
ec2=
endpoint_url= https://fcu.eu-west-2.outscale.com
s3=
endpoint_url= https://oos.eu-west-2.outscale.com
Le bloc s3 s’applique aux commandes aws s3 et aws s3api. Respectez l’indentation de la ligne endpoint_url.
Les paramètres request_checksum_calculation et response_checksum_validation limitent le calcul et la vérification des sommes de contrôle aux seules requêtes qui les exigent. Depuis la version 2.23, AWS CLI ajoute par défaut aux requêtes S3 des sommes de contrôle qu’OOS ne prend pas en charge, ce qui provoque des erreurs.
Remarque : vous pouvez obtenir le même résultat avec les variables d’environnement AWS_REQUEST_CHECKSUM_CALCULATION=WHEN_REQUIRED et AWS_RESPONSE_CHECKSUM_VALIDATION=WHEN_REQUIRED, mais elles ne s’appliquent qu’au terminal où vous les avez définies.
Attention : si la commande renvoie l’erreur InvalidAccessKeyId, le bloc s3 est absent ou mal indenté dans ~/.aws/config. AWS CLI a alors envoyé la requête au service S3 d’AWS, qui ne connaît pas votre access key OUTSCALE. Reprenez l’étape 8.1.
Listez le contenu de votre bucket :
Terminal window
awss3lss3://$BUCKET/--recursive
Vous retrouvez les objets déposés avec octl.
AWS CLI propose deux familles de commandes pour OOS :
aws s3 : des commandes de haut niveau qui manipulent des fichiers et des dossiers (ls, cp, sync, rm, presign, etc.) ;
aws s3api : une commande par méthode de l’API S3 (create-bucket, put-object, list-object-versions, etc.), comme octl storage api.
L’objet index.html possède plusieurs versions, et vous avez téléchargé la version précédente dans v1.html (étape 4.3).
Après sa suppression, l’objet index.html a été restauré en supprimant son marqueur de suppression (étape 4.5).
L’objet rapports/2026/octobre.csv renvoie le code 403 sans authentification, mais se télécharge avec une URL pré-signée valide (partie 5).
L’adresse https://<BUCKET>.oos-website.eu-west-2.outscale.com/ affiche votre site, avec sa feuille de style, et une adresse inexistante affiche la page error.html (parties 7 et 8).
aws s3 ls s3://$BUCKET/ --recursive affiche les mêmes objets que octl storage object list --bucket $BUCKET.
Votre dernière mise en ligne contient une erreur : vous devez remettre en ligne la page Version 1 de l’étape 3, sans perdre l’historique des versions.
Avec AWS CLI, copiez la version Version 1 de l’objet index.html sur la clé index.html, avec l’ACL public-read. La copie devient la nouvelle version actuelle de l’objet.
Vérifiez dans votre navigateur que le site affiche Version 1.
Vérifiez avec octl storage object versions que toutes les versions précédentes sont toujours présentes.
Pour plus d’informations, consultez la référence de l’API OOS, qui liste les commandes AWS CLI prises en charge par OOS.
Question : Chaque version d’un objet est stockée et facturée. Comment éviter que les versions précédentes s’accumulent indéfiniment dans un bucket versionné ?
💡 Correction — Retour à une version précédente
La variable V1_ID de l’étape 4.3 contient l’identifiant de la version Version 1 (null si l’objet a été déposé avant l’activation du versioning). Si vous l’avez perdue, retrouvez-la avec la commande de l’étape 4.2.
--copy-source indique l’objet source sous la forme <bucket>/<clé>?versionId=<version>.
La réponse contient l’identifiant de la nouvelle version (VersionId). Les versions précédentes, dont les versions Version 2 et Version 3, restent disponibles : vous pouvez annuler ce retour arrière de la même façon.
--acl public-read est nécessaire : sans cette option, la copie reçoit l’ACL private et le site renvoie une erreur d’accès.
Avec une configuration de cycle de vie (lifecycle configuration) sur le bucket. Une règle de cycle de vie peut, par exemple, supprimer automatiquement les versions précédentes d’un objet un certain nombre de jours après qu’elles ont été remplacées (NoncurrentVersionExpiration), ou supprimer les marqueurs de suppression qui ne masquent plus aucune version.
Nextcloud est une plateforme open source de partage de fichiers, auto-hébergée. Configuré avec un bucket OOS comme stockage principal (primary storage), Nextcloud stocke tous les fichiers de ses utilisateurs dans le bucket, et non sur le disque de la VM : l’espace de stockage n’est plus limité par la taille du volume de la VM.
Cette partie est facultative. Elle réutilise les compétences des Labs 01 et 02.
Important : Nextcloud exige une version récente de PHP, que n’installe pas Ubuntu 22.04. Utilisez une OMI officielle OUTSCALE Ubuntu 24.04.
Dans Cockpit, créez une VM architecte-lab07-vm-nextcloud :
OMI : l’OMI officielle OUTSCALE Ubuntu-24.04 la plus récente (recherchez ubuntu-24.04) ;
type de VM : tinav6.c2r4p2 ;
volume racine de 20 GiB ;
paire de clés : architecte-lab01 ;
un Security Group architecte-lab07-sg-nextcloud qui autorise SSH (22) et HTTP (80) depuis votre seule adresse IP publique.
Vous pouvez créer la VM dans le Cloud public, comme dans le Lab 01, ou dans le Subnet public d’un Net, comme dans le Lab 02. Dans un Net, associez-lui une IP publique.
Créez un bucket dédié à Nextcloud, en remplaçant <INITIALES> et <NOMBRE> :
Conseil : dans un Net, un Net Access Point vers le service OOS permet aux VMs de joindre OOS sans passer par Internet. Pour afficher les services disponibles, utilisez octl iaas api ReadNetAccessPointServices.
Attention : configurez le stockage principal avant de terminer l’installation de Nextcloud. Configuré sur une instance existante, il rend inaccessibles tous les fichiers déjà stockés.
Créez le fichier /var/www/nextcloud/config/s3.config.php, en remplaçant <NC_BUCKET>, <ACCESS_KEY_ID> et <SECRET_KEY> :
Nextcloud lit tous les fichiers *.config.php du dossier config et les fusionne avec sa configuration principale.
use_path_style : Nextcloud adresse le bucket dans le chemin de l’URL (https://oos.eu-west-2.outscale.com/<NC_BUCKET>/...) plutôt que dans le nom d’hôte.
Donnez les fichiers de Nextcloud à l’utilisateur du serveur web :
Terminal window
sudochown-Rwww-data:www-data/var/www/nextcloud/
Ouvrez http://<IP_PUBLIQUE_VM>/ dans votre navigateur. Créez le compte administrateur, puis indiquez la base de données MariaDB : utilisateur nextcloud, mot de passe <MOT_DE_PASSE_BDD>, base nextcloud, hôte localhost.
Déposez quelques fichiers dans Nextcloud.
Listez le contenu du bucket depuis votre poste :
Terminal window
octlstorageobjectlist--bucket $NC_BUCKET
Les fichiers apparaissent sous la forme d’objets nommés urn:oid:<NOMBRE> : Nextcloud conserve les noms et l’arborescence dans sa base de données. Les fichiers ne sont donc accessibles que par Nextcloud.
Important : la VM stocke une access key dans un fichier. En production, créez un utilisateur EIM (Elastic Identity Management) dédié, dont les droits sont limités au seul bucket de Nextcloud, et utilisez ses access keys. Les utilisateurs EIM sont présentés dans le Lab 12.
Un bucket ne peut être supprimé que s’il est vide. Dans un bucket versionné, il faut supprimer toutes les versions de tous les objets, ainsi que les marqueurs de suppression : supprimer les objets avec octl storage object delete sans identifiant de version ajouterait seulement des marqueurs de suppression.
Supprimer la configuration du site web :
Terminal window
octlstoragebucketwebsitedisable $BUCKET
Supprimer toutes les versions et tous les marqueurs de suppression avec AWS CLI :
La première commande enregistre dans le fichier a-supprimer.json la clé et l’identifiant de chaque version et de chaque marqueur de suppression.
La seconde supprime définitivement, en une seule requête, toutes les versions listées dans ce fichier. Une requête peut supprimer au plus 1 000 versions.
Vérifier que le bucket est vide :
Terminal window
awss3apilist-object-versions--bucket $BUCKET
La réponse ne contient plus ni Versions ni DeleteMarkers.
Supprimer le bucket :
Terminal window
octlstoragebucketdelete $BUCKET
Confirmez la suppression en sélectionnant Yes, puis vérifiez que le bucket n’apparaît plus dans octl storage bucket list.
Si vous avez réalisé la partie Pour aller plus loin, supprimez aussi :
la VM architecte-lab07-vm-nextcloud (Terminate), puis son IP publique (Release) si vous en avez associé une ;
le Security Group architecte-lab07-sg-nextcloud ;
le bucket $NC_BUCKET, en reprenant les étapes 2 à 4 avec --bucket $NC_BUCKET.