GitLab Pagesのドメイン名、URL、baseurls
このドキュメントでは、GitLab Pagesのプロジェクト名をあなたのウェブサイトのURLに合わせてつける方法を学びます。
GitLab Pagesのデフォルトドメイン名
注:GitLab Pagesを使ってサイトをデプロイするために独自のGitLabインスタンスを使用している場合は、Pagesワイルドカードドメインをシステム管理者に確認してください。このガイドはどのGitLabインスタンスでも有効です。GitLab.com (
*.gitlab.io
) のPagesワイルドカードドメインを独自のものに置き換えるだけです。
GitLabでGitLab Pagesプロジェクトをセットアップすると、自動的にnamespace.example.io
のサブドメインでアクセスできるようになります。namespace
は、GitLab.comでのあなたのユーザー名か、このプロジェクトを作成したグループ名で定義されます。GitLabセルフマネージドインスタンスの場合は、example.io
をインスタンスのPagesドメインに置き換えてください。GitLab.comの場合は、Pagesドメインは*.gitlab.io
.
GitLabページの種類 | GitLabで作成されたプロジェクト名 | ウェブサイトURL |
---|---|---|
ユーザーページ | username.example.io
| http(s)://username.example.io
|
グループページ | groupname.example.io
| http(s)://groupname.example.io
|
ユーザーが所有するプロジェクトページ | projectname
| http(s)://username.example.io/projectname
|
グループが所有するプロジェクトページ | projectname
| http(s)://groupname.example.io/projectname
|
サブグループが所有するプロジェクトページ | subgroup/projectname
| http(s)://groupname.example.io/subgroup/projectname
|
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-name
- GitLab.comでは、ユーザーやグループのウェブサイトは次のようになります。
https://namespace.gitlab.io/
- GitLab インスタンスでは、上記の
gitlab.io
を Pages サーバーのドメインに置き換えてください。この情報は、システム管理者に問い合わせてください。
URLとベースウル
すべての Static Site Generator(SSG) のデフォルト設定は、あなたのウェブサイトがそのドメイン (example.com/subdir
) のサブディレクトリではなく、(サブ) ドメイン (example.com
) の下にあることを想定しています。 したがって、プロジェクトのウェブサイト (namespace.gitlab.io/project-name
) を公開するときはいつでも、SSG のドキュメントでこの設定 (ベース URL) を探し、このパターンを反映するように設定する必要があります。
例えば、Jekyll サイトの場合、baseurl
は Jekyll 設定ファイル_config.yml
で定義されています。ウェブサイトの URL がhttps://john.gitlab.io/blog/
の場合、この行を_config.yml
に追加する必要があります:
baseurl: "/blog"
逆に、私たちのデフォルトの例のいずれかをフォークした後、あなたのウェブサイトをデプロイした場合、すべての例は、プロジェクトのウェブサイトであるとして、baseurlはすでにこのように構成されています。 あなたのユーザーまたはグループのウェブサイトにすることを決定した場合、プロジェクトからこの設定を削除する必要があります。 今述べたJekyllの例では、Jekyllの_config.yml
:
baseurl: ""
カスタムドメイン
GitLab Pagesはカスタムドメインとサブドメインをサポートしており、HTTPまたはHTTPSで提供されます。 詳しくはGitLab PagesのカスタムドメインとSSL/TLS証明書をご覧ください。