New: The GitBook MCP server is here.
Connect your AI agent
Ctrlk
ProductPricingBook a demoLog inSign up
For the complete documentation index, see llms.txt. This page is also available as Markdown.

CloudFrontとRoute 53を使ってAWSでサブディレクトリを設定する

AWS CloudFrontとRoute 53を使って、/docsサブディレクトリでドキュメントをホストします。

このガイドでは、AWS CloudFront と Lambda@Edge を使ってサブディレクトリを設定する方法を説明します。これは AWS ユーザー向けの一つの方法です。別の AWS 構成（たとえば、NGINX を実行している EC2 インスタンスを持つロードバランサーなど）を使っている場合は、リバースプロキシの設定を別に行う必要があるかもしれません。お問い合わせ サポート 代替構成についての案内が必要な場合は。

1

GitBookサイトの設定

GitBook の組織で、サイドバーのドキュメントサイト名をクリックし、次に サイトを管理 または 設定 タブを開いて ドメインとリダイレクト セクションを開き、「Subdirectory」の下で、クリック サブディレクトリを設定.

ドキュメントをホストしたいURLを入力してください。次に、ドキュメントにアクセスするためのサブディレクトリを指定します。例： example.com/docs、そして 設定.

次の項目の下で 追加設定すると、プロキシ URL が表示されます。次の手順で Lambda 関数を設定するときにこれを使用します。クリップボードにコピーしてください。

2

Lambda@Edge 関数を作成する

AWS コンソールにサインインし、 Lambda.

をクリックするか、 関数の作成 ボタン。

選択 一から作成、次に:

  • 関数にわかりやすい名前を付けます。たとえば gitbook-subpath-proxy。

  • を選択します Node.js をランタイムとして使用します（利用可能な最新バージョンを使用してください）。

  • アーキテクチャとその他の設定はデフォルトのままにします。

クリックして 関数の作成.

3

Lambda 関数のコードを更新する

Lambda 関数エディタで、デフォルトのコードを次の内容に置き換えます:

export const handler = async (event) => {
	const request = event.Records[0].cf.request;
	
	// サブディレクトリが /docs でない場合は更新
	const subdirectory = '/docs';
	
	// 以下のプロキシ URL に更新
	const target = new URL('<GitBook から取得した proxy URL>');

	// 書き換え: /docs* -> proxy.gitbook.site
	if (request.uri.startsWith(subdirectory)) {
		request.uri = target.pathname + request.uri.substring(subdirectory.length);

		// 末尾のスラッシュがあれば削除
		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;
};

必ず target を 8 行目で、最初の手順で GitBook から取得したプロキシ URL に更新してください。これは次のようになります https://proxy.gitbook.site/sites/site_XXXX

また、 subdirectory を 5 行目で、次のパスではなく別のサブディレクトリパスを使っている場合は更新してください: /docs.

クリックして デプロイ して変更を保存します。

4

Lambda@Edge 用の Lambda 権限を設定する

CloudFront で Lambda 関数を使用する前に、Lambda@Edge がその関数を引き受けられるように実行ロールを設定する必要があります。

  1. Lambda 関数で、 設定 タブ

  2. クリックして 権限 を左側のサイドバーで

  3. 次の項目の下で 実行ロールをクリックして IAM で開きます

  4. をクリックするか、 信頼関係 タブ

  5. クリックして 信頼ポリシーを編集

  6. 信頼ポリシーを次の内容に置き換えます:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "edgelambda.amazonaws.com",
                    "lambda.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

クリックして ポリシーを更新 して保存します。

5

Lambda 関数を公開する

Lambda@Edge では公開済みのバージョンが必要です（ $LATEST).

  1. Lambda 関数で、 アクション 右上のドロップダウンをクリックし、

  2. を選択します 新しいバージョンを公開

  3. 必要に応じて「CloudFront 用の初期バージョン」などの説明を追加します

  4. クリックして 公開

  5. 重要: ページ上部に表示される公開済みバージョンの ARN をコピーしてください（末尾にバージョン番号が付く形式です。たとえば arn:aws:lambda:us-east-1:123456789:function:gitbook-subpath-proxy:1)

Lambda@Edge 関数は us-east-1 （米国東部 1（バージニア北部））リージョンで作成する必要があります。別のリージョンで関数を作成した場合は、us-east-1 で作り直す必要があります。

6

CloudFront ディストリビューションを作成する

に移動します AWS コンソールで CloudFront を開き、 にクリック ディストリビューションを作成.

次の設定を構成します。指定がない設定はデフォルトのままにしてください。

オリジンを指定

設定
値

オリジンの種類

その他

カスタムオリジン

メインの Web サイトのドメイン（例: example.com)

キャッシュ設定

設定
値

キャッシュポリシー

CachingDisabled

オリジンリクエストポリシー

AllViewerExceptHostHeader

クリックして 次に、 お好みのセキュリティ保護を選択してから、 次へ をもう一度クリックします。

クリックして ディストリビューションを作成.

ディストリビューションのデプロイが完了するまで待ちます（ステータスは「In Progress」から「Enabled」に変わります）。数分かかる場合があります。

7

Lambda@Edge を CloudFront に関連付ける

CloudFront ディストリビューションがデプロイされたら:

  1. ディストリビューション ID をクリックして設定を開きます

  2. に移動し、 ビヘイビア タブ

  3. デフォルトのビヘイビアを選択して、 編集

  4. 下にスクロールして 関数の関連付け

  5. 次の項目の下で オリジンリクエスト、次を選択します Lambda@Edge

  6. 次の場所で Lambda 関数 ARN フィールドに、公開した Lambda 関数の ARN を貼り付けます（手順 5 から）

  7. 確認してください 本文を含める 必要に応じて関数がリクエスト本文にアクセスできるようにするため

  8. クリックして 変更を保存

8

ドメインと DNS レコードを設定する

  1. CloudFront ディストリビューションのメインページで、 全般 タブをクリックし、 代替ドメイン名、をクリックします ドメインを追加

  2. サブディレクトリを構成するドメインを入力します。例: example.com に戻って 次へ

  3. 既存の TLS 証明書を選択するか、必要に応じて新規作成し、 次へ をもう一度クリックします

9

CloudFront から Route 53 DNS レコードを設定する

DNS に Route 53 を使用している場合は、DNS レコードを作成または更新して CloudFront ディストリビューションを指すようにする必要があります。

  1. CloudFront ディストリビューションのメインページのまま、 全般 タブを開き、その下の、で設定した URL の下に 代替ドメイン名、 をクリックします Route ドメインを CloudFront にルーティングします。

  2. をクリックします ルーティングを自動的に設定 して、ドメインの A および AAAA の DNS レコードを作成します

Route 53 を使っていない場合は、DNS プロバイダーの設定を更新して、ドメインを CloudFront ディストリビューションのドメイン名に向ける必要があります。これは CloudFront ディストリビューションの詳細の「Distribution domain name」で確認できます。

10

設定をテストする

すべての変更が伝播したら（これには 10〜15 分かかることがあります）：

  1. ブラウザを開き、サブディレクトリのパス付きでドメインに移動します（例: https://example.com/docs)

  2. GitBook のドキュメントサイトが表示されるはずです！

サイトがすぐに読み込まれない場合は、次を試してください:

  • DNS の伝播を待つために数分待つ

  • ブラウザのキャッシュをクリアするか、シークレットウィンドウを試す

  • 実行 nslookup yourdomain.com をターミナルで実行して、DNS が正しく解決されているか確認する

  • CloudFront ディストリビューションのステータスが「In Progress」ではなく「Enabled」になっているか確認する

おめでとうございます！GitBook のドキュメントがカスタムサブディレクトリ経由でアクセスできるようになりました。

トラブルシューティング

Lambda 関数がトリガーされない:

  • Lambda 関数の公開済みバージョンを使用していることを確認してください（ $LATEST)

  • Lambda 関数が us-east-1 リージョンにあることを確認してください

  • 信頼ポリシーに次が含まれていることを確認してください edgelambda.amazonaws.com

DNS が解決されない:

  • DNS の変更が伝播するまで時間がかかる場合があります（最大 48 時間ですが、通常はもっと早いです）

  • Route 53 のレコードが正しい CloudFront ディストリビューションを指しているか確認してください

  • 競合する古い DNS レコードを削除したことを確認してください

SSL 証明書エラー:

  • AWS Certificate Manager の SSL 証明書にカスタムドメインが含まれていることを確認してください

  • CloudFront 用の証明書は us-east-1 リージョンで作成する必要があります

サブディレクトリが機能しない:

  • 確認してください SUBDIRECTORY Lambda 関数内の値が GitBook で設定した内容と一致していること

  • 確認してください target Lambda 関数内の

  • CloudFront ログを確認して、リクエストがディストリビューションに到達しているか見てください

最終更新

役に立ちましたか？