woodpecker/doc/setup/mysql.md
Brad Rydzewski 091b213300 fixes #917
2015-08-24 14:10:30 -07:00

1.4 KiB

NOTE the mysql driver is disable until driver issue #257 is resolved

MySQL

Drone comes with support for MySQL as an alternate database engine. To enable MySQL, you should specify the following environment variables:

DATABASE_DRIVER="mysql"
DATABASE_CONFIG="root:pa55word@tcp(localhost:3306)/drone"

MySQL configuration

The following is the standard URI connection scheme:

[username[:password]@][protocol[(address)]]/dbname[?options]

The components of this string are:

  • username optional. Use this username when connecting to the MySQL instance.
  • password optional. Use this password when connecting to the MySQL instance.
  • protocol server protocol to connect with.
  • address server address to connect to.
  • dbname name of the database to connect to
  • ?options connection specific options

This is an example connection string:

root:pa55word@tcp(localhost:3306)/drone

MySQL options

See the official driver documentation for a full list of driver options.

MySQL Database

Drone does not automatically create the database. You should use the command line utility or your preferred management console to create the database:

mysql -P 3306 --protocol=tcp -u root -e 'create database if not exists drone;'