GitLab Pages

  1. username.gitlab.io という名前の新しいリポジトリを作成します。 usernameはGitLab上のユーザー名です。 他のリポジトリにアップロードしている場合は、リポジトリの名前を変更してください。
  2. Settings > CI/CD > Runners > Enable shared runners for this project からShared Runnersを有効にします。
  3. Hexoフォルダのファイルをリポジトリにプッシュします。 public/ フォルダはデフォルトでアップロードされません(されるべきではありません)、.gitignore ファイルに public/ 行が含まれていることを確認してください。 フォルダ構造は このリポジトリ 倣うべきです。
  4. ローカルマシンで使用している Node.js のバージョンを node --version で確認し、 メジャーバージョン (例: v16.y.z) を控えます。
  5. リポジトリのルートフォルダ (_config.tml & package.json と同じ位置) に .gitlab-ci.yml を以下のの内容で作成します (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. Settings > General > Advanced > Change pathの 設定を変更し、ウェブサイトが username.gitlab.io/repository で利用できるようにします。 bloghexo のように任意の名前にできます。
  2. _config.yml を編集し、url: の値を https://username.gitlab.io/repository に変更します。
  3. コミットしてプッシュします。

便利なリンク