Gridsome ↗ は、Vue.js ベースの Jamstack フレームワークです。デフォルトで高速な、静的生成の Web サイトとアプリケーションを作れます。このガイドでは、新しい Gridsome プロジェクトを作成し、Cloudflare Pages でデプロイします。新しい Gridsome プロジェクトを作成するコマンドラインツール @gridsome/cli ↗ を使います。
ターミナルで次のコマンドを実行し、@gridsome/cli をインストールします。
npm install --global @gridsome/cliGridsome をインストールしたら、gridsome create を実行して新しいプロジェクトをセットアップします。create コマンドは、作成するプロジェクトのディレクトリ名と、任意のスターターキット名を受け取ります。スターターの一覧は Gridsome starters ↗ を参照してください。
npx gridsome create my-gridsome-websiteすべてのフレームワークガイドは、Git ↗ の基本的な理解があることを前提としています。Git を初めて使う場合は、この Git ハンドブックの要約 ↗ で、ローカルマシンへの Git のセットアップ方法を確認してください。
SSH でクローンする場合は、GitHub に対して push または pull する各コンピューターで SSH キーを生成 ↗ する必要があります。
詳細は GitHub のドキュメント ↗ と Git のドキュメント ↗ を参照してください。
repo.new ↗ にアクセスして、新しい GitHub リポジトリを作成します。作成後、新しく作ったプロジェクトディレクトリに移動します。次のコマンドをターミナルで実行して、ローカルアプリケーションを GitHub へプッシュします。
git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin mainサイトを Pages にデプロイするには、次の手順を実行します。
サイトを Pages にデプロイする手順は次のとおりです。
-
Cloudflare ダッシュボードで Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
Create application を選択します。
-
Pages タブを選択します。
-
Import an existing Git repository を選択します。
-
作成した新しい GitHub リポジトリを選択し、Begin setup を選択します。
-
Build settings セクションで、Framework preset に Gridsome を選びます。選ぶと、次の情報が表示されます。
| 設定項目 | 値 |
|---|---|
| 本番ブランチ | main |
| ビルドコマンド | npx gridsome build |
| ビルドディレクトリ | dist |
サイトの設定が終わったら、最初のデプロイを開始できます。Cloudflare Pages が vuepress とプロジェクトの依存関係をインストールし、サイトをビルドしてからデプロイする様子が表示されます。
サイトをデプロイすると、プロジェクト専用の *.pages.dev サブドメインが割り当てられます。Gridsome プロジェクトに新しいコードをコミットするたびに、Cloudflare Pages はプロジェクトを自動で再ビルドしてデプロイします。新しいプルリクエストでは プレビューデプロイ も利用できるので、本番に出す前に変更後の見た目を確認できます。
このガイドを完了すると、Gridsome サイトを Cloudflare Pages にデプロイできています。ほかのフレームワークを始めるには、Framework ガイドの一覧 を参照してください。