- username.gitlab.io という名前の新しいリポジトリを作成します。usernameはGitLab上のユーザー名です。他のリポジトリにアップロードしている場合は、リポジトリの名前を変更してください。
- Settings > CI/CD > Runners > Enable shared runners for this project からShared Runnersを有効にします。
- Hexoフォルダのファイルをリポジトリにプッシュします。
public/
フォルダはデフォルトでアップロードされません(されるべきではありません)、.gitignore
ファイルにpublic/
行が含まれていることを確認してください。フォルダ構造は このリポジトリ 倣うべきです。 - ローカルマシンで使用している Node.js のバージョンを
node --version
で確認し、メジャーバージョン(例:v16.y.z
)を控えます。 - リポジトリに以下の内容で
.github/workflows/pages.yml
を作成します(前のステップで控えた Node.js のメジャーバージョンに16
を置き換えます):
image: node:16-alpine |
- GitLab CIがデプロイジョブを終了すると、username.gitlab.io が動作しているはずです。
- (任意)生成されたサイトアセット(html、css、jsなど)は ジョブアーティファクト でから見つけることができます。
プロジェクトページ
GitLab上でプロジェクトページを持ちたい場合は:
- Settings > General > Advanced > Change path の設定を変更し、ウェブサイトが username.gitlab.io/repository で利用できるようにします。blog や hexo のように任意の名前にできます。
- _config.yml を編集し、
url:
の値をhttps://username.gitlab.io/repository
に変更します。 - コミットしてプッシュします。