aboutsummaryrefslogtreecommitdiff
path: root/content/prise_en_main
diff options
context:
space:
mode:
authorAlex <alex@adnab.me>2023-11-14 10:45:43 +0000
committerAlex <alex@adnab.me>2023-11-14 10:45:43 +0000
commitdb52be507f37847af85d5a1818be6a9ad4e1b2bf (patch)
tree677bba77ffe73012f00450097c14867e9697ca0e /content/prise_en_main
parent212540eaa64798efade30d0a6d60e4f3f2a60cf7 (diff)
parent306b6640a1d54af7105a235ac936e10068c6fdcf (diff)
downloadguide.deuxfleurs.fr-db52be507f37847af85d5a1818be6a9ad4e1b2bf.tar.gz
guide.deuxfleurs.fr-db52be507f37847af85d5a1818be6a9ad4e1b2bf.zip
Merge pull request 'main: Suppression des instructions en doublon avec celles du guichet' (#27) from hellpe/guide.deuxfleurs.fr:main into main
Reviewed-on: https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr/pulls/27
Diffstat (limited to 'content/prise_en_main')
-rw-r--r--content/prise_en_main/aws-cli.md22
1 files changed, 8 insertions, 14 deletions
diff --git a/content/prise_en_main/aws-cli.md b/content/prise_en_main/aws-cli.md
index 8761739..a1e7ee6 100644
--- a/content/prise_en_main/aws-cli.md
+++ b/content/prise_en_main/aws-cli.md
@@ -10,24 +10,18 @@ extra:
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](@/prise_en_main/initialiser-votre-accès.md)».
### 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
+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`.
-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'
+Vous pouvez installer `aws` :
+- soit via les paquets fournis par votre distribution (par ex. [Ubuntu](https://snapcraft.io/aws-cli) ou [Fedora](https://packages.fedoraproject.org/pkgs/awscli2/awscli2/))
+- soit en suivant les instructions sur [le site officiel d'Amazon](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
-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.
+Une fois `aws` installé sur votre machine, vous pouvez suivre les instructions de connexion indiquées sur [le guichet](https://guichet.deuxfleurs.fr/website/configure#). Cliquez sur le lien "`awscli`" dans la section "Confgurez votre logiciel" pour afficher les instructions.
### 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.
+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 :