> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/publier/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-aws.md). # Configuration d’un sous-répertoire avec AWS à l’aide de CloudFront et Route 53 {% hint style="info" %} Ce guide explique comment configurer un sous-répertoire à l’aide d’AWS CloudFront et de Lambda\@Edge. Il s’agit d’une approche parmi d’autres pour les utilisateurs d’AWS. Si vous avez une configuration AWS différente (par exemple un équilibreur de charge avec des instances EC2 exécutant NGINX), vous devrez peut-être configurer votre proxy inverse différemment. Contactez [l’assistance](broken://pages/4afd87f6e45ac8235e009664242ddf1579458590) si vous avez besoin de conseils pour des configurations alternatives. {% endhint %} {% stepper %} {% step %} **Configuration de votre site GitBook** Dans votre organisation GitBook, cliquez sur le nom de votre site de documentation dans la barre latérale, puis cliquez sur **Gérer le site** ou ouvrez l’onglet **Paramètres** . Ouvrez la section **Domaine et redirections** et, sous « Sous-répertoire », cliquez sur **Configurer un sous-répertoire**. Saisissez l’URL où vous souhaitez héberger votre documentation. Indiquez ensuite le sous-répertoire d’accès à la documentation, par ex. `example.com/docs`, puis cliquez sur **Configurer**. Sous **Configuration supplémentaire**, vous verrez maintenant une URL de proxy. Vous l’utiliserez à l’étape suivante lors de la configuration de votre fonction Lambda. Copiez-la dans votre presse-papiers. {% endstep %} {% step %} **Créez votre fonction Lambda\@Edge** Connectez-vous à votre console AWS et accédez à **Lambda**. Cliquez sur le **Créer une fonction** bouton. Choisissez **Créer à partir de zéro**, puis : * Donnez à votre fonction un nom descriptif, comme `gitbook-subpath-proxy.` * Sélectionnez **Node.js** comme environnement d’exécution (utilisez la dernière version disponible). * Laissez l’architecture et les autres paramètres par défaut. Cliquez sur **Créer une fonction**. {% endstep %} {% step %} **Mettez à jour le code de la fonction Lambda** Dans l’éditeur de la fonction Lambda, remplacez le code par défaut par le suivant : {% code lineNumbers="true" %} ```javascript export const handler = async (event) => { const request = event.Records[0].cf.request; // mettez à jour si votre sous-répertoire n’est pas /docs const subdirectory = '/docs'; // mettez à jour avec votre URL de proxy ci-dessous const target = new URL(''); // réécriture : /docs* -> proxy.gitbook.site if (request.uri.startsWith(subdirectory)) { request.uri = target.pathname + request.uri.substring(subdirectory.length); // Supprimer le slash final s’il est présent if (request.uri.endsWith('/')) { request.uri = request.uri.slice(0, -1); } request.origin = { custom: { domainName: target.host, port: 443, protocol: 'https', path: '', sslProtocols: ['TLSv1.2'], readTimeout: 30, keepaliveTimeout: 5, customHeaders: {}, }, }; request.headers['host'] = [{ key: 'host', value: target.host }]; request.headers['x-forwarded-host'] = [{ key: 'x-forwarded-host', value: target.host }]; } return request; }; ``` {% endcode %} {% hint style="warning" %} Assurez-vous de mettre à jour `target` à la ligne 8 avec l’URL du proxy obtenue depuis GitBook à la première étape. Cela ressemblera à `https://proxy.gitbook.site/sites/site_XXXX` {% endhint %} {% hint style="warning" %} Assurez-vous également de mettre à jour `subdirectory` à la ligne 5 si vous utilisez un chemin de sous-répertoire différent de `/docs`. {% endhint %} Cliquez sur **Déployez** pour enregistrer vos modifications. {% endstep %} {% step %} **Configurez les autorisations Lambda pour Lambda\@Edge** Avant de pouvoir utiliser votre fonction Lambda avec CloudFront, vous devez configurer le rôle d’exécution pour autoriser Lambda\@Edge à l’assumer. 1. Dans votre fonction Lambda, cliquez sur **Configuration** onglet 2. Cliquez sur **Autorisations** dans la barre latérale gauche 3. Sous **Rôle d’exécution**, cliquez sur le nom du rôle pour l’ouvrir dans IAM 4. Cliquez sur le **Relations de confiance** onglet 5. Cliquez sur **Modifier la politique de confiance** 6. Remplacez la politique de confiance par la suivante : ```json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "edgelambda.amazonaws.com", "lambda.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] } ``` Cliquez sur **Mettre à jour la politique** pour enregistrer. {% endstep %} {% step %} **Publiez votre fonction Lambda** Lambda\@Edge nécessite une version publiée (et pas seulement `$LATEST`). 1. Dans votre fonction Lambda, cliquez sur le **Actions** menu déroulant en haut à droite 2. Sélectionnez **Publier une nouvelle version** 3. Vous pouvez éventuellement ajouter une description comme « Version initiale pour CloudFront » 4. Cliquez sur **Publier** 5. **Important :** Copiez l’ARN de la version publiée qui apparaît en haut de la page (il comprendra un numéro de version à la fin, comme `arn:aws:lambda:us-east-1:123456789:function:gitbook-subpath-proxy:1`) {% hint style="warning" %} Les fonctions Lambda\@Edge doivent être créées dans la région **us-east-1** (Virginie du Nord). Si vous avez créé votre fonction dans une autre région, vous devrez la recréer dans us-east-1. {% endhint %} {% endstep %} {% step %} **Créez votre distribution CloudFront** Accédez à **CloudFront** dans la console AWS et cliquez sur **Créer une distribution**. Configurez les paramètres suivants. Lorsque des paramètres ne sont pas spécifiés, conservez les paramètres par défaut. **Spécifier l’origine** | Paramètre | Valeur | | ------------------------- | ---------------------------------------------------------- | | **Type d’origine** | Autre | | **Origine personnalisée** | Le domaine de votre site principal (par ex. `example.com`) | **Paramètres de cache** | Paramètre | Valeur | | ---------------------------------- | ------------------------- | | **Politique de cache** | CachingDisabled | | **Politique de requête d’origine** | AllViewerExceptHostHeader | Cliquez sur **Ensuite,** sélectionnez vos protections de sécurité préférées, puis cliquez à nouveau sur **Suivant** . Cliquez sur **Créer une distribution**. Attendez que la distribution soit déployée (le statut passera de « En cours » à « Activée »). Cela peut prendre plusieurs minutes. {% endstep %} {% step %} **Associez Lambda\@Edge à CloudFront** Une fois votre distribution CloudFront déployée : 1. Cliquez sur l’ID de votre distribution pour ouvrir ses paramètres 2. Accédez à l’onglet **Comportements** onglet 3. Sélectionnez le comportement par défaut et cliquez sur **Modifier** 4. Faites défiler jusqu’à **Associations de fonctions** 5. Sous **Requête d’origine**, sélectionnez **Lambda\@Edge** 6. Dans le **champ ARN de la fonction Lambda** , collez l’ARN de votre fonction Lambda publiée (depuis l’étape 5) 7. Vérifiez **Inclure le corps** pour permettre à la fonction d’accéder aux corps des requêtes si nécessaire 8. Cliquez sur **Enregistrer les modifications** {% endstep %} {% step %} **Configurez le domaine et les enregistrements DNS** 1. Sur la page principale de votre distribution CloudFront, cliquez sur l’onglet **Général** , et sous **Noms de domaine alternatifs**, cliquez sur **Ajouter un domaine** 2. Entrez le domaine pour lequel vous configurez votre sous-répertoire, par ex. `example.com` et cliquez sur **Suivant** 3. Sélectionnez votre certificat TLS existant, ou créez-en un nouveau si nécessaire, puis cliquez sur **Suivant** à nouveau {% endstep %} {% step %} **Configurez les enregistrements DNS Route 53 à partir de CloudFront** Si vous utilisez Route 53 pour le DNS, vous devrez créer ou mettre à jour vos enregistrements DNS pour les faire pointer vers votre distribution CloudFront. 1. Tout en restant sur la page principale de votre distribution CloudFront, assurez-vous d’être sur l’onglet **Général** , puis sous l’URL que vous avez configurée dans **Noms de domaine alternatifs,** cliquez sur **Routage des domaines vers CloudFront.** 2. Cliquez sur **Configurer le routage automatiquement** pour créer des enregistrements DNS A et AAAA pour votre domaine {% hint style="info" %} Si vous n’utilisez pas Route 53, vous devrez mettre à jour les paramètres de votre fournisseur DNS pour faire pointer votre domaine vers le nom de domaine de votre distribution CloudFront. Vous pouvez le trouver dans les détails de la distribution CloudFront sous « Nom de domaine de la distribution ». {% endhint %} {% endstep %} {% step %} **Testez votre configuration** Une fois que toutes les modifications ont été propagées (cela peut prendre 10 à 15 minutes) : 1. Ouvrez un navigateur et accédez à votre domaine avec le chemin du sous-répertoire (par ex. `https://example.com/docs`) 2. Vous devriez voir votre site de documentation GitBook ! Si le site ne se charge pas immédiatement, essayez : * Attendre quelques minutes de plus pour la propagation DNS * Vider le cache de votre navigateur ou essayer une fenêtre de navigation privée * Exécuter `nslookup votredomaine.com` dans le terminal pour vérifier que la résolution DNS fonctionne correctement * Vérifier que l’état de la distribution CloudFront est « Activée » et non « En cours » {% hint style="success" %} Félicitations ! Votre documentation GitBook est désormais accessible via votre sous-répertoire personnalisé. {% endhint %} {% endstep %} {% endstepper %} ### Dépannage **La fonction Lambda ne se déclenche pas :** * Assurez-vous d’avoir publié une version de votre fonction Lambda (et de ne pas utiliser `$LATEST`) * Vérifiez que la fonction Lambda se trouve dans la région us-east-1 * Vérifiez que la politique de confiance inclut `edgelambda.amazonaws.com` **Le DNS ne se résout pas :** * Les modifications DNS peuvent prendre du temps à se propager (jusqu’à 48 heures, bien qu’en général ce soit beaucoup plus rapide) * Vérifiez que vos enregistrements Route 53 pointent vers la bonne distribution CloudFront * Vérifiez que vous avez supprimé tout ancien enregistrement DNS conflictuels **Erreurs de certificat SSL :** * Assurez-vous que votre certificat SSL dans AWS Certificate Manager inclut votre domaine personnalisé * Les certificats pour CloudFront doivent être créés dans la région us-east-1 **Le sous-répertoire ne fonctionne pas :** * Vérifiez la `SOUS-RÉPERTOIRE` valeur dans votre fonction Lambda correspond à ce que vous avez configuré dans GitBook * Vérifiez que le `target` dans votre fonction Lambda est correct * Consultez les journaux CloudFront pour voir si les requêtes atteignent la distribution --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/publier/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-aws.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.