Appearance
Kantan CMSホスティング
概要
Kantan CMSは組み込みの静的サイトホスティングサービスを提供し、プラットフォームから直接ウェブサイトを公開することができます。このサービスは、React、Vue、その他の静的サイトジェネレーター(SSG)などの最新のフレームワークから生成されたものを含む静的ウェブサイト向けに設計されています。
Kantan CMSホスティングでは、以下のことが可能です:
- 別のホスティングインフラを管理せずにウェブサイトをデプロイする
<project_id>.kantan-cms.websiteで無料のサブドメインを取得する- DNS設定で独自のカスタムドメインを接続する
- CMSインターフェースから直接デプロイメントを管理する
ホスティング方法
Kantan CMSはウェブサイトをデプロイするための2つの主要な方法を提供しています:
1. ZIPファイルでホスティング
この方法では、事前にビルドされたウェブサイトをZIPアーカイブとしてアップロードできます:
ウェブサイトをビルドする
- 好みのフレームワークやツールを使用して、ウェブサイトの静的バージョンを生成する
- ビルドにはルートレベルに
index.htmlファイルが含まれていることを確認する
ZIPアーカイブを作成する
- ビルドされたウェブサイトファイルをZIPアーカイブに圧縮する
- ZIPのルートレベルに
index.htmlを維持する構造になっていることを確認する
Kantan CMSにアップロードする
- プロジェクトのホスティング > ビルドプレホストに移動する
- 「ZIPファイルをアップロード」を選択する
- ZIPアーカイブを選択してアップロードする
- すべてが正しく表示されることを確認するためにプレホストバージョンを確認する
ウェブサイトを公開する
- プレホストバージョンを確認したら、「ビルドホスト」をクリックする
- ウェブサイトがデプロイされ、
<project_id>.kantan-cms.websiteで利用可能になる
2. GitHub Actionsでホスティング
この方法では、GitHubリポジトリからの継続的デプロイメントが可能になります:
GitHub統合を設定する
https://github.com/apps/kantan-cms-appにアクセスし、アプリがリポジトリにアクセスすることを許可する- これにより、Kantan CMSはGitHubリポジトリからビルドとデプロイメントをトリガーできるようになる
GitHub Actionワークフローを作成する
- リポジトリにGitHub Actionsワークフローファイルを追加する(例:
.github/workflows/deploy.yml) - 以下のテンプレートを出発点として使用する:
- リポジトリにGitHub Actionsワークフローファイルを追加する(例:
yaml
name: Deploy to Kantan CMS
on:
workflow_dispatch:
inputs:
project_id:
description: "project_id"
required: true
cms_url:
description: "cms_url"
required: false
env:
CMS_API_KEY: ${{ secrets.CMS_API_KEY }}
PROJECT_ID: ${{ github.event.inputs.project_id }}
CMS_BASE_URL: ${{ github.event.inputs.cms_url }}
steps:
# ビルドとデプロイメントのステップをここに追加
# 例:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: '18'
- run: npm ci
- run: npm run build
# Kantan CMSデプロイメントステップを追加
# (正確な構文についてはGitHub統合ドキュメントを参照)Kantan CMSでGitHub統合を設定する
- 設定 > GitHub統合に移動する
- リポジトリ情報を入力する
- 設定を保存する
GitHubでデプロイする
- ホスティング > ビルドプレホストに移動する
- 「GitHubでデプロイ」を選択する
- 必要な情報を入力する
- デプロイメントをトリガーする
ウェブサイトを公開する
- プレホストバージョンを確認したら、「ビルドホスト」をクリックする
- ウェブサイトがデプロイされ、
<project_id>.kantan-cms.websiteで利用可能になる
URLルーティング動作
Kantan CMSホスティングは、理解しておくことが重要な特定の方法でURLルーティングを処理します:
末尾のスラッシュがないURL:自動的にサフィックスに
.htmlを追加します- 例:
example.kantan-cms.website/aboutはabout.htmlを提供します
- 例:
末尾のスラッシュがあるURL:そのディレクトリの
index.htmlファイルを提供します- 例:
example.kantan-cms.website/blog/は/blog/index.htmlを提供します
- 例:
この動作は、ウェブサイトの構造と内部リンクを作成する際に考慮することが重要です。
カスタムドメイン設定
Kantan CMSホスティングで独自のドメインを使用するには:
- プロジェクトの設定 > ホスティングに移動します
- 使用したいカスタムドメインを入力します
- 設定を保存します
- カスタムドメイン設定セクションが表示され、以下が含まれます:
- ドメインをKantan CMSサーバーに向けるためのCNAMEレコード
- ドメイン所有権を確認するためのTXTレコード
- ドメインレジストラを通じて、これらのレコードをドメインのDNS設定に追加します
- Kantan CMSに戻り、「更新」をクリックして確認をチェックします
- 確認されると、ウェブサイトはカスタムドメインからアクセスできるようになります
DNS設定に関する詳細な手順については、「Kantan CMSへのDNS接続」ドキュメントを参照してください。