Aller au contenu

Lab 07 : Utilisation du stockage objet (OOS)

À l’issue de ce lab, vous serez capable de :

  • expliquer les notions de bucket, d’objet et de clé du service OOS (OUTSCALE Object Storage) ;
  • créer un bucket et y déposer, lister et télécharger des objets avec octl ;
  • activer le versioning d’un bucket, retrouver une version précédente d’un objet et annuler une suppression ;
  • partager un objet privé pour une durée limitée avec une URL pré-signée ;
  • contrôler l’accès aux objets avec les ACL (Access Control Lists) ;
  • héberger un site web statique dans un bucket ;
  • accéder au même bucket avec AWS CLI, grâce à la compatibilité d’OOS avec l’API S3.

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 :

RégionEndpoint de l’API OOS
eu-west-2https://oos.eu-west-2.outscale.com
us-east-2https://oos.us-east-2.outscale.com
us-west-1https://oos.us-west-1.outscale.com
cloudgouv-eu-west-1https://oos.cloudgouv-eu-west-1.outscale.com
ap-northeast-1https://oos.ap-northeast-1.outscale.com

Pour la liste à jour des endpoints de tous les services, consultez la référence des endpoints des API OUTSCALE.

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.

Avant de commencer, vous devez disposer :

  • d’un compte OUTSCALE actif ;
  • d’un terminal bash avec curl et diff ;
  • d’une connexion Internet et d’un navigateur web ;
  • 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.

  1. Affichez le profil actif :

    Terminal window
    octl profile current

    Le profil default s’affiche, avec la Région eu-west-2. Si la commande échoue, reprenez la partie 2 du Lab 05.

  2. Affichez l’aide des commandes de stockage :

    Terminal window
    octl storage --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.

  1. 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.

  2. 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.

  1. Créez le bucket :

    Terminal window
    octl storage bucket create --bucket $BUCKET

    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.

  1. Listez les buckets de votre compte :

    Terminal window
    octl storage bucket list

    Votre bucket apparaît dans le tableau.

Un bucket créé sans option est privé : seul le compte qui l’a créé peut lire et modifier son contenu.

  1. Créez le fichier index.html :

    Terminal window
    cat > index.html <<'EOF'
    <html>
    <head>
    <title>Lab 07 - OOS</title>
    </head>
    <body>
    <h1>Mon site web statique</h1>
    <p>Version 1</p>
    </body>
    </html>
    EOF
  1. Déposez le fichier dans le bucket :

    Terminal window
    octl storage object put index.html --bucket $BUCKET --body index.html
    • 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.
  2. Déposez un deuxième objet, dont la clé contient un préfixe :

    Terminal window
    echo "date;ventes" > octobre.csv
    octl storage object put rapports/2026/octobre.csv --bucket $BUCKET --body octobre.csv
  1. Listez les objets du bucket :

    Terminal window
    octl storage object list --bucket $BUCKET

    Les deux objets apparaissent, avec leur clé complète, leur taille et leur date de modification.

  2. Listez uniquement les objets dont la clé commence par rapports/ :

    Terminal window
    octl storage object list --bucket $BUCKET --prefix rapports/

    Le dossier rapports/2026/ n’existe pas en tant que tel : --prefix filtre simplement les clés sur leur début.

  1. Affichez le contenu de l’objet rapports/2026/octobre.csv dans le terminal :

    Terminal window
    octl storage object download rapports/2026/octobre.csv --bucket $BUCKET

    La ligne date;ventes s’affiche.

  2. Essayez d’afficher de la même façon l’objet index.html :

    Terminal window
    octl storage object download index.html --bucket $BUCKET

    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.

  3. Téléchargez l’objet index.html dans un fichier local avec l’option -O (--out-file), puis affichez le fichier :

    Terminal window
    octl storage object download index.html --bucket $BUCKET -O index-telecharge.html
    cat index-telecharge.html

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.

  1. Activez le versioning :

    Terminal window
    octl storage bucket versioning enable $BUCKET
  2. Vérifiez l’état du versioning :

    Terminal window
    octl storage bucket versioning describe $BUCKET

    La réponse affiche status: Enabled.

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.

  1. Modifiez le fichier index.html local :

    Terminal window
    sed -i.bak 's/Version 1/Version 2/' index.html
    cat index.html

    La page affiche maintenant Version 2.

  2. Déposez de nouveau le fichier, avec la même clé :

    Terminal window
    octl storage object put index.html --bucket $BUCKET --body index.html

    La réponse contient maintenant un identifiant de version (versionid).

  3. Listez les versions des objets du bucket :

    Terminal window
    octl storage object versions --bucket $BUCKET -o table \
    -c 'Clé:.Key||Version:.VersionId||Actuelle:.IsLatest||Date:.LastModified'
    • -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.

  1. Enregistrez l’identifiant de la version précédente de index.html dans une variable :

    Terminal window
    V1_ID=$(octl storage object versions --bucket $BUCKET -s -o text \
    --jq 'select(.Key=="index.html" and .IsLatest==false) | .VersionId')
    echo $V1_ID
    • --jq filtre la réponse : ici, la version de index.html qui n’est pas la version actuelle.
    • -s (--silent) masque la ligne Resolving alias to [...], et -o text affiche la valeur sans guillemets.
  2. Téléchargez cette version dans le fichier v1.html :

    Terminal window
    octl storage object download index.html --bucket $BUCKET \
    --version "$V1_ID" -O v1.html
  3. Comparez les deux versions :

    Terminal window
    diff v1.html index.html

    diff affiche la seule ligne qui diffère : Version 1 dans v1.html, Version 2 dans index.html.

  1. Supprimez l’objet index.html :

    Terminal window
    octl storage object delete index.html --bucket $BUCKET

    Confirmez la suppression en sélectionnant Yes.

  2. Listez les objets du bucket :

    Terminal window
    octl storage object list --bucket $BUCKET

    L’objet index.html n’apparaît plus.

  3. Listez les versions :

    Terminal window
    octl storage object versions --bucket $BUCKET -o table \
    -c 'Clé:.Key||Version:.VersionId||Actuelle:.IsLatest'

    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.

  1. Affichez les marqueurs de suppression du bucket :

    Terminal window
    octl storage api ListObjectVersions --Bucket $BUCKET -s -o raw \
    --jq '.DeleteMarkers'

    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.

Pour annuler la suppression, il suffit de supprimer le marqueur de suppression : la version précédente redevient la version actuelle.

  1. Enregistrez l’identifiant du marqueur de suppression :

    Terminal window
    DM_ID=$(octl storage api ListObjectVersions --Bucket $BUCKET -s -o raw \
    --jq '.DeleteMarkers[] | select(.Key=="index.html" and .IsLatest==true) | .VersionId' \
    | tr -d '"')
    echo $DM_ID

    Avec -o raw, octl affiche les valeurs entre guillemets : tr -d '"' les supprime.

  2. Supprimez le marqueur de suppression, en indiquant son identifiant de version :

    Terminal window
    octl storage object delete index.html --bucket $BUCKET --version-id "$DM_ID" -y

    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.

  3. Vérifiez que l’objet est de retour :

    Terminal window
    octl storage object download index.html --bucket $BUCKET -O restaure.html
    cat restaure.html

    La page Version 2 s’affiche.

Attention : une suppression avec l’option --version-id supprime définitivement la version indiquée. Elle ne peut pas être annulée.

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.

  1. Essayez de télécharger l’objet rapports/2026/octobre.csv sans vous authentifier :

    Terminal window
    curl -s -o /dev/null -w "%{http_code}\n" \
    https://oos.eu-west-2.outscale.com/$BUCKET/rapports/2026/octobre.csv

    La commande affiche le code HTTP 403 (accès refusé) : l’objet est privé.

  1. Générez une URL pré-signée valable 2 minutes :

    Terminal window
    URL=$(octl storage object presign rapports/2026/octobre.csv \
    --bucket $BUCKET --expires 2m)
    echo $URL
    • --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.
  2. 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.

  3. 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.

  1. Affichez l’ACL de l’objet index.html :

    Terminal window
    octl storage object acl describe index.html --bucket $BUCKET

    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.

OOS propose des ACL prédéfinies (canned ACLs), qui remplacent l’ACL complète d’un bucket ou d’un objet :

ACL prédéfinieEffet
privateSeul le propriétaire a accès (valeur par défaut).
public-readTout le monde peut lire, sans authentification.
public-read-writeTout le monde peut lire et écrire. À ne jamais utiliser sur un bucket.
authenticated-readTout utilisateur authentifié auprès d’OOS, quel que soit son compte, peut lire.
  1. Appliquez l’ACL public-read à l’objet index.html :

    Terminal window
    octl storage api PutObjectAcl --Bucket $BUCKET --Key index.html --ACL public-read

    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.

  2. Affichez de nouveau l’ACL de l’objet :

    Terminal window
    octl storage object acl describe index.html --bucket $BUCKET

    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.

  3. Téléchargez l’objet sans vous authentifier :

    Terminal window
    curl -s https://oos.eu-west-2.outscale.com/$BUCKET/index.html

    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.

  1. Créez le fichier error.html :

    Terminal window
    cat > error.html <<'EOF'
    <html>
    <head>
    <title>Page introuvable</title>
    </head>
    <body>
    <h1>Erreur 404 : cette page n'existe pas</h1>
    </body>
    </html>
    EOF
  2. Déposez-le dans le bucket, directement avec l’ACL public-read :

    Terminal window
    octl storage object put error.html --bucket $BUCKET --body error.html --acl public-read
  1. Créez le fichier de configuration website.json :

    Terminal window
    cat > website.json <<'EOF'
    {
    "IndexDocument": { "Suffix": "index.html" },
    "ErrorDocument": { "Key": "error.html" }
    }
    EOF
    • IndexDocument : la page renvoyée quand une adresse se termine par /, par exemple la racine du site.
    • ErrorDocument : la page renvoyée quand l’objet demandé n’existe pas.

    Ce fichier reste sur votre poste : il n’est pas déposé dans le bucket.

  2. Appliquez la configuration au bucket :

    Terminal window
    octl storage bucket website configure $BUCKET --from-file website.json
  3. Vérifiez la configuration :

    Terminal window
    octl storage bucket website describe $BUCKET

Le site est accessible à l’adresse https://<BUCKET>.oos-website.<REGION>.outscale.com.

  1. Affichez l’adresse de votre site :

    Terminal window
    echo https://$BUCKET.oos-website.eu-west-2.outscale.com/
  2. Ouvrez cette adresse dans votre navigateur. La page Mon site web statique, Version 2, s’affiche.

  3. 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

Section intitulée « 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.

  1. Ouvrez le fichier ~/.aws/config avec un éditeur de texte.

  2. 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.

  1. Listez vos buckets :

    Terminal window
    aws s3 ls

    Votre bucket apparaît.

    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.

  2. Listez le contenu de votre bucket :

    Terminal window
    aws s3 ls s3://$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.

La commande aws s3 sync envoie dans un bucket les fichiers nouveaux ou modifiés d’un dossier local. octl ne propose pas encore d’équivalent.

  1. Préparez un dossier site contenant la page d’erreur, une feuille de style et une page d’accueil qui utilise cette feuille de style :

    Terminal window
    mkdir -p site
    cp error.html site/
    echo "body { font-family: sans-serif; color: #1f3a5f; }" > site/style.css
    cat > site/index.html <<'EOF'
    <html>
    <head>
    <title>Lab 07 - OOS</title>
    <link rel="stylesheet" href="style.css">
    </head>
    <body>
    <h1>Mon site web statique</h1>
    <p>Version 3</p>
    </body>
    </html>
    EOF
  2. Synchronisez le dossier avec le bucket, en rendant les fichiers publics :

    Terminal window
    aws s3 sync site/ s3://$BUCKET/ --acl public-read

    AWS CLI affiche une ligne upload pour chaque fichier envoyé.

  3. Rechargez le site web dans votre navigateur : la page affiche Version 3 et utilise maintenant la feuille de style.

  4. Listez les versions de index.html avec AWS CLI :

    Terminal window
    aws s3api list-object-versions --bucket $BUCKET --prefix index.html \
    --query 'Versions[].[Key,VersionId,IsLatest]' --output table

    Vous retrouvez les versions déposées avec octl, plus la version déposée par aws s3 sync.

Pour valider votre lab, vérifiez les points suivants :

  • octl storage bucket list affiche votre bucket architecte-lab07-<INITIALES>-<NOMBRE>.
  • octl storage bucket versioning describe $BUCKET affiche status: Enabled.
  • 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.

  1. 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.
  2. Vérifiez dans votre navigateur que le site affiche Version 1.
  3. 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.

Terminal window
aws s3api copy-object \
--bucket $BUCKET \
--key index.html \
--copy-source "$BUCKET/index.html?versionId=$V1_ID" \
--acl public-read
  • --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.
Terminal window
octl storage object versions --bucket $BUCKET -o table \
-c 'Clé:.Key||Version:.VersionId||Actuelle:.IsLatest||Date:.LastModified'
💡 Correction — Question du challenge

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.

Avec octl, les commandes correspondantes se trouvent sous octl storage bucket lifecycle. Pour plus d’informations, consultez la référence des configurations de cycle de vie OOS.

Pour aller plus loin : utiliser un bucket comme stockage principal de Nextcloud

Section intitulée « Pour aller plus loin : utiliser un bucket comme stockage principal de Nextcloud »

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.

  1. 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.

  2. Créez un bucket dédié à Nextcloud, en remplaçant <INITIALES> et <NOMBRE> :

    Terminal window
    NC_BUCKET=architecte-lab07-nextcloud-<INITIALES>-<NOMBRE>
    octl storage bucket create --bucket $NC_BUCKET

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.

  1. Connectez-vous en SSH à la VM avec l’utilisateur outscale, puis installez Apache, MariaDB et PHP :

    Terminal window
    sudo apt update
    sudo apt install -y apache2 mariadb-server libapache2-mod-php bzip2 \
    php-gd php-mysql php-curl php-mbstring php-intl php-imagick php-xml php-zip php-bcmath php-gmp
  2. Téléchargez Nextcloud et copiez-le dans /var/www :

    Terminal window
    wget https://download.nextcloud.com/server/releases/latest.tar.bz2
    tar -xjf latest.tar.bz2
    sudo cp -r nextcloud /var/www/
  3. Créez la base de données et son utilisateur, en remplaçant <MOT_DE_PASSE_BDD> par un mot de passe de votre choix :

    Terminal window
    sudo mysql <<'EOF'
    CREATE DATABASE IF NOT EXISTS nextcloud;
    CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY '<MOT_DE_PASSE_BDD>';
    GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';
    FLUSH PRIVILEGES;
    EOF
  4. Créez la configuration Apache /etc/apache2/sites-available/nextcloud.conf :

    Terminal window
    sudo tee /etc/apache2/sites-available/nextcloud.conf > /dev/null <<'EOF'
    <VirtualHost *:80>
    DocumentRoot /var/www/nextcloud
    <Directory /var/www/nextcloud/>
    Require all granted
    Options FollowSymlinks
    AllowOverride All
    <IfModule mod_dav.c>
    Dav off
    </IfModule>
    </Directory>
    </VirtualHost>
    EOF
  5. Activez le site et les modules Apache nécessaires :

    Terminal window
    sudo a2ensite nextcloud.conf
    sudo a2dissite 000-default.conf
    sudo a2enmod rewrite headers env dir mime
    sudo systemctl reload apache2

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.

  1. Créez le fichier /var/www/nextcloud/config/s3.config.php, en remplaçant <NC_BUCKET>, <ACCESS_KEY_ID> et <SECRET_KEY> :

    Terminal window
    sudo tee /var/www/nextcloud/config/s3.config.php > /dev/null <<'EOF'
    <?php
    $CONFIG = array (
    'objectstore' => array (
    'class' => '\\OC\\Files\\ObjectStore\\S3',
    'arguments' => array (
    'bucket' => '<NC_BUCKET>',
    'autocreate' => false,
    'key' => '<ACCESS_KEY_ID>',
    'secret' => '<SECRET_KEY>',
    'hostname' => 'oos.eu-west-2.outscale.com',
    'port' => 443,
    'use_ssl' => true,
    'region' => 'eu-west-2',
    'use_path_style' => true,
    ),
    ),
    );
    EOF
    • 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.
  2. Donnez les fichiers de Nextcloud à l’utilisateur du serveur web :

    Terminal window
    sudo chown -R www-data:www-data /var/www/nextcloud/
  3. 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.

  4. Déposez quelques fichiers dans Nextcloud.

    Interface de Nextcloud

  5. Listez le contenu du bucket depuis votre poste :

    Terminal window
    octl storage object list --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.

Attention : avant de supprimer une ressource, vérifiez qu’elle n’est pas utilisée par d’autres labs.

Les ressources de ce lab ne sont pas réutilisées dans les labs suivants. Conservez uniquement :

  • octl et son profil default ;
  • AWS CLI et ses fichiers de configuration ~/.aws/, dont l’endpoint OOS ajouté à l’étape 8.1.

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.

  1. Supprimer la configuration du site web :

    Terminal window
    octl storage bucket website disable $BUCKET
  2. Supprimer toutes les versions et tous les marqueurs de suppression avec AWS CLI :

    Terminal window
    aws s3api list-object-versions --bucket $BUCKET \
    --query '{Objects: [Versions, DeleteMarkers][][].{Key: Key, VersionId: VersionId}}' \
    > a-supprimer.json
    aws s3api delete-objects --bucket $BUCKET --delete file://a-supprimer.json
    • 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.
  3. Vérifier que le bucket est vide :

    Terminal window
    aws s3api list-object-versions --bucket $BUCKET

    La réponse ne contient plus ni Versions ni DeleteMarkers.

  4. Supprimer le bucket :

    Terminal window
    octl storage bucket delete $BUCKET

    Confirmez la suppression en sélectionnant Yes, puis vérifiez que le bucket n’apparaît plus dans octl storage bucket list.

  5. 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.
  6. Supprimer les fichiers locaux :

    • le dossier ~/architecte-lab07.