GitLab Pages を有効化する

cf. https://docs.gitlab.com/administration/pages/

GitLab Pages を有効化します。

コンテナ版手順

事前準備

下記を導入しておいてください:

• docker
• dnsmasq

手順

dnsmasq

• GitLab 本体はgitlab.example.nob, Pages はpages.example.nobで名前解決できるようにします:

# /etc/dnsmasq-hostsに記載
{gitlab IP} gitlab.example.nob

# /etc/dnsmasq.confに記載
address=/.pages.example.nob/{gitlab IP}

• 設定を反映します:

sudo systemctl restart dnsmasq

GitLab, GitLab Runner

下記で docker-compose を作成します:

services:
  gitlab:
    image: gitlab/gitlab-ee:latest
    container_name: nob-gitlab
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url "http://gitlab.example.nob"
        gitlab_rails['gitlab_shell_ssh_port'] = 2022
      # 以下pages向け設定
        pages_external_url "http://pages.example.nob"
        gitlab_pages['enable'] = true
    ports:
      - "80:80"
      - "2022:22"
    volumes:
      - "/srv/gitlab/config:/etc/gitlab"
      - "/srv/gitlab/logs:/var/log/gitlab"
      - "/srv/gitlab/data:/var/opt/gitlab"
  gitlab-runner:
    image: gitlab/gitlab-runner:latest
    container_name: nob-gitlab-runner
    volumes:
      - "/srv/gitlab/gitlab-runner/config:/etc/gitlab-runner"
      - "/var/run/docker.sock:/var/run/docker.sock"

トラブルシュート

Pages にアクセスした際に 502 エラーが発生した場合

{
  "correlation_id": "01K6SJK15KDNGSCH26TNTTH5K9",
  "error": "Get \"http://gitlab.example.nob/api/v4/internal/pages?host=first-page-c0136b.pages.example.nob\": dial tcp: lookup gitlab.example.nob on 127.0.0.11:53: no such host",
  "host": "first-page-c0136b.pages.example.nob",
  "level": "error",
  "msg": "could not fetch domain information from a source",
  "path": "/favicon.ico",
  "time": "2025-10-05T06:57:46Z"
}

上記のような、ドメインが名前解決できないエラーが発生した場合は docker-compose で DNS サーバを明示的に指定する必要があります。 docker-compose の services.gitlab.dnsを下記要領で追加してください:

services:
  gitlab:
    dns:
      - { dnsmasq IP }

パッケージ版手順

事前準備

下記を構築しておいてください:

• GitLab (パッケージ版)
• GitLab Runner (パッケージ版)
• dnsmasq

手順

dnsmasq

• GitLab 本体はgitlab.example.nob, Pages はpages.example.nobで名前解決できるようにします:

# /etc/dnsmasq-hostsに記載
{gitlab IP} gitlab.example.nob

# /etc/dnsmasq.confに記載
address=/.pages.example.nob/{gitlab IP}

• 設定を反映します:

sudo systemctl restart dnsmasq

GitLab

• /etc/gitlab/gitlab.rbに下記を追記します:

pages_external_url "http://pages.example.nob/"
gitlab_pages['enable'] = true
gitlab_pages['external_http'] = ['0.0.0.0:30090']

• 設定を反映します:

sudo gitlab-ctl reconfigure

上記設定後、ページ作成プロジェクトのパイプラインを回して成果物を作成し、Deploy -> Pages にて表示される URL から静的コンテンツにアクセスできます。