Sign inSign up

toolkitbox/databases

By toolkitbox

Updated 23 days ago

DevOps toolkit - databases bundle

Image
0

1.8K

toolkitbox/databases repository overview

Databases Bundle

GitHub Stars GitHub Issues Docker Pulls

📢 Found an issue or want to request a new tool? Open an issue on GitHub

All-in-one bundle with database client tools for PostgreSQL, MySQL, MariaDB, MongoDB, Redis, and SQLite.

Quick Start

Docker
# Interactive mode with shell access
docker run -it --rm \
  ghcr.io/pabpereza/toolkitbox/databases:latest \
  sh

# Connect to PostgreSQL
docker run -it --rm \
  -e PGPASSWORD=my_password \
  ghcr.io/pabpereza/toolkitbox/databases:latest \
  psql -h my-server.com -U postgres -d my_database

# Connect to MySQL
docker run -it --rm \
  ghcr.io/pabpereza/toolkitbox/databases:latest \
  mysql -h my-server.com -u root -p

# Connect to Redis
docker run -it --rm \
  ghcr.io/pabpereza/toolkitbox/databases:latest \
  redis-cli -h my-server.com

# Connect to MongoDB
docker run -it --rm \
  ghcr.io/pabpereza/toolkitbox/databases:latest \
  mongosh "mongodb://my-server.com:27017"
Kubernetes
apiVersion: v1
kind: Pod
metadata:
  name: databases-client
spec:
  containers:
  - name: databases-client
    image: ghcr.io/pabpereza/toolkitbox/databases:latest
    command: ["sleep", "infinity"]
    env:
    # PostgreSQL
    - name: PGHOST
      value: "postgres-service"
    - name: PGUSER
      value: "postgres"
    - name: PGPASSWORD
      valueFrom:
        secretKeyRef:
          name: postgres-credentials
          key: password
    # MySQL
    - name: MYSQL_HOST
      value: "mysql-service"
    - name: MYSQL_PWD
      valueFrom:
        secretKeyRef:
          name: mysql-credentials
          key: password
    # Redis
    - name: REDISCLI_AUTH
      valueFrom:
        secretKeyRef:
          name: redis-credentials
          key: password

Description

The Databases Bundle is a comprehensive Docker image containing command-line clients for the most popular databases. This bundle is ideal for:

  • Database administrators who need to connect to multiple database types
  • DevOps engineers troubleshooting database connectivity in Kubernetes
  • Developers running database migrations or queries from CI/CD pipelines

Included Components

ComponentToolDescription
postgrespsql, pg_dump, pg_restorePostgreSQL client and utilities
mysqlmysql, mysqldumpMySQL client and utilities
mariadbmariadb, mariadb-dumpMariaDB client and utilities
mongomongoshMongoDB Shell
redisredis-cliRedis command line interface
sqlitesqlite3SQLite command line interface

Basic Usage

PostgreSQL
# Connect to database
psql -h hostname -U user -d database

# Execute query
psql -h hostname -U user -d database -c "SELECT version();"

# Backup database
pg_dump -h hostname -U user database > backup.sql
MySQL
# Connect to database
mysql -h hostname -u user -p

# Execute query
mysql -h hostname -u user -p -e "SHOW DATABASES;"

# Backup database
mysqldump -h hostname -u user -p database > backup.sql
MariaDB
# Connect to database
mariadb -h hostname -u user -p

# Execute query
mariadb -h hostname -u user -p -e "SHOW DATABASES;"
MongoDB
# Connect to server
mongosh "mongodb://hostname:27017"

# Connect with authentication
mongosh "mongodb://user:password@hostname:27017/database"

# Execute command
mongosh "mongodb://hostname:27017" --eval "db.stats()"
Redis
# Connect to server
redis-cli -h hostname -p 6379

# Connect with authentication
redis-cli -h hostname -a password

# Execute command
redis-cli -h hostname PING
SQLite
# Open or create database
sqlite3 mydatabase.db

# Execute query
sqlite3 mydatabase.db "SELECT * FROM users;"

# Use in-memory database
sqlite3 :memory:

Environment Variables

PostgreSQL
VariableDescription
PGHOSTServer host
PGPORTServer port (default: 5432)
PGUSERConnection user
PGPASSWORDPassword
PGDATABASEDefault database
MySQL/MariaDB
VariableDescription
MYSQL_HOSTServer host
MYSQL_TCP_PORTServer port (default: 3306)
MYSQL_PWDPassword (not recommended in production)
Redis
VariableDescription
REDISCLI_AUTHAuthentication password

Official Documentation

Tag summary

Content type

Image

Digest

sha256:260450b14

Size

68.3 MB

Last updated

23 days ago

docker pull toolkitbox/databases