docker-adminer

If you are beginning your journey with Senzing, please start with Senzing Quick Start guides.

You are in the Senzing Garage where projects are "tinkered" on. Although this GitHub repository may help you understand an approach to using Senzing, it's not considered to be "production ready" and is not considered to be part of the Senzing product. Heck, it may not even be appropriate for your application of Senzing!

Overview

A docker wrapper over Adminer.

The docker image is based on hub.docker.com/_/adminer and has added support for MSSQL.

Legend

🤔 - A "thinker" icon means that a little extra thinking may be required. Perhaps you'll need to make some choices. Perhaps it's an optional step.
✏️ - A "pencil" icon means that the instructions may need modification before performing.
⚠️ - A "warning" icon means that something tricky is happening, so pay attention.

Expectations

Space

This repository and demonstration require 6 GB free disk space.

Time

Budget 40 minutes to get the demonstration up-and-running, depending on CPU and network speeds.

Background knowledge

This repository assumes a working knowledge of:

Docker

Demonstrate using Docker

Configuration

Configuration values specified by environment variable or command line parameter.

ADMINER_DEFAULT_SERVER

Default database

🤔 Optional: Use to specify a particular database hostname.

✏️ Specify docker network. Example:

export ADMINER_DEFAULT_SERVER=*hostname-or-ip-address*

Construct parameter for docker run. Example:

export ADMINER_DEFAULT_SERVER_PARAMETER="--env ADMINER_DEFAULT_SERVER=${ADMINER_DEFAULT_SERVER}"

Docker network

🤔 Optional: Use if docker container is part of a docker network.

List docker networks. Example:
```
sudo docker network ls
```
✏️ Specify docker network. Choose value from NAME column of docker network ls. Example:
```
export SENZING_NETWORK=*nameofthe_network*
```

Construct parameter for docker run. Example:

export SENZING_NETWORK_PARAMETER="--net ${SENZING_NETWORK}"

Run docker container

Run docker container. Example:

sudo docker run \
  --interactive \
  --rm \
  --tty \
  ${ADMINER_DEFAULT_SERVER_PARAMETER} \
  ${SENZING_NETWORK_PARAMETER} \
  senzing/adminer

Develop

Prerequisite software

The following software programs need to be installed:

Clone repository

For more information on environment variables, see Environment Variables.

Set these environment variable values:

export GIT_ACCOUNT=senzing
export GIT_REPOSITORY=docker-adminer
export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"

Follow steps in clone-repository to install the Git repository.

Build docker image for development

Option #1: Using docker command and GitHub.

sudo docker build --tag senzing/adminer https://github.com/senzing-garage/docker-adminer.git#main

Option #2: Using docker command and local repository.

cd ${GIT_REPOSITORY_DIR}
sudo docker build --tag senzing/adminer .

Option #3: Using make command.
```
cd ${GIT_REPOSITORY_DIR}
sudo make docker-build
```
Note: sudo make docker-build-development-cache can be used to create cached docker layers.

senzing-garage/docker-adminer