サイトのデプロイ
Hugoは静的サイトを生成するため、柔軟なホスティングオプションが可能です。 このページでは、Hextraサイトをさまざまなプラットフォームにデプロイするためのガイドを提供します。
GitHub Pages
GitHub Pagesは、無料でウェブサイトをデプロイおよびホストするための推奨方法です。
hextra-starter-templateを使用してサイトをブートストラップした場合、GitHub Pagesへの自動デプロイを支援するGitHub Actionsワークフローがすぐに利用可能です。
GitHub Actionsの設定
以下は、hextra-starter-templateからの設定例です:
.github/workflows/pages.yaml
# HugoサイトをGitHub Pagesにデプロイするためのサンプルワークフロー
name: Deploy Hugo site to Pages
on:
# デフォルトブランチへのプッシュ時に実行
push:
branches: ["main"]
# Actionsタブから手動でこのワークフローを実行可能
workflow_dispatch:
# GITHUB_TOKENの権限を設定してGitHub Pagesへのデプロイを許可
permissions:
contents: read
pages: write
id-token: write
# 同時実行を1つに制限し、進行中の実行と最新のキューイングされた実行の間の実行をスキップ。
# ただし、進行中の実行はキャンセルしないでください。これらの本番デプロイを完了させたいためです。
concurrency:
group: "pages"
cancel-in-progress: false
# デフォルトはbash
defaults:
run:
shell: bash
jobs:
# ビルドジョブ
build:
runs-on: ubuntu-latest
env:
HUGO_VERSION: 0.138.0
steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0 # .GitInfoと.Lastmodのためにすべての履歴を取得
submodules: recursive
- name: Setup Go
uses: actions/setup-go@v5
with:
go-version: '1.22'
- name: Setup Pages
id: pages
uses: actions/configure-pages@v4
- name: Setup Hugo
run: |
wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
&& sudo dpkg -i ${{ runner.temp }}/hugo.deb
- name: Build with Hugo
env:
# Hugoモジュールとの最大限の互換性のために
HUGO_ENVIRONMENT: production
HUGO_ENV: production
run: |
hugo \
--gc --minify \
--baseURL "${{ steps.pages.outputs.base_url }}/"
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: ./public
# デプロイジョブ
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: build
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
リポジトリ設定で、Pages > Build and deployment > Source を GitHub Actions に設定します:
デフォルトでは、上記のGitHub Actionsワークフロー .github/workflows/pages.yaml
は、サイトが https://<USERNAME>.github.io/<REPO>/
にデプロイされることを前提としています。
https://<USERNAME>.github.io/
にデプロイする場合は、--baseURL
を変更します:
.github/workflows/pages.yaml
|
|
独自のドメインにデプロイする場合は、--baseURL
の値を適宜変更してください。
Cloudflare Pages
- サイトのソースコードをGitリポジトリ(例:GitHub)に配置します。
- Cloudflareダッシュボードにログインし、アカウントを選択します。
- アカウントホームで、Workers & Pages > Create application > Pages > Connect to Git を選択します。
- リポジトリを選択し、Set up builds and deployments セクションで以下の情報を提供します:
設定 | 値 |
---|---|
本番ブランチ | main |
ビルドコマンド | hugo --gc --minify |
ビルドディレクトリ | public |
詳細については、以下を確認してください:
Netlify
- コードをGitリポジトリ(GitHub、GitLabなど)にプッシュします。
- プロジェクトをインポートしてNetlifyに追加します。
- [hextra-starter-template][hextra-starter-template]を使用していない場合、以下の設定を手動で行います:
- ビルドコマンドを
hugo --gc --minify
に設定します。 - 公開ディレクトリを
public
に指定します。 - 環境変数
HUGO_VERSION
を追加し、0.138.0
に設定するか、netlify.toml
ファイルに設定します。
- ビルドコマンドを
- デプロイします!
詳細については、NetlifyでのHugoを確認してください。
Vercel
- コードをGitリポジトリ(GitHub、GitLabなど)にプッシュします。
- Vercelダッシュボードに移動し、Hugoプロジェクトをインポートします。
- プロジェクトを設定し、フレームワークプリセットとしてHugoを選択します。
- ビルドコマンドとインストールコマンドを上書きします:
- ビルドコマンドを
hugo --gc --minify
に設定します。 - インストールコマンドを
yum install golang
に設定します。
- ビルドコマンドを
最終更新日