フォークされたサンプルプロジェクトからGitLab Pagesのウェブサイトを作成する

GitLabは、最も一般的な静的サイトジェネレーター（SSG）のサンプルプロジェクトを提供しています。サンプルプロジェクトをフォークして、CI/CDパイプラインを実行し、Pagesウェブサイトを生成できます。

GitLab Pagesをテストする場合、またはPagesサイトを生成するように既に構成されている新しいプロジェクトを開始する場合は、サンプルプロジェクトをフォークします。

これがどのように機能するかをビデオチュートリアルでご覧ください。

サンプルプロジェクトをフォークしてPagesウェブサイトを作成するには、次の手順に従います:

1. GitLab Pagesの例グループに移動して、サンプルプロジェクトを表示します。
2. フォークするプロジェクトの名前を選択します。
3. 右上隅でフォークを選択し、フォーク先のネームスペースを選択します。
4. プロジェクトの左側のサイドバーで、ビルド > パイプライン、パイプラインを新規作成の順に選択します。GitLab CI/CDでサイトをビルドしてデプロイします。

サイトのデプロイには、約30分かかる場合があります。パイプラインが完了したら、デプロイ > Pagesに移動して、Pagesウェブサイトへのリンクを見つけます。

リポジトリにプッシュされたすべての変更に対して、GitLab CI/CDは、Pagesサイトへの変更をすぐに公開する新しいパイプラインを実行します。

フォーク関係を削除する

フォーク元のプロジェクトにコントリビュートする場合は、フォーク関係を維持できます。それ以外の場合:

1. 左側のサイドバーで、設定 > 一般を選択します。
2. Advanced settings（高度な設定）を展開します。
3. フォークの関係を削除を選択します。

URLを変更する

ネームスペースに合わせてURLを変更できます。PagesサイトがGitLab.comでホストされている場合は、<namespace>.gitlab.ioに名前を変更できます。ここで、<namespace>はGitLabのネームスペース（プロジェクトをフォークしたときに選択したネームスペース）です。

1. 左側のサイドバーで、設定 > 一般を選択します。

2. 高度な設定を展開します。

3. パスを変更で、パスを<namespace>.gitlab.ioに更新します。

   たとえば、プロジェクトのURLがgitlab.com/gitlab-tests/jekyllの場合、ネームスペースはgitlab-testsです。

   リポジトリパスをgitlab-tests.gitlab.ioに設定すると、Pages Webサイトの結果のURLはhttps://gitlab-tests.gitlab.ioになります。

   

4. 静的サイトジェネレーター設定ファイルを開き、ベースURLを"project-name"から""に変更します。プロジェクト名の設定は静的サイトジェネレーターによって異なり、設定ファイルにない場合があります。

関連トピック

• ジョブアーティファクトをダウンロード