Setup API Server
The API Server is the main run-time for VinylDNS. To setup the API server, follow these steps:
Using the API Docker Image
The API server is provided via the VinylDNS API Image. The docker image allows you to mount your own config, as well as your own external dependency jars.
The API server is stateless, allowing you to run multiple instances in multiple data centers for high-availability purposes.
Note: If using VinylDNS Java Crypto and the pre-requisites defined here, no additional jars need to be loaded.
MYSQL_ADDRESS- the IP address of the mysql server; defaults to
vinyldns-mysqlassuming a docker compose setup
MYSQL_PORT- the port of the mysql server; defaults to 3306
The API exposes volumes that allow the user to customize the runtime. Those mounts include:
/opt/vinyldns/lib_extra- place here additional jar files that need to be loaded into the classpath when the application starts up. This is used for “plugins” that are proprietary or not part of the standard build. All jar files here will be placed on the class path.
/opt/vinyldns/conf- place an
application.conffile here with your own custom settings. Once you have your config created, place here.
The API only exposes port 9000 for HTTP access to all endpoints