Redmineのデータベースの日次バックアップ。(MySQL)
バージョン 2 (手動人形, 2023/02/08 17:09) → バージョン 3/6 (手動人形, 2023/02/08 21:29)
## 概要
Redmineのメンテナンスの中で、「データベースのバックアップ」は非常に重要なものです。
そこで、改めて、シェルスクリプトとCronによるバックアップ手順を整理しました。
## 動作を確認した環境
- Ubuntu 20.04 LTS
- Redmine 4.2
- MySQL 8.0.32
### 実施前提
- MySQLに管理者権限でログインできること。
- Redmine用のDBとDBユーザ、DBパスワードを把握していること。
- また、DBサーバはローカルホストです。
## 確認した手順
- Redmineが稼働しているUbuntuサーバのターミナル上での操作です。
- MySQL以外は全て一般権限で実行します。
### さっくりとした手順
1. Redmineのデータベースユーザに権限を付与します。
1. バックアップディレクトリを作成します。
1. アカウントファイルを作成します。
1. バックアップスクリプトを作成します。
1. crontabに登録します。
### データベース設定
#### 管理者権限でMySQLにログインします。
```bash
mysql -u root -p
```
#### データベースのユーザ権限を変更します。
これを行わないとDump処理ができませんでした。
```mysql
GRANT RELOAD ON *.* TO '【RedmineのDBユーザ】'@'localhost';
FLUSH PRIVILEGES;
EXIT
```
### ディレクトリとスクリプト作成
#### バックアップディレクトリ作成
```bash
mkdir -p /home/backup/mysql
# 運用に合わせて指定ください。ファイルサーバや別パーティションにマウントしている方がサーバ事態の障害発生でも冗長化を持たせられます。 運用に合わせて指定ください
cd /home/backup/mysql && pwd
# 指定したディレクトリに移動します
```
#### アカウントファイル作成
※このファイルを作成しないと、「安全ではない」とエラーが出ます。
以下の内容を教義・信仰に沿ったエディタで作成します。(【】内は取り除き、自分の設定に合わせます) 以下の内容を教義・信仰に沿ったエディタで作成します。
- アカウントファイル内容
- ファイル名:account.txt
```
[client]
user = 【RedmineのDBユーザ】
password = "【RedmineのDBユーザ用パスワード】" 【"RedmineのDBユーザ用パスワード"】
```
#### アカウントファイルでアクセスできることを確認
```
mysql --defaults-extra-file=account.txt
```
MySQLのプロンプトが出れば成功です。exitで抜けます。
#### スクリプト作成
以下の内容を教義・信仰に沿ったエディタで作成します。
- スクリプト内容
- スクリプト名:mysql_daily_backup.sh
```bash
#!/bin/bash
# スクリプトの実行日時を指定します
date=$(date +"%Y%m%d")
# バックアップディレクトリを定義します
# 上記手順で示したディレクトリを指定してください
backup_dir="/home/backup/mysql"
# アカウントファイルを指定します
credentials_file="$backup_dir/account.txt"
# バックアップ時に指定するオプションを定義します
options="--defaults-extra-file=$credentials_file --no-tablespaces --single-transaction"
# バックアップファイル名を定義します
backup_file="$backup_dir/redmine.sql.$date.gz"
# バックアップを実行し、.gz形式でバックアップをします
mysqldump $options -h localhost redmine | gzip > $backup_file
# 10世代前の圧縮ファイルを削除します(運用に合わせて指定ください)
find $backup_dir -type f -name "redmine.sql.*.gz" -mtime +10 -delete
```
- 実行権限の付与
```bash
chmod +x mysql_daily_backup.sh
```
#### 動作確認
```bash
sh mysql_daily_backup.sh
```
以下を確認します。
- エラーなく実行できること
- redmine.sql.実行日付.gz形式でファイルが作成されること
- gunzip redmine.sql.実行日付.gzでファイルが解凍できること
### Crontab設定
#### Cron登録
```bash
crontab -e
```
#### 登録内容例
```
0 0 * * * /home/backup/mysql/mysql_daily_backup.sh
# 実行時刻、頻度などは自分の運用形態に合わせます。
```
#### Cron登録確認
```bash
sudo tail -20 /var/log/cron.log
```
操作時刻に
- BEGIN EDIT
- REPLACE
- END EDIT
が表示されれば設定は完了です。
### 動作確認日
2023/02/08
Redmineのメンテナンスの中で、「データベースのバックアップ」は非常に重要なものです。
そこで、改めて、シェルスクリプトとCronによるバックアップ手順を整理しました。
## 動作を確認した環境
- Ubuntu 20.04 LTS
- Redmine 4.2
- MySQL 8.0.32
### 実施前提
- MySQLに管理者権限でログインできること。
- Redmine用のDBとDBユーザ、DBパスワードを把握していること。
- また、DBサーバはローカルホストです。
## 確認した手順
- Redmineが稼働しているUbuntuサーバのターミナル上での操作です。
- MySQL以外は全て一般権限で実行します。
### さっくりとした手順
1. Redmineのデータベースユーザに権限を付与します。
1. バックアップディレクトリを作成します。
1. アカウントファイルを作成します。
1. バックアップスクリプトを作成します。
1. crontabに登録します。
### データベース設定
#### 管理者権限でMySQLにログインします。
```bash
mysql -u root -p
```
#### データベースのユーザ権限を変更します。
これを行わないとDump処理ができませんでした。
```mysql
GRANT RELOAD ON *.* TO '【RedmineのDBユーザ】'@'localhost';
FLUSH PRIVILEGES;
EXIT
```
### ディレクトリとスクリプト作成
#### バックアップディレクトリ作成
```bash
mkdir -p /home/backup/mysql
# 運用に合わせて指定ください。ファイルサーバや別パーティションにマウントしている方がサーバ事態の障害発生でも冗長化を持たせられます。 運用に合わせて指定ください
cd /home/backup/mysql && pwd
# 指定したディレクトリに移動します
```
#### アカウントファイル作成
※このファイルを作成しないと、「安全ではない」とエラーが出ます。
以下の内容を教義・信仰に沿ったエディタで作成します。(【】内は取り除き、自分の設定に合わせます) 以下の内容を教義・信仰に沿ったエディタで作成します。
- アカウントファイル内容
- ファイル名:account.txt
```
[client]
user = 【RedmineのDBユーザ】
password = "【RedmineのDBユーザ用パスワード】" 【"RedmineのDBユーザ用パスワード"】
```
#### アカウントファイルでアクセスできることを確認
```
mysql --defaults-extra-file=account.txt
```
MySQLのプロンプトが出れば成功です。exitで抜けます。
#### スクリプト作成
以下の内容を教義・信仰に沿ったエディタで作成します。
- スクリプト内容
- スクリプト名:mysql_daily_backup.sh
```bash
#!/bin/bash
# スクリプトの実行日時を指定します
date=$(date +"%Y%m%d")
# バックアップディレクトリを定義します
# 上記手順で示したディレクトリを指定してください
backup_dir="/home/backup/mysql"
# アカウントファイルを指定します
credentials_file="$backup_dir/account.txt"
# バックアップ時に指定するオプションを定義します
options="--defaults-extra-file=$credentials_file --no-tablespaces --single-transaction"
# バックアップファイル名を定義します
backup_file="$backup_dir/redmine.sql.$date.gz"
# バックアップを実行し、.gz形式でバックアップをします
mysqldump $options -h localhost redmine | gzip > $backup_file
# 10世代前の圧縮ファイルを削除します(運用に合わせて指定ください)
find $backup_dir -type f -name "redmine.sql.*.gz" -mtime +10 -delete
```
- 実行権限の付与
```bash
chmod +x mysql_daily_backup.sh
```
#### 動作確認
```bash
sh mysql_daily_backup.sh
```
以下を確認します。
- エラーなく実行できること
- redmine.sql.実行日付.gz形式でファイルが作成されること
- gunzip redmine.sql.実行日付.gzでファイルが解凍できること
### Crontab設定
#### Cron登録
```bash
crontab -e
```
#### 登録内容例
```
0 0 * * * /home/backup/mysql/mysql_daily_backup.sh
# 実行時刻、頻度などは自分の運用形態に合わせます。
```
#### Cron登録確認
```bash
sudo tail -20 /var/log/cron.log
```
操作時刻に
- BEGIN EDIT
- REPLACE
- END EDIT
が表示されれば設定は完了です。
### 動作確認日
2023/02/08