はじめに
docker compose だけでサクッと SchemaSpy を使うと、いろいろ動かないので、解決策を書く。
次を前提にする。
- docker-compose.yaml にサービスを定義
- SchemaSpy 6.1.0
- MySQL 8
- Apple M1 Mac (arm64)
解決策
後述の docker-compose.yaml で動いた。
Docker イメージに JDK を使います。Amazon Corretto を使ってますが、ほかの JDK でも動きます。バージョンは 14 以下である必要があります。
schemaspy-[version].jar は公式 http://schemaspy.org などからダウンロードして ./schemaspy/ に置きます。
ドライバを次からダウンロードして、./schemaspy/drivers/ に置きます。
https://dev.mysql.com/downloads/connector/j/
Select Operating System: "Platform Independent" を選び、"ZIP Archive" を選び、"No thanks, just start my download." を選ぶ。
schemaspy:
image: amazoncorretto:8
volumes:
- ./schemaspy:/app
command: >
java -jar /app/schemaspy-6.1.0.jar
-db hoge_db
-t mysql
-host hoge_host -port 3306 -s hoge_schema -u hoge_user -p hoge_password
-dp /app/drivers/
-o /app/outputs/
-vizjs
実行が終わると ./schemaspy/outputs に HTML などが出力されます。
失敗１：Docker イメージ schemaspy/schemaspy が終わらない
help でも終わらない。トラブルシューティングしづらい。
$ docker run schemaspy/schemaspy:6.1.0 --help
WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested
Running Main-Class org.springframework.boot.loader.JarLauncher
With drivers:jtds-1.3.1.jar, mariadb-java-client-1.1.10.jar
mysql-connector-java-6.0.6.jar, postgresql-42.1.1.jre7.jar
SchemaSpy は jar ファイルで動くので JDK 上で動かして、次に進めた。
SchemaSpy is just a single executable jar-file (schemaspy-[version].jar)
https://schemaspy.readthedocs.io/en/latest/installation.html#schemaspy
失敗２：いろいろ必要になる
ドライバ
jar ファイルのほかにドライバが必要、デフォルトで探すドライバが古いので、新しいドライバを置いて、SchemaSpy のオプション -dp で置いた場所を読ませる。
Failed to connect to database URL [jdbc:mysql://hoge_host:3306/hoge_schema] Failed to create any of 'com.mysql.cj.jdbc.Driver, com.mysql.jdbc.Driver' driver from driverPath '/mysql/mysql-connector-java-5.1.6-bin.jar' with sibling jars no.
Resulting in classpath: empty
There were missing paths in driverPath:
/mysql/mysql-connector-java-5.1.6-bin.jar
Use commandline option '-dp' to specify driver location.
If you need to load sibling jars used '-loadjars'
INFO - StackTraces have been omitted, use `-debug` when executing SchemaSpy to see them
ERROR: 3
Graphviz
jar ファイルのほかに Graphviz が必要。
WARN - Failed to query Graphviz version using 'dot -V'
Cannot run program "dot": error=2, No such file or directory
INFO - Graphviz rendered set to ''
..ERROR - RelationShipDiagramError
Failed to produce diagram for: /app/outputs/diagrams/summary/relationships.implied.compact.dot
（中略）
Exception in thread "main" java.lang.reflect.InvocationTargetException
（中略）
Caused by: org.schemaspy.output.diagram.DiagramException: Failed to generate Table diagram
（中略）
Caused by: org.schemaspy.output.diagram.DiagramException: Dot missing or invalid version
（中略）
ERROR: 1
幸い SchemaSpy 6.1.0 から内蔵されたので、オプション -vizjs を指定する
Since version 6.1.0 Graphviz is no longer required. There is an embedded viz.js that can be used by adding command line argument
vizjs
https://schemaspy.readthedocs.io/en/latest/installation.html#optional
失敗３：JDK が新しいと出力に失敗する
Exception in thread "main" java.lang.reflect.InvocationTargetException
（中略）
Caused by: java.lang.IllegalArgumentException: viz.js
（中略）
Caused by: java.lang.NullPointerException: Cannot invoke "javax.script.ScriptEngine.eval(String)" because "this.scriptEngine" is null
（中略）
ERROR: 1
Nashorn (javascript engine) was removed in Java 15, see https://openjdk.java.net/jeps/372
https://github.com/schemaspy/schemaspy/issues/753
公式はバージョン 8 を明示しているので、8 を使う。
https://schemaspy.readthedocs.io/en/latest/installation.html#java-8
おわりに
docker compose だけで SchemaSpy を動かした。
思ったよりサクッと動かない。代替を考えたほうがよいのだろうか。