Ubuntu 20.04 LTS のオンプレミス環境に Kubernetes 環境を構築しました。マスターノード、ワーカーノードを作成し、ワーカーノードにNginx Podを追加しました。そこまでの全手順です。

Ubuntu 20.04 LTSのオンプレにKubernetes環境構築からnginx Pod稼働まで

OpenResty(Nginx) の Lua スクリプトで CORS レスポンスヘッダーを書き換える必要がありました。その Lua スクリプト についてと、レスポンスヘッダ検証の記事です。

OpenResty(Nginx)LuaでCORS用に条件付きでレスポンスヘッダーを書き換え

# はじめに

GitLab をインストールすると、nginx がインストールされています。GitLab のインストール方法は、別記事「<a href="https://itc-engineering-blog.netlify.app/blogs/fgm-dkbu10" target="_blank">Ubuntu 20.04.2.0 に GitLab をインストール</a>」にあります。nginx の実体は、`/opt/gitlab/embedded/sbin/nginx`にインストールされます。

 

GitLab バンドルの nginx は、以下の GitLab 構造図を見ると、80,443 ポートの窓口の役割になっています。今回、これを OpenResty に変更します。

<a href="https://docs.gitlab.com/ee/development/img/architecture_simplified_v14_9.png" target="_blank" rel="nofollow noopener"><img src="https://docs.gitlab.com/ee/development/img/architecture_simplified_v14_9.png" alt="GitLab 構造図"></a>

 

【変更前】 
<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx.png" alt="GitLab 構造図 右上部分" width="330" height="331" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

 

↓

 

【変更後】 
<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/OpenResty.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/OpenResty.png" alt="GitLab 構造図 右上部分 最終版" width="641" height="331" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

 

「<a href="https://itc-engineering-blog.netlify.app/blogs/gitlab-nginx-php" target="_blank">GitLab バンドル nginx を利用して php の独自 Web アプリを同居させる手順</a>」では、GitLab バンドル nginx をそのまま利用して、Web アプリを同居させましたが、今回は、GitLab バンドル nginx を OpenResty に変更して、GitLab と Web アプリを同居させます。（今回の記事中のゴールは、Web アプリ起動＝ phpinfo 表示です。）

<blockquote class="warn">
【GitLab環境前提】
「<a href="https://itc-engineering-blog.netlify.app/blogs/fgm-dkbu10" target="_blank">Ubuntu 20.04.2.0にGitLabをインストール</a>」でインストールされた環境が前提です。
</blockquote>

<blockquote class="warn">
【OpenResty, php環境前提】
【GitLab環境前提】に加えて、GitLabインストール済み環境へ「<a href="https://itc-engineering-blog.netlify.app/blogs/lua-resty-openidc" target="_blank">OpenResty lua-resty-openidc phpでSSO Webアプリ環境作成</a>」でOpenRestyとphpがインストールされた環境からスタートが前提です。（<code>http://webapp.example.com/info.php</code>を確認するところまでやったものとします。）
また、"そもそもOpenRestyとは何か？"の部分も上記記事に記載がありますので、ここでは解説しません。Nginxのことと読み替えても支障は無いと思います。
</blockquote>

<blockquote class="warn">
【検証環境】
<code>Ubuntu 20.04.2 LTS</code>
　<code>GitLab v13.11.2</code>
　<code>nginx 1.18.0（GitLabバンドル版の方→廃止）</code>
　<code>nginx openresty/1.19.9.1</code>
　<code>PHP 8.0.14</code>
</blockquote>

 

# バンドル nginx 廃止

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx2.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx2.png" alt="バンドルnginx廃止 図" width="551" height="331" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

<a href="https://docs.gitlab.com/omnibus/settings/nginx.html#using-a-non-bundled-web-server" target="_blank">GitLab 公式マニュアル「Using a non-bundled web-server」</a>を参考に、GitLab からバンドルされた nginx を切り離して、OpenResty を使う設定にします。

```shellsession
# vi /etc/gitlab/gitlab.rb
```

```sh
# nginx['enable'] = true
↓
nginx['enable'] = false
```

・・・これだけになります。 
つまり、GitLab 公式マニュアルの「1. Disable bundled NGINX」しか必要なかったです。

反映させるために、以下を実行します。これにより、GitLab - GitLab バンドル nginx は切り離されます。

```shellsession
# gitlab-ctl stop nginx
# gitlab-ctl reconfigure
```

以下、必要なかった他の手順について、書きます。

 

**2. Set the username of the non-bundled web-server user**

```sh
# web_server['external_users'] = []
↓
web_server['external_users'] = ['www-data']
```

差し替える Web サーバーのユーザーに合わせる必要がありますが、今回の手順では、Web サーバー＝ OpenResty のユーザーの方を逆に GitLab のユーザーに合わせて `gitlab-www` にするため、何も設定しません。

 

**3. Add the non-bundled web-server to the list of trusted proxies**

```sh
# gitlab_rails['trusted_proxies'] = []
↓
gitlab_rails['trusted_proxies'] = [ '192.168.1.0/24', '192.168.2.1', '2001:0db8::/32' ]
```

差し替える Web サーバーの IP アドレスが GitLab と異なる場合、設定しないといけないようですが、今回、OpenResty が GitLab と同居するパターンのため、何も設定しません。

<blockquote class="warn">
差し替えるWebサーバーがDockerなどの時に、必要なようですが、そういったパターンでは、試していません。
</blockquote>

 

**4.(Optional) Set the right GitLab Workhorse settings if using Apache**

```sh
# gitlab_workhorse['listen_network'] = "unix"
# gitlab_workhorse['listen_addr'] = "/var/opt/gitlab/gitlab-workhorse/sockets/socket"
↓
gitlab_workhorse['listen_network'] = "tcp"
gitlab_workhorse['listen_addr'] = "127.0.0.1:8181"
```

UNIX ソケットをサポートされていない Apache の場合、TCP 通信に切り替えるために必要なようですが、今回は、OpenResty（nginx）のため、UNIX ソケットをそのまま利用し、何も設定しません。

 

**5.Download the right web server configs** 
この手順は必要ですが、`gitlab.rb`の書き換えではないため、後ほどの説明になります。

 

# パーミッション調整

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx3.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx3.png" alt="パーミッション調整 図" width="581" height="331" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

OpenResty、php-fpm のパーミッション設定を GitLab ユーザー `gitlab-www` に変更します。

```shellsession
# vi /usr/local/openresty/nginx/conf/nginx.conf
```

```nginx
user gitlab-www;
```

```shellsession
# vi /etc/php/8.0/fpm/pool.d/www.conf
```

```sh
user = gitlab-www
group = gitlab-www
と
listen.owner = gitlab-www
listen.group = gitlab-www
```

<blockquote class="info">
前回記事「<a href="https://itc-engineering-blog.netlify.app/blogs/lua-resty-openidc" target="_blank">OpenResty lua-resty-openidc phpでSSO Webアプリ環境作成</a>」に沿って、Webアプリは、<code>/opt/webapp/www/html/info.php</code>にあるものとします。
</blockquote>

```shellsession
# chown -R gitlab-www: /opt/webapp
```

 

# OpenResty 設定

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx4.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx4.png" alt="OpenResty設定 図" width="521" height="331" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

マニュアルの「GitLab recipes repository」部分がリンクになっていて、こちらから GitLab 用コンフィグファイルをダウンロードします。

<a href="https://gitlab.com/gitlab-org/gitlab-recipes/tree/master/web-server" target="_blank">`https://gitlab.com/gitlab-org/gitlab-recipes/tree/master/web-server`</a>

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image3.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image3.png" alt="GitLab用コンフィグファイルをダウンロード１" width="1223" height="582" loading="lazy"></a>

 

nginx をクリックします。

<a href="https://gitlab.com/gitlab-org/gitlab-recipes/-/tree/master/web-server/nginx" target="_blank">`https://gitlab.com/gitlab-org/gitlab-recipes/-/tree/master/web-server/nginx`</a>

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image4.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image4.png" alt="GitLab用コンフィグファイルをダウンロード２" width="1223" height="554" loading="lazy"></a>

 

「Nginx config moved to official repository」となっていて、「移動した」と言っています。 
移動先リンクをクリックします。 
<a href="https://gitlab.com/gitlab-org/gitlab-foss/-/tree/master/lib/support/nginx" target="_blank">`https://gitlab.com/gitlab-org/gitlab-foss/-/tree/master/lib/support/nginx`</a>

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image5.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image5.png" alt="GitLab用コンフィグファイルをダウンロード３" width="1222" height="676" loading="lazy"></a>

 

gitlab-ssl 　をダウンロードします。

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image6.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image6.png" alt="GitLab用コンフィグファイルをダウンロード４" width="1223" height="617" loading="lazy"></a>

<blockquote class="warn">
今回、<code>https://</code>でGitLabのソースコード管理機能に接続するため、このファイルのみになります。<code>http://</code>接続や、GitLab Pages、GitLab Registry機能の利用は想定していません。
</blockquote>

 

ダウンロードしたファイルを`/usr/local/openresty/nginx/conf/gitlab-ssl.conf`として配置し、編集します。

```shellsession
# vi /usr/local/openresty/nginx/conf/gitlab-ssl.conf
```

ここで、変えるべきところは、以下のような部分になると思います。

 

**・UNIX ドメインソケット**

```nginx
upstream gitlab-workhorse {
 # GitLab socket file,
 # for Omnibus this would be: unix:/var/opt/gitlab/gitlab-workhorse/sockets/socket
 server unix:/home/git/gitlab/tmp/sockets/gitlab-workhorse.socket fail_timeout=0;
}
↓
upstream gitlab-workhorse {
 # GitLab socket file,
 # for Omnibus this would be: unix:/var/opt/gitlab/gitlab-workhorse/sockets/socket
 #server unix:/home/git/gitlab/tmp/sockets/gitlab-workhorse.socket fail_timeout=0;
 server unix:/var/opt/gitlab/gitlab-workhorse/sockets/socket fail_timeout=0;
}
```

これは、`/etc/gitlab/gitlab.rb`に

```sh
# gitlab_workhorse['listen_addr'] = "/var/opt/gitlab/gitlab-workhorse/sockets/socket"
```

が書かれているからです。（デフォルトの UNIX ソケット位置）

 

**・GitLab サーバー名**

```nginx
 server_name YOUR_SERVER_FQDN; ## Replace this with something like gitlab.example.com
↓
 server_name gitlab-test.itccorporation.jp; ## Replace this with something like gitlab.example.com
```

GitLab のサーバー名に書き換えます。（２箇所あります。）

 

**・GitLab ログパス**

```nginx
 access_log /var/log/nginx/gitlab_access.log gitlab_ssl_access;
 error_log /var/log/nginx/gitlab_error.log;
↓
 access_log /var/log/gitlab/nginx/gitlab_access.log gitlab_ssl_access;
 error_log /var/log/gitlab/nginx/gitlab_error.log;
```

どこでも良いのですが、バンドル版 nginx が上記パスだったため、合わせます。（２箇所あります。）

 

**・SSL 証明書パス**

```nginx
 ssl_certificate /etc/nginx/ssl/gitlab.crt;
 ssl_certificate_key /etc/nginx/ssl/gitlab.key;
↓
 ssl_certificate /etc/pki/tls/certs/ca.crt;
 ssl_certificate_key /etc/pki/tls/private/ca.key;
```

設置した SSL 証明書とキーのパスに合わせます。

 

# 動作確認

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx5.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/nginx5.png" alt="include 図" width="521" height="331" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

`/usr/local/openresty/nginx/conf/gitlab-ssl.conf`を OpenResty 本体側の設定からインクルードします。

```shellsession
# vi /usr/local/openresty/nginx/conf/nginx.conf
```

```nginx
 #}
include gitlab-ssl.conf;
include webapp.conf;
}
```

末尾辺りに`include gitlab-ssl.conf;`を記入します。なお、`include webapp.conf;`は既にインストール済みの Web アプリの設定とします。

OpenResty を再起動します。

```shellsession
# systemctl restart openresty
```

 

GitLab と Web アプリは、同じ IP アドレスに名前解決できるものとします。

 

それぞれにアクセスしてみます。

・`https://gitlab-test.itccorporation.jp/`（GitLab）
<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image1.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image1.png" alt="GitLab アクセス" width="974" height="501" loading="lazy"></a>

 

・`http://webapp.example.com/`（Web アプリ）
<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image2.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-openresty-php/image2.png" alt="GitLab アクセス" width="1012" height="550" loading="lazy"></a>

 

ヨシ！

GitLab バンドル nginx を別のWebサーバー （OpenResty(nginx)） に変更して、GitLab と Web アプリを同居させる手順をまとめました。

GitLabバンドルnginx廃止→OpenResty - GitLab - Webアプリ同居手順

OpenResty と lua-resty-openidc を使って、Apache ではなく、Nginx 系のシングルサインオン（SSO）の Web アプリ動作環境を作成しましたので、その手順を紹介します。

OpenResty lua-resty-openidc phpでSSO Webアプリ環境作成

# はじめに

GitLab をインストールすると、nginx がインストールされています。GitLab のインストール方法は、別記事「<a href="https://itc-engineering-blog.netlify.app/blogs/fgm-dkbu10" target="_blank">Ubuntu 20.04.2.0 に GitLab をインストール</a>」にあります。nginx の実体は、`/opt/gitlab/embedded/sbin/nginx`にインストールされます。

 

nginx は、以下の GitLab 構造図を見ると、80,443 ポートの窓口の役割になっています。 

<a href="https://docs.gitlab.com/ee/development/img/architecture_simplified.png" target="_blank" rel="nofollow noopener"><img src="https://docs.gitlab.com/ee/development/img/architecture_simplified.png" alt="GitLab 構造図"></a>

 

GitLab をインストールした環境に GitLab とは別の Web アプリを置きたいとなったとき、GitLab バンドル nginx の設定を変更して、同居が実現できます。 
今回、php の独自 Web アプリを同居させる手順を書きます。（今回の記事中のゴールは、Web アプリ起動＝ phpinfo 表示です。）

<blockquote class="warn">
「<a href="https://itc-engineering-blog.netlify.app/blogs/fgm-dkbu10" target="_blank">Ubuntu 20.04.2.0にGitLabをインストール</a>」でインストールされた環境からスタートが前提です。
</blockquote>

<blockquote class="warn">
【検証環境】
<code>Ubuntu 20.04.2 LTS</code>
　<code>GitLab v13.11.2</code>
　<code>nginx 1.18.0</code>
　<code>PHP 8.0.13</code>
</blockquote>

 

【メモ】 
・nginx の設定ファイル 
`/var/opt/gitlab/nginx/conf/nginx.conf` 
`/var/opt/gitlab/nginx/conf/gitlab-download-app.conf`

・php-fpm の設定ファイル 
`/etc/php/8.0/fpm/php-fpm.conf`

・php の設定ファイル 
`/etc/php/8.0/fpm/php.ini`

・コマンド 
`gitlab-ctl reconfigure` 
`gitlab-ctl restart nginx` 
`systemctl restart php8.0-fpm`

 

# PHP インストール

apt を更新します。

```shellsession
# apt update
```

<blockquote class="info">
「<a href="https://itc-engineering-blog.netlify.app/blogs/i-hna4_wx" target="_blank">Ubuntu 20.04.2.0にapache2,php,postgresqlをインストール</a>」に詳しい説明付きの手順がありますので、詳しい説明は、端折ります。
</blockquote>

 

PHP8 をインストールします。（拡張モジュールは適当です。）

```shellsession
# apt -y install software-properties-common
# add-apt-repository ppa:ondrej/php
Press [ENTER] to continue or Ctrl-c to cancel adding it.
エンター
# apt update
# apt -y install php8.0 php8.0-gd php8.0-mbstring php8.0-common
# apt -y install curl
# apt -y install php8.0-curl
# php -v
PHP 8.0.13 (cli) (built: Nov 22 2021 09:50:43) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.13, Copyright (c) Zend Technologies
 with Zend OPcache v8.0.13, Copyright (c), by Zend Technologies
# curl -V
curl 7.68.0 (x86_64-pc-linux-gnu) libcurl/7.68.0 OpenSSL/1.1.1f zlib/1.2.11 brotli/1.0.7 libidn2/2.2.0 libpsl/0.21.0 (+libidn2/2.2.0) libssh/0.9.3/openssl/zlib nghttp2/1.40.0 librtmp/2.3
```

 

apache2 が同時インストールされますが、今回要らないため、削除します。 

```shellsession
# apt list --installed | grep apache2

WARNING: apt does not have a stable CLI interface. Use with caution in scripts.

apache2-bin/focal-updates,now 2.4.41-4ubuntu3.8 amd64 [インストール済み、自動]
apache2-data/focal-updates,focal-updates,now 2.4.41-4ubuntu3.8 all [インストール済み、自動]
apache2-utils/focal-updates,now 2.4.41-4ubuntu3.8 amd64 [インストール済み、自動]
apache2/focal-updates,now 2.4.41-4ubuntu3.8 amd64 [インストール済み、自動]
libapache2-mod-php8.0/focal,now 8.0.14-1+ubuntu20.04.1+deb.sury.org+1 amd64 [インストール済み、自動]
# apt -y remove apache2-*
```

 

php-fpm をインストールします。

```shellsession
# apt install -y php-fpm
```

<blockquote class="info">
【 php-fpm 】
php-fpmとは fpmはFastCGI Process Managerの略でPHP5.4.0から公式サポートされたPHP標準のアプリケーションサーバです。
</blockquote>

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/php-fpm.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/php-fpm.png" alt="php-fpmとは fpmはFastCGI Process Managerの略" width="429" height="88" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

<blockquote class="info">
【 FastCGI 】
FastCGIとは、Webサーバ上でユーザプログラムを動作させるためのインタフェース仕様の一つです。プロセスの起動/終了を省略することで、負荷を軽減しています。
</blockquote>

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/FastCGI.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/FastCGI.png" alt="FastCGIとは、Webサーバ上でユーザプログラムを動作させるためのインタフェース仕様の一つ" width="523" height="377" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

 

# php-fpm 設定

UNIX ソケットを利用する設定にします。

```shellsession
# vi /etc/php/8.0/fpm/pool.d/www.conf
```

```sh
listen = /run/php/php8.0-fpm.sock
```

※デフォルトでなっていました。（その場合は、確認のみ。）

<blockquote class="info">
【 UNIXドメインソケット 】
UNIXドメインソケットはBSDソケットの一種であり、単一マシン上でのプロセス間通信を目的としています。
単一マシン上の通信である（=インターネットを介さない）ことを生かした高効率な通信を可能にしています。
</blockquote>

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/unixsocket.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/unixsocket.png" alt="UNIXドメインソケット" width="468" height="132" style="margin-top: 5px;margin-bottom: 5px;" loading="lazy"></a>

 

php8.0-fpm が systemctl のサービスとして有効かどうか確認します。

```shellsession
# systemctl list-unit-files --type=service | grep php
```

```sh
php8.0-fpm.service enabled enabled
phpsessionclean.service static enabled
```

※デフォルトで有効になっていました。（その場合は、確認のみ。）

<blockquote class="info">
【<code>systemctl list-unit-files</code>】
定義されているサービス一覧を表示します。<code>--type=service</code>が無ければ、全てのユニットを表示します。左側が現状、右側がVENDOR PRESET、つまり、デフォルトの状態です。
</blockquote>

有効になっていない場合、有効化します。

```shellsession
# systemctl enable php8.0-fpm
```

 

`fastcgi_params` に環境変数を登録します。（ここに書いたものが php の`$_SERVER`として使える環境変数になります。）

```shellsession
# vi /var/opt/gitlab/nginx/conf/fastcgi_params
```

```sh
fastcgi_param QUERY_STRING $query_string;
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
fastcgi_param REQUEST_URI $request_uri;
fastcgi_param DOCUMENT_URI $document_uri;
fastcgi_param DOCUMENT_ROOT $document_root;
fastcgi_param SERVER_PROTOCOL $server_protocol;

fastcgi_param GATEWAY_INTERFACE CGI/1.1;
fastcgi_param SERVER_SOFTWARE nginx/$nginx_version;

fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param REMOTE_PORT $remote_port;
fastcgi_param SERVER_ADDR $server_addr;
fastcgi_param SERVER_PORT $server_port;
fastcgi_param SERVER_NAME $server_name;

fastcgi_param HTTPS $https;

# PHP only, required if PHP was built with --enable-force-cgi-redirect
fastcgi_param REDIRECT_STATUS 200;
```

 

# nginx 設定

PHP Web アプリの置き場所を`/opt/gitlab-download-app/www/html`とします。`/opt/gitlab-download-app/www/html`は任意です。

 

root ディレクトリ、ログディレクトリを作成します。

```shellsession
# mkdir -p /opt/gitlab-download-app/www/html
# chown -R gitlab-www:gitlab-www /opt/gitlab-download-app
# mkdir /var/log/gitlab-download-app
```

`chown -R gitlab-www:gitlab-www`は、`/etc/gitlab/gitlab.rb`に nginx 起動ユーザーが以下のように定義してあるからです。（コメントアウト＝デフォルト値）

```sh
# web_server['username'] = 'gitlab-www'
# web_server['group'] = 'gitlab-www'
```

 

PHP Web アプリ用の設定ファイルを新規追加します。

```shellsession
# vi /var/opt/gitlab/nginx/conf/gitlab-download-app.conf
```

サーバー名：`gitlab-download-app.itccorporation.jp`とします。

```nginix
server
{
 listen 80;
 server_name gitlab-download-app.itccorporation.jp;
 access_log /var/log/gitlab-download-app/access.log;
 error_log /var/log/gitlab-download-app/error.log;

 root /opt/gitlab-download-app/www/html;

 location /
 {
 index index.html index.htm index.php;
 }

 location ~ [^/]\.php(/|$)
 {
 fastcgi_split_path_info ^(.+?\.php)(/.*)$;
 if (!-f $document_root$fastcgi_script_name)
 {
 return 404;
 }

 client_max_body_size 100m;

 # Mitigate https://httpoxy.org/ vulnerabilities
 fastcgi_param HTTP_PROXY "";

 # fastcgi_pass 127.0.0.1:9000;
 fastcgi_pass unix:/run/php/php8.0-fpm.sock;
 fastcgi_index index.php;

 # include the fastcgi_param setting
 include fastcgi_params;

 # SCRIPT_FILENAME parameter is used for PHP FPM determining
 # the script name. If it is not set in fastcgi_params file,
 # i.e. /etc/nginx/fastcgi_params or in the parent contexts,
 # please comment off following line:
 # fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 }
}
```

 

`gitlab-download-app.conf`が GitLab バンドルの nginx に読み込まれるように、以下のように設定します。

```shellsession
# vi /etc/gitlab/gitlab.rb
```

```sh
nginx['custom_nginx_config'] = "include gitlab-download-app.conf;"
```

GitLab の設定再読み込みを行います。

```shellsession
# gitlab-ctl reconfigure
```

これにより、何が起きるかというと、GitLab バンドルの nginx の設定ファイル`/var/opt/gitlab/nginx/conf/nginx.conf`に`include gitlab-download-app.conf;`の行が追加されます。

テンプレートとして以下の eRuby ファイルが置いてあり、以下のような経緯で配置されます。

`/opt/gitlab/embedded/cookbooks/gitlab/templates/default/nginx.conf.erb` 
↓ 
`gitlab-ctl reconfigure` 
↓ 
`nginx.conf.erb` の`<%= @custom_nginx_config %>`が置換される 
↓ 
`/var/opt/gitlab/nginx/conf/nginx.conf`更新

 

`gitlab-ctl reconfigure`の度にこれを繰り返すため、`/var/opt/gitlab/nginx/conf/nginx.conf`を直接編集すると、次の`gitlab-ctl reconfigure`で直接編集した内容は消えます。変更を固定化したい場合、`/opt/gitlab/embedded/cookbooks/gitlab/templates/default/nginx.conf.erb`を書き換えると、固定化できます。（今回はその必要が無いです。）

<blockquote class="info">
【 .erb 】
.erbは、eRubyのファイルの拡張子です。
eRuby（embedded Ruby）とは、Rubyの周辺技術の一つで、HTMLへRubyスクリプトを埋め込む事を可能とする技術です。
</blockquote>

 

# php-fpm 起動～動作確認

エラーが発生した場合、画面に表示されるようにします。（任意です。）

```shellsession
# vi /etc/php/8.0/fpm/php.ini
```

```ini
display_errors = On
display_startup_errors = On
```

 

FPM プロセスのユーザーと UNIX ドメインソケットのユーザーを nginx のユーザーに合わせます。デフォルトは、www-data です。

```shellsession
# vi /etc/php/8.0/fpm/pool.d/www.conf
```

```sh
user = gitlab-www
group = gitlab-www
```

と

```sh
listen.owner = gitlab-www
listen.group = gitlab-www
```

 

GitLab と PHP Web アプリが名前解決できない場合、hosts に追加します。

```shellsession
# vi /etc/hosts
```

```sh
192.168.12.111 gitlab.itccorporation.jp
192.168.12.111 gitlab-download-app.itccorporation.jp
```

 

nginx と php-fpm をリスタートします。

```shellsession
# gitlab-ctl restart nginx
# systemctl restart php8.0-fpm
```

<blockquote class="info">
【 gitlab-ctl 】
GitLab Omnibus（いろいろバンドルされたもののこと）の１つのコンポーネントを再起動するには、<code>gitlab-ctl restart &lt;component&gt;</code>を実行します。したがって、Nginxを再起動するには<code>gitlab-ctl restart nginx</code>です。
<code>gitlab-ctl tail</code>とすると、すべてのGitLabログを表示できます。<code>gitlab-ctl tail nginx</code>はnginxログのみをtailします。
</blockquote>

 

テストアプリを作成します。（アプリが既に有る場合、目的のアプリをここに配置します。）

```shellsession
# vi /opt/gitlab-download-app/www/html/info.php
```

```php
<?php
 phpinfo();
```

 

hosts を`192.168.12.111 gitlab-download-app.itccorporation.jp`とし、 
`http://gitlab-download-app.itccorporation.jp/info.php` で確認します。

<a href="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/image1.png" target="_blank" rel="nofollow noopener"><img src="https://res.cloudinary.com/dt8zu6zzd/image/upload/blog/gitlab-nginx-php/image1.png" alt="info.php確認" width="995" height="364" loading="lazy"></a>

 

ヨシ！

GitLab をインストールした環境に GitLab とは別の Web アプリを同居させる手順です。GitLabバンドルnginxをそのまま利用します。

GitLabバンドルnginxを利用してphpの独自Webアプリを同居させる手順

前回、OS.jsインストールと公式アプリの追加をやってみましたが、 今回、既存のWebサイトをOS.jsのアプリのように組み込む方法とnginxで振り分ける方法を実践していきます。 【 Nginx 】 Nginx(エンジンエックス)は、オープンソースのWebサーバです。処理性能・高い並行性・メモリ使用量の小ささに焦点を当てて開発されており、HTTP, HTTPS, SMTP, POP3, IMAPのリバースプロキシの機能や、ロードバランサ、HTTPキャッシュなどの機能も持ちます。 ・OS.jsバックグラウンド起動設定 ・Rocket.Chat組み込み ・Wekanの組み込み ・GitLabの組み込み ・nginxインストール ・動作確認

[関連技術で絞り込み結果]

Ubuntu 20.04 LTSのオンプレにKubernetes環境構築からnginx Pod稼働まで

OpenResty(Nginx)LuaでCORS用に条件付きでレスポンスヘッダーを書き換え

GitLabバンドルnginx廃止→OpenResty - GitLab - Webアプリ同居手順

OpenResty lua-resty-openidc phpでSSO Webアプリ環境作成

GitLabバンドルnginxを利用してphpの独自Webアプリを同居させる手順

OS.jsにiframeアプリを組み込んでnginx(エンジンエックス)で振り分ける