qrunnerの実行の起点は.drone.ymlになるため、qrunnerを正しく動作させるためには.drone.ymlを正しく書く必要がある。
サンプルはここに置いている。
主な設定ポイントは以下
- localhostへのテスト用にMySQLのコンテナを
MYSQL_ALLOW_EMPTY_PASSWORD=yesで上げる - masterブランチの時のみ
EXEC_MODE=remoteとする（リモートサーバにクエリを実行するのはmasterマージのときだけにする） - remote実行の際は、
MYSQL_USERとMYSQL_PASSWORDを.drone.secから受け取るようにする
qrunnerの動作を制御する環境変数は.drone.ymlで設定が可能である。
以下、設定可能な環境変数を示す。
| 変数名 | 値 | 説明 |
|---|---|---|
EXEC_MODE |
local or remote[Default: local] |
実行モード。localの場合はlocalhost上に起動したMySQLに対してクエリのテストを行う |
QUERIES_DIR |
queries |
QUERIES_DIRは実行するクエリを置くためのディレクトリ |
MYSQL_USER |
MySQLのユーザ名[Default: root] |
- |
MYSQL_PASSWORD |
MySQLのパスワード[Default: ""] |
.drone.secから取得するようにした方が良い |
SCHEMA_DIR |
ディレクトリ名[Default: schema] |
localhostにクエリの実行テストを行う際に用いるDBスキーマを格納するディレクトリ |
SERVERS_INFO |
toml形式のファイル名[Default: servers.toml] |
クエリを実行するDBサーバの情報を格納するファイル |
GATEWAY_LOCAL_PORT |
ポート番号[Default: 3307] |
ssh_gatewayを使う際のローカルポートとして利用される |
SERVERS_INFOで指定したファイル（指定していない場合はservers.toml）に、接続するDBサーバ群のホスト名やポート番号の情報をまとめておく必要がある。
サンプルはここに置いている。
書き方は以下の通りである。
[サービス名]
[サービス名.DBホストを一意に表すキー]
host_name = "<ホスト名 or IPアドレス>"
port = <ポート番号>
ssh_gateway = "<SSHユーザ名>@<SSHホスト名>"
「DBホストを一意に表すキー」は後述するDBスキーマやクエリの配置するディレクトリ名に対応するため重要。
portは指定しない場合は3306が用いられる。
SSH Gateway経由で接続したい場合は、ssh_gatewayを指定する。
以下のディレクトリパス配下に、実行するDBのスキーマファイルを置いておかなければならない。
SCHEMA_DIR(デフォルト:schema)/サービス名/DBホストを一意に表すキー
配置したスキーマファイルは、localhostへのテスト時（EXEC_MODE=local）のDBのセットアップに用いられる。
※ 配置するスキーマのファイル名はDB名と同一にする
- 1PRにつき1SQLファイルとする。（同一サーバへの複数クエリ実行したい場合は1SQLファイルに書
追加するSQLファイルは以下の命名規則に従い配置する。
QUERIES_DIR(デフォルト:queries)/サービス名/DBホストを一意に表すキー/日付_任意の文字列（テーブル名など）.sql
ファイル名は実行には関係なく、ユニークな名前を付ければ良いため、日時などを用いると良い。