GitLab Pagesのデフォルトドメイン名とURL
このドキュメントでは、あなたのウェブサイトのURLに従ってGitLab Pagesのプロジェクトに名前を付ける方法を学びます。
GitLab Pagesのデフォルトドメイン名
GitLab Pagesを使ってサイトをデプロイするために自分のGitLabインスタンスを使う場合は、Pagesワイルドカードドメインをシスアドで確認してください。このガイドはどのGitLabインスタンスでも有効です。ただし、GitLab.com (*.gitlab.io) のPagesワイルドカードドメインをあなた自身のものに置き換えてください。
GitLab Pages プロジェクトを GitLab でセットアップすると、自動的にnamespace.example.io のサブドメインでアクセスできるようになります。namespace は、GitLab.com でのあなたのユーザー名か、このプロジェクトを作成したグループ名で定義されます。GitLabセルフマネージドインスタンスの場合は、example.io をインスタンスのPagesドメインに置き換えてください。GitLab.comの場合、Pagesドメインは*.gitlab.io。
| GitLab Pagesの種類 | GitLabのプロジェクトのパス例 | ウェブサイトのURL |
|---|---|---|
| ユーザーページ | username/username.example.io | http(s)://username.example.io |
| グループページ | acmecorp/acmecorp.example.io | http(s)://acmecorp.example.io |
| ユーザーが所有するプロジェクトページ | username/my-website | http(s)://username.example.io/my-website |
| グループが所有するプロジェクトページ | acmecorp/webshop | http(s)://acmecorp.example.io/webshop |
| サブグループが所有するプロジェクトページ | acmecorp/documentation/product-manual | http(s)://acmecorp.example.io/documentation/product-manual |
Pagesドメインを明確に理解するために、以下の例を読んでください。
プロジェクトウェブサイトの例
- あなたは
johnというユーザー名でblogというプロジェクトを作成しました。したがって、プロジェクトの URL はhttps://gitlab.com/john/blog/となります。このプロジェクトで GitLab Pages を有効にしてサイトを構築すると、https://john.gitlab.io/blog/からアクセスできるようになります。 - あなたは
websitesというウェブサイト用のグループを作成し、このグループ内のプロジェクトをblogと名付けました。プロジェクトの URL はhttps://gitlab.com/websites/blog/です。このプロジェクトで GitLab Pages を有効にすると、サイトはhttps://websites.gitlab.io/blog/から利用できるようになります。 - あなたは、
engineeringというエンジニアリング部門用のグループを作成し、docsというすべてのドキュメントウェブサイト用のサブグループを作成し、このサブグループ内のプロジェクトをworkflowsと名付けました。プロジェクトの URL はhttps://gitlab.com/engineering/docs/workflows/です。このプロジェクトで GitLab Pages を有効にすると、サイトはhttps://engineering.gitlab.io/docs/workflowsで利用できるようになります。
ユーザーとグループのウェブサイトの例
- ユーザ名
johnで、john.gitlab.ioというプロジェクトを作成しました。プロジェクトの URL はhttps://gitlab.com/john/john.gitlab.ioです。プロジェクトの GitLab Pages を有効にすると、ウェブサイトはhttps://john.gitlab.ioの下に公開されます。 - あなたのグループ
websitesの下に、websites.gitlab.ioというプロジェクトを作成しました。プロジェクトの URL はhttps://gitlab.com/websites/websites.gitlab.ioです。プロジェクトの GitLab Pages を有効にすると、ウェブサイトはhttps://websites.gitlab.ioの下に公開されます。
一般的な例
- GitLab.comでは、プロジェクトサイトは常に
https://namespace.gitlab.io/project-slug - GitLab.comでは、ユーザーやグループのサイトは
https://namespace.gitlab.io/ - GitLab インスタンスでは、上記の
gitlab.ioを Pages サーバーのドメインに置き換えてください。この情報はシステム管理者に聞いてください。
URLとベースURL
baseurl オプションの名前が異なる場合があります。すべての静的サイト・ジェネレーター(SSG) のデフォルト設定は、ドメイン(example.com/subdir)のサブディレクトリではなく、(サブ)ドメイン(example.com)の下でWebサイトを見つけることを想定しています。したがって、プロジェクト・ウェブサイト(たとえば、namespace.gitlab.io/project-slug)を公開するときはいつでも、静的サイト・ジェネレーターのドキュメントでこの設定(ベースURL)を探し、このパターンを反映するように設定する必要があります。
たとえば、Jekyllのサイトでは、baseurl Jekyllの設定ファイルで定義されている、_config.yml 。 あなたのウェブサイトのURLがhttps://john.gitlab.io/blog/ の場合は、_config.yml にこの行を追加する必要があります：
baseurl: "/blog"
逆に、私たちのデフォルトの例のいずれかをフォークした後、あなたのウェブサイトをデプロイする場合は、baseurl すでにこのように設定されている、すべての例として、プロジェクトのウェブサイトです。あなたのユーザーまたはグループのWebサイトを作ることにした場合は、プロジェクトからこの設定を削除する必要があります。先ほど述べたJekyllの例では、Jekyllの_config.yml に変更する必要があります：
baseurl: ""
プレーンHTMLの例を使用している場合は、設定する必要はありませんbaseurl 。
カスタムドメイン
GitLab Pagesはカスタムドメインとサブドメインをサポートし、HTTPまたはHTTPSで提供します。詳しくはGitLab PagesのカスタムドメインとSSL/TLS証明書をご覧ください。