Hugoで作ったブログをCloudflare Workersにデプロイする

Cloudflare WorkersとPagesの違い

Workersはエッジコンピューティングのサービスで、Pagesは静的サイトのホスティングを行うサービスです。

Hugoのデプロイ先としてはPagesが使われてきましたが…

Pagesから移行しよう?

少し前まで、なんですけどねダッシュボードにPagesからWorkersに移行しませんか?っていう表示が出ていました。

正直Pagesの手軽さはとてつもない魅力です。軽いサイトをぺっと公開できますからね。

それを捨ててWorkersに？？

とても簡単である

移行というより、このブログは元々GitHub Pagesでホスティングする予定でしたが、デプロイがうまく行かなかったため、Cloudflareで公開しています。

Workersで公開するのはとても簡単ですので、やり方を紹介します。

wrangler.jsoncの作成

プロジェクトのルートにwrangler.jsoncを作成します。
んで内容は以下のように記述します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  "name": "project-name",
  "compatibility_date": "2026-01-15",
  "assets": {
    "directory": "./public"
  },
  "routes": [
    {
      "pattern": "yourdomain.org",
      "custom_domain": true
    }
  ]
}

nameとcompatibility_date、routesのpatternは適宜置き換えるように。
なおカスタムドメインはCloudflareで管理されているものに限ります。

テストでデプロイ

デプロイにはwranglerというCloudflare公式のCLIツールを使用します。

デプロイ

1
hugo build --minify

まずはhugoをbuildして,

1
bunx wrangler deploy

を実行するとプロジェクトの作成からデプロイまでやってくれる。

カスタムドメインも設定済みなので、アクセスすれば見れるようになります!

CIの設定

このブログはGithu Actionsを使用してビルド→デプロイまでされている。
以下がワークフローファイル。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
name: Build and Deploy

on:
  push:
    branches:
      - main

defaults:
  run:
    shell: bash

jobs:
  build:
    runs-on: ubuntu-latest
    env:
      TZ: Asia/Tokyo
    steps:
      - name: checkout
        uses: actions/checkout@v6
        with:
          submodules: recursive
          fetch-depth: 0
      
      - uses: oven-sh/setup-bun@v2
      - name: setup hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: 'latest'
          extended: true
      
      - name: build
        run: |
          hugo --gc --minify
      
      - name: Deploy
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          wranglerVersion: '4.59.1'
          packageManager: bun
          command: deploy