Jenkins導入とNginxでリバースプロキシ設定
業務でCIツールとしてJenkinsを入れることになったので、その時の記録。
jenkinsの説明は、Jenkinsとはなんぞや?が簡潔でわかりやすかった。
バージョン
- nginx 1.16.1
- centOS 7.6.1810
- Jenkins 2.190.3
Jenkins導入方法
(1) install Java
Jenkinsはjavaで実装されており、javaの実行環境が必要があるためない場合はインストールする。
# openJDK
yum install java-1.8.0-openjdk
(2) install Jenkins
公式の手順。
# jenkinsのyumリポジトリを取得
wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
# 公開鍵追加
rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key
# インストール
yum install jenkins
(3) 各種設定
設定ファイル: /etc/sysconfig/jenkins
各種設定はこのファイルで変更することができる。以下は、デフォルトの値。
# ポート
JENKINS_PORT=“8080"
# 実行ユーザ
JENKINS_USER="jenkins"
実行ユーザーの変更を行った場合以下のディレクトリ/ファイルの権限も同様に変更する必要がある。
-
/var/lib/jenkins
-
/var/log/jenkins
/var/cache/jenkins
(4) 起動
# 起動
systemctl start jenkins
# 再起動
systemctl restart jenkins
# 終了
systemctl stop jenkins
# 確認
systemctl status jenkins
起動して、statusがrunningになったら、http://{IP}:{PORT}
で接続できる。外部からの接続が遮断されている場合は、解放することを忘れずに。
firewall設定 counfigure firewall 参照
Nginxでリバースプロキシ設定
リバースプロキシとは受け取ったリクエストを転送する機能で、ロードバランスや、リクエストの書き換え、アクセス制限などに使われてる。
今回、毎回ポート番号指定する代わりに、http://{IP}/jenkins
で接続できるように以下の設定を行った。
(1) jenkins側の設定
設定ファイル(/etc/sysconfig/jenkin
)を以下のように書き換える。
JENKINS_ARGS="--prefix=/jenkins"
(2) Nginx側の設定
- 共通設定:
/etc/nginx/nginx.conf
- serverブロックごとの設定:
/etc/nginx/conf.d/
- デフォルトのlistenポート80番の設定:
/etc/nginx/conf.d/default.conf
/etc/nginx/conf.d/default.conf
で80番ポートをlistenしているserverディレクティブ内に以下を追記。nginxを経由することで、リクエスト情報が変わるので、headerをここでセットしてあげる必要がある。
location ~ /jenkins {
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://jenkins;
}
変数 ($がつくものはnginxの組み込み変数。)
L $scheme
:リクエストされたスキーマ(http、https)
L $http_host
:ポート番号付きホスト
L $remote_addr
:アクセス元のIPアドレス
L $proxy_add_x_forwarded_for
:ユーザーが経由したアドレス
L $host
:マッチした、サーバ名/Hostヘッダの値。
ディレクティブ
L proxy_set_header ヘッダーフィールド名 値
:リクエストをプロキシする際に特定のヘッダ情報を付与する。
L proxy_pass 転送先
:転送先URL。
nginxで使える変数や、ディレクティブの一覧はここやここが参考になった。
/etc/nginx/conf.d/jenkins.conf
を作成し、以下を記載。127.0.0.1
は、ループバック・アドレス(自分自身を指すIPアドレス)のこと。default.confのproxy_pass http://jenkins;
のjenkinsをここで定義。
upstream jenkins {
server 127.0.0.1:8080 fail_timeout=0;
}
(3) 再起動
# jenkins再起動
systemctl restart jenkins
# nginx再起動
systemctl restart nginx
http://{IP}/jenkins
にアクセスして、jenkinsが無事に表示されたら完了。
jenkinsで"リバースプロキシの設定がおかしいようです"
のエラーが出てたが、jenkinsの管理→システムの設定→JenkinsのURLを変更すると消えた。
参考
Author And Source
この問題について(Jenkins導入とNginxでリバースプロキシ設定), 我々は、より多くの情報をここで見つけました https://qiita.com/keyy/items/3b4131ef3e857295c5b0著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .