内容へ移動
とあるエンジニアの闇歴史帳
コピペで使える便利Wiki ※現在構築中です。
ユーザ用ツール
ログイン
トレース:
jenkins:install_centos
この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。
====== JenkinsをCentOS/RedHatに入れる ====== ~~socialite~~ Jenkinsがyumのリポジトリを公式に公開しているため、初期導入作業はほぼyumで完結します。また[[https://wiki.jenkins-ci.org/display/JENKINS/Installing+Jenkins+on+Red+Hat+distributions|わかりやすい手順が公式Wikiに掲載]]されていますので、ここではそれに習った形で記載していきます。 ===== システムの必要要件 ===== [[https://wiki.jenkins-ci.org/display/JENKINS/Installing+Jenkins#InstallingJenkins-Systemrequirement|公式Wiki]]によると現時点での条件は以下となっています。 > Jenkins requires Java7 or above to function. Java8 is recommended. Jenkins requires a fair amount of memory to operate well. Smaller installations should start around 256MB-1GB. * Java7以上が必要(Java8を推奨) * メモリ256M〜1G程度 最近のVPSサーバやクラウドであればさほど難しくなくクリアできるかと思います（他のサービスと同居させる場合は注意）。もちろんサーバではなくローカル環境に入れるのもOK。 ===== yumのリポジトリ追加 ===== リポジトリは安定版(stable)と最新版に別れていますが、大抵の場合には安定版を入れれば良いでしょう。 <code> $ sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat-stable/jenkins.repo $ sudo rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key </code> 最新版を入れたい場合は http://pkg.jenkins-ci.org/redhat/jenkins.repo をwgetしてください。 ===== Jenkinsのインストール ===== yumで一発です。 <code> $ sudo yum install jenkins </code> ===== Javaのインストール ===== Jenkins自体はJavaで書かれているため、動作にはJavaの実行環境が必要です。 JenkinsではJava7以上、Java8を推奨しています。すでにJavaがインストールされている場合で、Java7に満たない際は一度削除した後に、最新版のインストールを行ってください。 <code> $ sudo yum remove java </code> 以下のようにjavaとだけ指定するといい感じにOpenJDKを入れてくれます。 <code> $ sudo yum install java $ java -version openjdk version "1.8.0_71" OpenJDK Runtime Environment (build 1.8.0_71-b15) OpenJDK 64-Bit Server VM (build 25.71-b15, mixed mode) </code> もしリポジトリが<del>腐っている</del>古いままで、旧いバージョンを入れてしまう場合は個別にパッケージを指定してください。 <code> $ yum search OpenJDK java-1.6.0-openjdk.x86_64 : OpenJDK Runtime Environment java-1.6.0-openjdk-demo.x86_64 : OpenJDK Demos java-1.6.0-openjdk-devel.x86_64 : OpenJDK Development Environment java-1.6.0-openjdk-javadoc.x86_64 : OpenJDK API Documentation java-1.6.0-openjdk-src.x86_64 : OpenJDK Source Bundle java-1.7.0-openjdk.x86_64 : OpenJDK Runtime Environment java-1.7.0-openjdk-demo.x86_64 : OpenJDK Demos java-1.7.0-openjdk-devel.x86_64 : OpenJDK Development Environment java-1.7.0-openjdk-javadoc.noarch : OpenJDK API Documentation java-1.7.0-openjdk-src.x86_64 : OpenJDK Source Bundle java-1.8.0-openjdk.x86_64 : OpenJDK Runtime Environment java-1.8.0-openjdk-debug.x86_64 : OpenJDK Runtime Environment with full debug on java-1.8.0-openjdk-demo.x86_64 : OpenJDK Demos java-1.8.0-openjdk-demo-debug.x86_64 : OpenJDK Demos with full debug on java-1.8.0-openjdk-devel.x86_64 : OpenJDK Development Environment java-1.8.0-openjdk-devel-debug.x86_64 : OpenJDK Development Environment with full debug on java-1.8.0-openjdk-headless.x86_64 : OpenJDK Runtime Environment java-1.8.0-openjdk-headless-debug.x86_64 : OpenJDK Runtime Environment with full debug on java-1.8.0-openjdk-javadoc.noarch : OpenJDK API Documentation java-1.8.0-openjdk-javadoc-debug.noarch : OpenJDK API Documentation for packages with debug on java-1.8.0-openjdk-src.x86_64 : OpenJDK Source Bundle java-1.8.0-openjdk-src-debug.x86_64 : OpenJDK Source Bundle for packages with debug on $ sudo yum install java-1.8.0-openjdk </code> ===== 起動・停止(Start/Stop) ===== 起動・停止は他のサーバソフトウェアと同じ要領です。 <code> $ sudo service jenkins start </code> stopで停止、restartで再起動できます。他のコマンドは以下を参照。 <code> $ sudo service jenkins Usage: /etc/init.d/jenkins {start|stop|status|try-restart|restart|force-reload|reload|probe} </code> ついでに自動起動の設定もしておきましょう。 <code> $ sudo chkconfig jenkins on $ chkconfig --list | grep jenkins jenkins 0:off 1:off 2:on 3:on 4:on 5:on 6:off </code> ===== iptables/firewalldでポート開放 ===== Jenkinsはデフォルトでポート番号8080で稼働します。 もしiptablesやfirewallなどを利用している場合は開放を行うなどの設定が必要です。 <code> $ sudo vi /etc/sysconfig/iptables # Jenkins -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT $ sudo service iptables restart </code> CentOS7以降でfirewalldを使用している場合は以下のように。 <code> $ sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent $ sudo firewall-cmd --zone=public --add-service=http --permanent $ sudo firewall-cmd --reload </code> ===== 初期設定 ===== ブラウザで http://example.com:8080/ へwebブラウザからアクセス(example.comはインストール先のFQDNに置き換えてください)、無事にJenkinsの画面が表示されればインストールはひとまず完了です。執事のおじさまが左上に表示されていますよね。お疲れ様でした…と行きたいところですが、ところがどっこいもうひと踏ん張り必要です。このままだと誰でも設定をいじれてしまうため、アクセス制限をしなくてはなりません。Linuxでいうところのrootでログイン済みの画面が一般開放されちゃってる感じですね。 ==== グローバルセキュリティ設定 ==== ホーム画面(トップ画面)から、 - 左側のメニュー「Jenkinsの管理」をクリック - 「グローバルセキュリティの設定」をクリック 設定画面が開いたら「セキュリティを有効化」にチェックし、ユーザー情報欄の「Jenkinsのユーザーデータベース」を選択、最後にページ下部にある「保存」ボタンをクリックします。 {{ :jenkins:install:jenkins_install1.png?400 |}} ==== ユーザー作成 ==== 次にログインするユーザーを作成します。 ホーム画面(トップ画面)から、 - 左側のメニュー「Jenkinsの管理」をクリック - 「ユーザーの管理」をクリック - 左側のメニュー「ユーザー作成」をクリック ページが開いたら必要な情報を入力します。 {{ :jenkins:install:jenkins_install2.png?400 |}} * ユーザー名はログインする際に用いる物です。 * フルネームは表示用。 * メールアドレスにはJenkinsからビルド結果などが通知されます。 「サインアップ」ボタンをクリックしてユーザー作成が完了です。 ==== 権限管理 ==== 最後に、先ほど作成したユーザーでのみJenkinsを扱えるように設定を行います。**この設定を間違えるとログインできなくなるので注意して行ってください。** ホーム画面(トップ画面)から、 - 左側のメニュー「Jenkinsの管理」をクリック - 「グローバルセキュリティの設定」をクリック ページが表示されたら、「権限管理」の欄にある「追加するユーザー/グループ」に先ほど作成したユーザー名を入力し「追加」ボタンをクリックします。するとすぐ上にある「匿名ユーザー」の下にユーザーが追加されたと思います。\\ \\ 匿名ユーザーのチェックをすべて外し、先ほど追加したユーザーのチェックをすべてつけます（一番右端にあるボタンで一括チェックできます）。 {{ :jenkins:install:jenkins_install3.png?600 |}} 「保存」ボタンをクリックして設定が完了。 ==== ログアウトして確認 ==== ページ右上にある「ログアウト」をクリックし、以下のような表示になれば設定が正常に完了しています。 {{ :jenkins:install:jenkins_install4.png?600 |}} ==== もしも設定を間違えた場合は？ ==== ユーザーの権限設定を間違えてしまいログインができなくなった場合、SSHなどでシェルにログインし設定ファイルを直接編集してください。 <code> $ sudo vi /var/lib/jenkins/config.xml <useSecurity>false</useSecurity> $ sudo service jenkins restart </code> config.xml内にあるuserSecurityの項目をtrueからfalseに変更して保存。あとはJenkinsを再起動するだけです。 ====== 関連書籍 ====== {{amazon>jp:4774174238}} <html><p style="clear:both"></p></html> {{amazon>jp:4798035300}} <html><p style="clear:both"></p></html> ====== 参考サイト ====== 以下のページを参考にさせていただきました。ありがとうございます！ * [[https://wiki.jenkins-ci.org/display/JENKINS/Installing+Jenkins|(公式Wiki) Installing Jenkins]] * [[https://wiki.jenkins-ci.org/display/JENKINS/Installing+Jenkins+on+Red+Hat+distributions|(公式Wiki) Installing Jenkins on Red Hat distributions]] * [[http://qiita.com/n_rooms/items/2e1adefcc26d51b4e866|ユーザ作成を含む最低限のセキュリティ設定(Jenkins)]] * [[http://weblabo.oscasierra.net/install-jenkins-01/|CentOS/RedHatにJenkinsをインストールする手順 (yum, RPM)]] * [[http://toshitanian.hatenablog.com/entry/2013/09/07/200608|Jenkinsでログインできなくなった時の対処法]] {{tag>Jenkins}} ~~socialite~~
関連ページ
jenkins/install_centos.txt
· 最終更新: 2020/06/23 14:10 (外部編集)
ページ用ツール
文書の表示
バックリンク
文書の先頭へ
