Gérer un site web sur un bucket

Avec OUTSCALE Object Storage (OOS), vous pouvez créer un bucket et y héberger un site web statique.

Un site web statique affiche des pages web dont le contenu est principalement codé en HTML et reste identique pour les utilisateurs. Des fonctions interactives peuvent toujours être incorporées à un site web statique (en utilisant JavaScript, par exemple), mais dans une moindre mesure que les sites web dynamiques utilisant du server-side rendering (SSR) ou des bases de données.

Gérer un site web sur bucket avec AWS CLI (s3api)

Créer un site web sur bucket

Avant de commencer : Installez et configurez AWS CLI et définissez votre profil. Pour en savoir plus, voir Installer et configurer AWS CLI.

Créez un fichier index.html et un fichier error.html. À des fins de test, vous trouverez ci-dessous des exemples de contenus.

Plus souvent nommé index.html, le fichier d’index est le fichier retourné par défaut lorsqu’un utilisateur accède à la racine de votre domaine. Plus souvent nommé error.html, le fichier d’erreur est le fichier retourné lorsqu’une erreur se produit sur votre site web.

Configuration pour index.html

<!doctype html>
<html>
  <head>
    <title>Mon site web sur bucket</title>
  </head>
  <body>
    <h1>Bonjour et bienvenue sur mon site web sur bucket !</h1>
    <p>Ce site web est statique.</p>
  </body>
</html>

Configuration pour error.html

<!doctype html>
<html>
  <head>
    <title>404</title>
  </head>
  <body>
    <h1>Oups !</h1>
    <p>La page que vous recherchez est introuvable.</p>
  </body>
</html>

Créez un fichier de configuration nommé website.json. À des fins de test, vous trouverez ci-dessous des exemples de contenus.

Le fichier de configuration du site web, généralement au format JSON, sert de schéma directeur pour la manière dont votre bucket doit se comporter lorsqu’on y accède en tant que site web. Vous pouvez spécifier vos fichiers d’index et d’erreur ainsi que d’autres règles de configuration. Les exemples utilisés dans ce tutoriel sont volontairement basiques.

Configuration pour website.json

{
    "IndexDocument": {
        "Suffix": "index.html"
    },
    "ErrorDocument": {
        "Key": "error.html"
    }
}

Déposez vos objets index.html et error.html dans le bucket de votre choix en configurant une ACL public-read pour chacun d’entre eux. Pour en savoir plus, voir Déposer un objet dans un bucket.

Exemple de requête

$ aws s3api put-object \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key index.html \
    --body path/to/index.html \
    --acl public-read \
    --endpoint https://oos.eu-west-2.outscale.com

Exemple de requête

$ aws s3api put-object \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key error.html \
    --body path/to/error.html \
    --acl public-read \
    --endpoint https://oos.eu-west-2.outscale.com

Créez votre site web avec la commande put-bucket-website en suivant cette syntaxe :
Exemple de requête
```
$ aws s3api put-bucket-website \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --website-configuration file://path/to/website.json \
    --endpoint https://oos.eu-west-2.outscale.com
```
Cette commande contient les attributs suivants que vous devez spécifier :
- (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
- bucket : Le bucket dans lequel vous voulez héberger votre site web.
- website-configuration : Le chemin complet vers le fichier de configuration JSON contenant vos fichiers d’index et d’erreur.
- endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.
Votre site web est créé et est accessible en utilisant le format URL suivant : https://<BUCKET>.oos-website.<REGION>.outscale.com

Obtenir des informations sur un site web sur bucket

Pour obtenir des informations sur la configuration de votre site web sur bucket, utilisez la commande get-bucket-website en suivant cette syntaxe :

Exemple de requête

$ aws s3api get-bucket-website \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
bucket : Le nom du bucket dans lequel le site web est hébergé.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande get-bucket-website renvoie les éléments suivants :

Exemple de résultat

{
    "IndexDocument": {
        "Suffix": "index.html"
    },
    "ErrorDocument": {
        "Key": "error.html"
    }
}

IndexDocument : Le nom du fichier d’index configuré pour le site web.
ErrorDocument : Le nom du fichier d’erreur configuré pour le site web.

Supprimer un site web sur bucket

Pour supprimer un site web sur bucket, utilisez la commande delete-bucket-website en suivant cette syntaxe :

Exemple de requête

$ aws s3api delete-bucket-website \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
bucket : Le nom du bucket dans lequel le site web que vous voulez supprimer est hébergé.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

Gérer un site web sur bucket avec AWS CLI (s3)

Créer un site web sur bucket

Avant de commencer : Installez et configurez AWS CLI et définissez votre profil. Pour en savoir plus, voir Installer et configurer AWS CLI.

Créez un fichier index.html et un fichier error.html. À des fins de test, vous trouverez ci-dessous des exemples de contenus.

Plus souvent nommé index.html, le fichier d’index est le fichier retourné par défaut lorsqu’un utilisateur accède à la racine de votre domaine. Plus souvent nommé error.html, le fichier d’erreur est quant à lui le fichier retourné lorsqu’une erreur se produit sur votre site web.

Configuration pour index.html

<!doctype html>
<html>
  <head>
    <title>Mon site web sur bucket</title>
  </head>
  <body>
    <h1>Bonjour et bienvenue sur mon site web sur bucket !</h1>
    <p>Ce site web est statique.</p>
  </body>
</html>

Configuration pour error.html

<!doctype html>
<html>
  <head>
    <title>404</title>
  </head>
  <body>
    <h1>Oups !</h1>
    <p>La page que vous recherchez est introuvable.</p>
  </body>
</html>

Déposez vos objets index.html et error.html dans le bucket de votre choix en prenant soin de configurer une ACL public-read pour chacun d’entre eux. Pour en savoir plus, voir Déposer un objet dans un bucket.

Exemple de requête

$ aws s3 cp index.html s3://BUCKET/ \
   --profile YOUR_PROFILE \
   --acl public-read \
   --endpoint https://oos.eu-west-2.outscale.com

Exemple de requête

$ aws s3 cp error.html s3://BUCKET/ \
   --profile YOUR_PROFILE \
   --acl public-read \
   --endpoint https://oos.eu-west-2.outscale.com

Créez votre site web avec la commande website en suivant cette syntaxe :

Exemple de requête

$ aws s3 website s3://BUCKET/ \
    --profile YOUR_PROFILE \
    --index-document index.html \
    --error-document error.html \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

s3://BUCKET/OBJECT : Le chemin d’accès vers l’objet où votre site web est hébergé.
(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
index-document : Le chemin vers le fichier d’index à utiliser pour le site web.
error-document : Le chemin vers le fichier d’erreur à utiliser pour le site web.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

Votre site web est créé et est accessible au format URL suivant : https://<BUCKET>.oos-website.<REGION>.outscale.com

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d’Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.