Fusion de la branche 'guide-web-statique'

1 files changed, 71 insertions, 0 deletions

diff --git a/content/prise_en_main/web/publier-le-contenu/aws-cli.md~ b/content/prise_en_main/web/publier-le-contenu/aws-cli.md~
new file mode 100644
index 0000000..ba74e8c
--- /dev/null
+++ b/content/prise_en_main/web/publier-le-contenu/aws-cli.md~
@@ -0,0 +1,71 @@
++++
+title = "aws-cli"
+description = "Publier avec aws-cli"
+date = 2022-09-01
+weight = 1
++++
+
+Nous allons désormais verser votre site sur Garage, ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](../initialiser-votre-acces/)».
+
+### Paramétrer votre accès localement
+Pour verser votre site sur Garage, nous allons utiliser l'outil de base pour faire des commandes S3 : [aws-cli](https://github.com/aws/aws-cli) et son binaire, `aws`. À chaque fois, il aura besoin de savoir :
+* l'identifiant de votre clé d'accès
+* votre clé d'accès secrète
+* la région et l'URL de l'infrastructure Garage qui hébergera votre site
+
+En temps normal, il faudrait préciser ces paramètres à chaque fois (donc toutes les fois que vous voulez mettre quelque chose sur votre site, ou le modifier). Pour éviter ça, on va stocker ces informations dans un fichier ; il suffira de l'invoquer avant de faire ses modifications. Dans votre répertoire personnel, créez un fichier nommé par exemple `.awsrc`. À l'intérieur, mettez le contenu suivant :
+```
+export AWS_ACCESS_KEY_ID={votre identifiant de clé d'accès}
+export AWS_SECRET_ACCESS_KEY={votre clé d'accès privée}
+export AWS_DEFAULT_REGION='garage'
+
+function aws { command aws --endpoint-url https://garage.deuxfleurs.fr $@ ; }
+aws --version
+```
+Il vous faut bien entendu insérer vos deux clés aux endroits spécifiés. Une fois ceci fait, dans le futur, avant d'utiliser `aws`, il vous faudra faire `source ~/.awsrc`, et cela mettra en place tous les paramètres pour vous. Vous serez automatiquement authentifié et vous parlerez à la bonne infrastructure Garage.
+
+### Configurer la page par défaut et celle pour les erreurs
+Puisqu'on est sur la configuration S3, profitons-en pour paramétrer une page d'accueil et une page d'erreur. En effet, les URL qu'on utilise pour naviguer sur votre site correspondront à la hiérarchie de fichiers présents sur Garage. Si on visite `https://votre-site.fr/blog/recette-de-gateau.html`, Garage va simplement servir le fichier `blog/recette-de-gateau.html`, en partant de la racine du bucket. Mais que ce passe-t-il si on demande à voir `https://votre-site.fr/blog/` ? Garage ne peut pas retourner un dossier; et de toute façon cela ne fonctionnerait pas, puisqu'un dossier n'a pas données propre à lui-même, il ne fait que contenir des fichiers distincts en son sein. On voit pourtant souvent ce genre d'URL en ligne. En fait, les serveurs web sont configurés pour que si aucun fichier du dossier n'est spécifié, alors on va utiliser celui avec un nom paramétré à l'avance. C'est de ça dont on parle.
+De même, lorsque quelqu'un demande une page qui n'existe pas, que peut faire Garage ? Dans la même logique, on va lui donner un nom de fichier à servir par défaut si jamais cela arrive.
+
+Après avoir fait votre `source ~/.awsrc`, faites :
+```
+aws s3 website exemple-un.fr --index-document index.html --error-document erreur.html
+```
+si votre `aws` est en version 2.x, ou
+```
+aws s3api put-bucket-website --bucket exemple-un.fr --website-configuration '
+{
+  "ErrorDocument": {
+    "Key": "/errors/4xx.html"
+  },
+  "IndexDocument": {
+    "Suffix": "index.html"
+  }
+}
+'
+```
+s'il est en version 1.x . Pensez à remplacer `exemple-un.fr` par votre nom de domaine à vous !
+
+### Publier
+On y est ! Avec un terminal, positionnez-vous dans le répertoire qui reflète ce que vous voulez mettre en ligne. Celui-ci devrait contenir des fichiers en `.html`, `.css`, ou `.js`, mais pas de `.md`. Si vous ne l'avez pas fait, faites `source ~/.awsrc`, et lancez ensuite :
+```
+aws s3 sync . s3://exemple-un.fr
+```
+si vous avez `aws` en version 2. N'oubliez pas de mettre votre nom de domaine à la place d'`exemple-un.fr`. Vos fichiers devrait être téléversés. Une fois le processus fini, vous devriez pouvoir ouvrir un navigateur internet tel que Firefox par exemple, tapez votre nom de domaine dans la barre URL, et naviguer sur votre site. En cas de pépin, essayez d'actualiser la page en faisant `ctrl`+`shift`+`r` avec votre clavier, ça vous garantira que votre navigateur récupère le vrai contenu en ligne au lieu de piocher dans le cache local sur votre ordinateur.
+
+### Bravo !
+Fécilicitations ! Vous avez désormais votre propre site web accessible publiquement en ligne !
+Vous pouvez rajouter dessus le badge attestant fièrement son hébergement sur Garage:
+
+[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/)
+[![Badge indiquant qu'un site est hébergé sur Garage en anglais](/img/garage_en.png)](https://garagehq.deuxfleurs.fr/)
+
+En HTML:
+```
+<a href="https://garagehq.deuxfleurs.fr/"><img src="garage_fr.png" alt="Badge indiquant que ce site est propulsé par le logiciel Garage" title="Site propulsé par Garage"></a>
+```
+En Markdown:
+```
+[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/)
+```