5
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

KDDIアジャイル開発センター(KAG)Advent Calendar 2023

Day 13

【React + CloudFront +WAF +S3】モノレポ構成でメンテナンス画面を作成する

Last updated at Posted at 2023-12-12

はじめに

React + CloudFront +WAF +S3を使用してメンテナンス画面を作成した備忘録です。
既存のアプリケーションにメンテナンス画面を実装し、状態管理で出しわけすることも考えたのですが、リダイレクトするまでに時間がかかり、アプリケーション画面が見えてしまうことが気になったのでこの方法を取りました。

今回の構成図

  • WAFはリクエスト元のIPアドレスをチェックし、Blockとなった場合はCloudFrontに403エラーを返す
  • CloudFrontのError Pagesの設定で、403エラーの向き先をメンテナンスページにし、503エラーを返すように設定する

図1.png

設定方法

メンテナンス用のS3を作成する

  • バケット名・リージョンを選択
  • パブリックアクセスは許可しておく
    image.png

作成したS3にメンテナンス用のhtmlファイルを格納する

  • S3に格納するファイルはmaintenance.htmlのみ
  • 今回はhtmlファイルとtypescriptファイルとcssファイルをwebpackで一つのファイルにまとめた
    • 「html-inline-script-webpack-plugin」...typescriptファイルをインライン化
    • 「css-minimizer-webpack-plugin」...cssファイルをインライン化
webpack.config.js
const path = require("path")
const HtmlWebpackPlugin = require("html-webpack-plugin")
const HtmlInlineScriptPlugin = require("html-inline-script-webpack-plugin")
const CssMinimizerPlugin = require("css-minimizer-webpack-plugin")

module.exports = {
    mode: "development",
    entry: "./src/index.tsx",
    output: {
        path: path.resolve(__dirname, "dist/"),
        publicPath: "/",
    },
    module: {
        rules: [
            {
                test: /\.(ts|tsx)$/,
                loader: "ts-loader",
                exclude: /node_modules/,
            },
            {
                test: /\.svg$/i,
                issuer: /\.[jt]sx?$/,
                use: ["@svgr/webpack"],
            },
            {
                test: /\.css$/i,
                use: ["style-loader", "css-loader", "postcss-loader"]
            }
        ],
    },
    plugins: [
        new HtmlWebpackPlugin({
            template: path.resolve(__dirname, "src", "index.html"),
            filename: "maintenance.html"
        }),
        new HtmlInlineScriptPlugin()
    ],
    devServer: {
        static: {
            directory: path.join(__dirname, "dist"),
        },
        hot: true,
    },
    optimization: {
        minimizer: [new CssMinimizerPlugin()],
    },
}

S3の設定を行う

  • バケットポリシーを作成する
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "PublicReadGetObject",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "${作成したS3のARN}"
        }
    ]
}
  • 静的ウェブサイトホスティングの設定
    image.png

WAFの設定

  • 全てのアクセスをBlockするweb ACLを作成

image.png

image.png

image.png

image.png

*メンテナンス画面であっても表示を許可するIPアドレスを設定したい場合は、WAFでIP setを作成して、上記で作成したACLのRulesに追加する

CloudFrontの設定

  • オリジンの作成
    • オリジンドメインは先ほど作成したS3のバケット名

image.png

  • ビヘイビアの追加

image.png

  • カスタムエラーレスポンスの追加

image.png

メンテナンスモード切り替え手順

  • WAF -> web ACLs から先ほど作成したmaintenanceをクリック
  • 「Associated AWS resources」タブを開き、Add aws resourcesをクリック

image.png

  • 該当リソースを選択してAddボタンをおす

メンテナンスモードを解除したいときは、上記で追加したリソースを削除する

まとめ

本記事ではメンテナンス画面をCloudFront +WAF +S3で表示切り替えする手順を紹介しました。

今回はメンテナンス画面を凝ったデザインで作成したかったのでS3も別途用意しましたが、HTMLのみで書ける内容であればWAFのみでメンテナンス画面の表示設定を行えるので、参考にしてみてください!

5
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
5
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?