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 で利用できるようにします。 blog や hexo のように任意の名前にできます。
  2. _config.yml を編集し、url: の値を https://username.gitlab.io/repository に変更します。
  3. コミットしてプッシュします。

便利なリンク

Next