GitLab Pages

  1. username.gitlab.ioという名前の新しいリポジトリを作成します。ここで、username はGitLabのユーザー名です。既に別のリポジトリにアップロード済みの場合は、リポジトリの名前を変更してください。
  2. 設定 > CI/CD > Runner > このプロジェクトで共有ランナーを有効にする を選択して、共有ランナーを有効にします。
  3. Hexo フォルダーのファイルをリポジトリにプッシュします。public/ フォルダーはデフォルトではアップロードされません(また、アップロードするべきではありません)。.gitignore ファイルに public/ という行が含まれていることを確認してください。フォルダー構造は、このリポジトリとほぼ同じになるはずです。
  4. node --versionコマンドを使用して、ローカルマシンで使用しているNode.jsのバージョンを確認します。メジャーバージョン(例:v16.y.z)をメモしておいてください。
  5. .gitlab-ci.yml ファイルをリポジトリのルートフォルダー(_config.yml と package.json と同じ場所)に追加し、次の内容を入力します(16 は前の手順でメモしたNode.jsのメジャーバージョンに置き換えます)。
image: node:16-alpine
cache:
paths:
- node_modules/

before_script:
- npm install hexo-cli -g
- npm install

pages:
script:
- npm run build
artifacts:
paths:
- public
rules:
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
  1. GitLab CIがデプロイジョブを完了すると、username.gitlab.io が稼働するようになります。
  2. (オプション) 生成されたサイトアセット(html、css、jsなど)を確認したい場合は、ジョブアーティファクトにあります。

プロジェクトページ

GitLabにプロジェクトページを作成したい場合

  1. 設定 > 一般 > 詳細設定 > パスの変更 に移動します。値を名前に変更して、ウェブサイトをusername.gitlab.io/repositoryで利用できるようにします。bloghexoなど、任意の名前を付けることができます。
  2. _config.yml を編集し、url: の値を https://username.gitlab.io/repositoryに変更します。
  3. コミットしてプッシュします。

便利なリンク