History

Alvin Moore 901150f984 Added support for allowing packages to be greater than current		2019-04-26 15:18:05 -07:00
..
samples/python	Moves the create_server_environment logic in the dockerfile into a sourceable function.	2018-11-27 09:12:04 -08:00
website	Added website directory to docker packaging in order to allow the building of runtime docker images	2019-01-11 19:54:36 -08:00
Dockerfile	Added support for allowing packages to be greater than current	2019-04-26 15:18:05 -07:00
README.md	Ensures that we set the cluster file contents in a consistent way in the docker image for the two different networking options.	2018-11-25 16:47:25 -08:00
create_cluster_file.bash	Moves the create_server_environment logic in the dockerfile into a sourceable function.	2018-11-27 09:12:04 -08:00
create_server_environment.bash	Moves the create_server_environment logic in the dockerfile into a sourceable function.	2018-11-27 09:12:04 -08:00
download_multiversion_libraries.bash	Switch from wget to curl in order to support the download scheme of file://.	2019-01-09 08:19:39 -08:00
fdb.bash	Moves the create_server_environment logic in the dockerfile into a sourceable function.	2018-11-27 09:12:04 -08:00

README.md

Overview

This directory provides a Docker image for running FoundationDB.

The image in this directory is based on Ubuntu 18.04, but the commands and scripts used to build it should be suitable for most other distros with small tweaks to the installation of dependencies.

The image relies on the following dependencies:

bash
wget
dig
glibc

Build Configuration

This image supports several build arguments for build-time configuration.

FDB_VERSION

The version of FoundationDB to install in the container. This is required.

FDB_WEBSITE

The base URL for the FoundationDB website. The default is https://www.foundationdb.org.

FDB_ADDITIONAL_VERSIONS

A list of additional client library versions to include in this image. These libraries will be in a special multiversion library folder.

Runtime Configuration

This image supports several environment variables for run-time configuration.

FDB_PORT

The port that FoundationDB should bind to. The default is 4500.

FDB_NETWORKING_MODE

A networking mode that controls what address FoundationDB listens on. If this is container (the default), then the server will listen on its public IP within the docker network, and will only be accessible from other containers.

If this is host, then the server will listen on 127.0.0.1, and will not be accessible from other containers. You should use host networking mode if you want to access your container from your host machine, and you should also map the port to the same port on your host machine when you run the container.

FDB_COORDINATOR

A name of another FDB instance to use as a coordinator process. This can be helpful when setting up a larger cluster inside a docker network, for instance when using Docker Compose. The name you provide must be resolvable through the DNS on the container you are running.

Copying Into Other Images

You can also use this image to provide files for images that are clients of a FoundationDB cluster, by using the from argument of the COPY command. Some files you may want to copy are:

/usr/lib/libfdb_c.so: The primary FoundationDB client library
/usr/lib/fdb/multiversion/libfdb_*.so: Additional versions of the client library, which you can use if you are setting up a multiversion client.
/var/fdb/scripts/create_cluster_file.bash: A script for setting up the cluster file based on an FDB_COORDINATOR environment variable.
/usr/bin/fdbcli: The FoundationDB CLI.