RedmineをCentOSに自動インストールするためのAnsibleプレイブック mariadb利用、 Redmine UnofficialCooking版(3.3/3.4)
Clone or download
Pull request Compare This branch is 114 commits ahead of ssaito:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docker
group_vars
roles
LICENSE.md
README.md
hosts
site.yml

README.md

redmine-centos-ansible

最小構成でインストールしたCentOSにRedmine/Redmicaを自動インストールするためのAnsibleプレイブックです。

コマンド数個をコピペ実行し、あとはしばらく放置プレイすればインストールが完了します。

注意事項

本プレイブックは、Redmine3.4対応 UnofficialCooking版(闇鍋版)です。

Redmine標準外の変更取込、backport、admin初期パスワードの変更、Plugin,テーマの一括インストールを行います。(2017/9/10時点では本家+プラグイン+テーマ)

自己責任でご利用ください。

Docker上で利用する場合は、本手順書後半の手順を参照ください。

Vagrant環境上では、そのままで動作しません。(今後の課題)

システム構成

  • Redmine 3.4
  • CentOS 7
  • mariadb
  • Apache

概要

Ansibleを使ってRedmineを自動インストールするためのプレイブックです。

以下のwebサイトで紹介されている手順におおむね準拠しています。

Redmine 3.2をCentOS 7.1にインストールする手順

Redmine標準からの変更内容

カテゴリのサブプロジェクト継承機能を追加しています。(標準のバージョンと同じ)

https://github.com/y503unavailable/redmine/issues/14

Redmine標準からの変更内容は下記参照ください。

取り込んだ機能はRedmine.TokyoのUnofficialCookingで説明しています。

https://github.com/y503unavailable/redmine/blob/3.4-unofficialcooking/README.rdoc     (未作成)

https://redmine.tokyo/projects/unofficialcooking

同時インストールするプラグイン

full_text_search, view_customize, issue_templates, banner, wiki_lists, work_time,wiki_extensions, xlsx_format_issue_exporter, pivot_table, absolute_dates, startpage , theme_changer,mermaid_macro,redmine_tags,redmine_wysiwyg_editor (2018/9/1現在)

詳細は下記参照ください。

https://github.com/y503unavailable/redmine-centos-ansible/tree/3.4-unofficialcooking/roles/redmine-plugins/tasks/main.yml

同時インストールするテーマ

farend_basic,redmine_flat,gitmike,PurpleMine2,minimalflat2,flatly_light (2018/10/1現在)

詳細は下記参照ください。

https://github.com/y503unavailable/redmine-centos-ansible/tree/3.4-unofficialcooking/roles/redmine-plugins/tasks/main.yml

admin初期パスワードの変更

Redmineインストール直後のadmin初期パスワードは admin で固定されており、インストール直後に乗っ取られる可能性を否定できません。(特にインターネット上VPS等を利用する場合)

そのため、情報セキュリテイ対策として、admin初期パスワードを変更しました。初期パスワードは必要に応じ変更ください。

admin初期パスワード unofficial-cracking

Redmicaへの対応

本プレイブックは、Redmine及び、派生版のRedmicaに対応します。

Redmica https://dev.redmica.net/projects/redmica

https://github.com/redmica/redmica

Redmica利用時の注意

Redmica標準のデータベース名はredmica ですが、本インストールでは、Redmine標準のredmine になります。

Redmicaでは、インストール時に作成されるadmin の名前が、Redmine admin から Jane admin に変更されています、(config/database.yml参照)


AWS上での追加設定

AWS(EC2/Lightsail)上で利用する場合は、本Playbookの実行前に下記操作を行ってください。

スーパーユーザに移行しておく(rootにパスワードが設定無いため)

下記実行(またはパスワード設定)

$ sudo su -

firewalldをインストールする

# yum install -y firewalld

swap領域を作成する(メモリ1GB以下の場合)

passengerのビルド中、メモリ不足でインストール失敗する場合があるため、swap領域を追加する。 https://mseeeen.msen.jp/redmine-amazon-linux-ansible/

dd if=/dev/zero of=/swap bs=1M count=1024
chmod 600 /swap
mkswap /swap
swapon /swap

Redmine_knowledgebase Plugin利用時の注意点

本Playbookでは、Redmine_Tags Pluginを初期導入しています。

Redmine_Tags Pluginは、Redmine_knowledgebase Pluginと同居できませんので、下記手順で対応してください。 https://github.com/alexbevi/redmine_knowledgebase/issues/320

Redmine_knowledgebase Plugin以外の、'redmine_acts_as_taggable_on'を使用しているPluginも、同様に対応する必要があります。 http://www.redmine.org/issues/1448#note-124

Redmine_knowledgebase Pluginのインストール前に、Redmine_Tags Pluginをアンインストールする。

rake redmine:plugins:migrate NAME=redmine_tags VERSION=0 FORCE_REDMINE_TAGS_TABLES_REMOVAL=yes

本PlayBook実行前に、Redmine_Tagsをインストール対象から外す。

roles/redmine-plugins/tasks/main.yml から、Redmine_Tagsの行を削除する。


Redmineのインストール手順

インストール直後の CentOS 7 に root でログインし以下の操作を行ってください。

パッケージの更新

yum -y update

Ansibleとgitのインストール

yum install -y epel-release
yum install -y ansible git

playbookのダウンロード(3.4-unofficialcookingブランチ)

git clone -b 3.4-unofficialcooking https://github.com/y503unavailable/redmine-centos-ansible.git

初期設定を変更する場合は、この時点で行ってください。

playbook実行

下記コマンドを実行してください。Redmineの自動インストールが開始されます。

systemctl enable firewalld
systemctl start  firewalld
systemctl stop iptables
systemctl disable iptables
cd redmine-centos-ansible
ansible-playbook -i hosts site.yml

10〜20分ほどでインストールが完了します。

webブラウザで http://サーバIPアドレス/redmine にアクセスしてください。Redmineの画面が表示されるはずです。

初期パスワードは admin/ unofficial-cracking です。(標準から変更)


初期設定の変更

Redmine admin 初期パスワードの変更

admin初期パスワードを変更する場合は、下記箇所を変更してから実行ください。

group_vars/redmine-servers

redmine_admin_passwd: unofficial-cracking

Redmine 初期テーマの変更

初期設定されるテーマを変更する場合は、下記箇所を変更してから実行ください。

インストールされるテーマの一覧は、Redmineインストール下の/public/themes/を参照ください。

group_vars/redmine-servers

redmine_default_theme: redmine_flat

Redmineオリジナル/Redmicaで利用したい場合

下記箇所を変更してから実行ください。(2018/3現在)

group_vars/redmine-servers

Redmine-本家gitミラー

redmine_git_url: https://github.com/redmine/redmine.git
redmine_git_branch: 3.4-stable

Redmica-本家

redmine_git_url: https://github.com/redmica/redmica.git
redmine_git_branch: 3.4-stable

Redmica-UnofficialCookingフォーク

redmine_git_url: https://github.com/y503unavailable/redmica.git

redmine_git_branch: 3.4-stable
または
redmine_git_branch: 3.4-unofficialcooking

mariadbに設定するパスワードの変更

ダウンロードしたプレイブック内のファイル group_vars/redmine-servers をエディタで開き、 db_passwd_redmine と、db_passwd_root を適切な内容に変更してください。これはmariadbのRedmine用ユーザー redmine に設定されるパスワードです。


Dockerを使用したPlaybookの実行

Docker最新版のインストール

CentOSの場合、下記手順でdockerの最新版をインストールし、起動してください、(Docker CE 17以降)

CentOSのパッケージから導入すると、旧バージョンがインストールされ、正常に動作しない場合があります。

curl -sSL https://get.docker.com/ | sh

systemctl enable docker
systemctl start  docker

Dockerコンテナのビルド

下記のコマンドでPlaybookを実行できるDockerコンテナのビルドができます。

$ git clone https://github.com/y503unavailable/redmine-centos-ansible.git
$ cd redmine-centos-ansible
$ docker build -t redmine-centos-ansible docker

Dockerコンテナの起動とPlaybook実行

下記のコマンドでビルドしたDockerコンテナでPlaybookを実行できます。

$ docker run --privileged --name redmine-centos-ansible -d -p 8080:80 redmine-centos-ansible /sbin/init
$ docker exec -ti redmine-centos-ansible /bin/bash

以下はDockerコンテナ内操作

# cd /tmp
# git clone https://github.com/y503unavailable/redmine-centos-ansible.git
# cd redmine-centos-ansible
# ansible-playbook -i hosts site.yml

Webブラウザで http://サーバIPアドレス:8080/redmine にアクセスしてください。Redmineの画面が表示されるはずです。


ライセンス

MIT License

作者

y503unavailable (Redmine.Tokyoスタッフ)

連絡先   Redmine マストドン 、  Twitter y503unavailable

Redmine.tokyo unofficial cooking

Docker対応は Tatsuya Saito twopackas@gmail.com さんによります。

本プレイブックについて

原作 ファーエンドテクノロジー株式会社 https://github.com/farend/redmine-centos-ansible

Fork元 https://github.com/ssaito/redmine-centos-ansible