mirror of
https://github.com/shadoll/just-commons.git
synced 2025-12-20 03:26:43 +00:00
sHa
d3fec4b85a
BREAKING CHANGES: - Complete restructure to Just module architecture (requires Just 1.31.0+) - Command syntax changed: 'just postgres-sql' → 'just postgres sql' - Import syntax changed: import → mod declarations NEW FEATURES: ✨ Module-based architecture with optional modules ✨ Built-in Just colors ({{RED}}, {{GREEN}}, etc.) replace custom variables ✨ Enhanced [confirm] attributes for all destructive operations ✨ Organized [group('name')] attributes for better UX ✨ Modern justfile with comprehensive help system ✨ Updated documentation with migration guide MODULES: 📦 postgres/ - PostgreSQL operations (sql, check, create-database, etc.) 📦 mysql/ - MySQL operations (sql, check, create-user, etc.) 📦 volumes/ - Volume management (clean-all, remove, list) 📦 container/ - Container operations (start, stop, logs, shell, exec) 📦 registry/ - Registry auth (login, logout, check) 📦 images/ - Image operations (build, push, pull, tag, clean) USAGE: just postgres sql "SELECT version();" just volumes clean-all just images build myapp This is Just Commons v2.0 - a complete modernization using all of Just's latest features.
265 lines
7.9 KiB
Plaintext
265 lines
7.9 KiB
Plaintext
# Universal PostgreSQL database operations
|
|
|
|
# Execute PostgreSQL SQL query
|
|
[group('database')]
|
|
sql query service="postgres" compose-file="":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
query="{{query}}"
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
|
|
if [ -z "$query" ]; then
|
|
echo "{{BOLD}}{{RED}}Error:{{NORMAL}} SQL query is required" >&2
|
|
echo "{{YELLOW}}Usage:{{NORMAL}} just postgres sql \"SELECT version();\"" >&2
|
|
exit 1
|
|
fi
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
echo -e "{{BLUE}}Executing PostgreSQL query in service: $service{{NORMAL}}"
|
|
echo -e "{{YELLOW}}Query: $query{{NORMAL}}"
|
|
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "psql -U postgres -c \"$query\"" "$file_arg"
|
|
else
|
|
just exec "$service" "psql -U postgres -c \"$query\""
|
|
fi
|
|
|
|
# Check PostgreSQL connection and status
|
|
[group('database')]
|
|
check service="postgres" compose-file="":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
echo -e "{{BLUE}}Checking PostgreSQL status in service: $service{{NORMAL}}"
|
|
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "pg_isready -U postgres" "$file_arg"
|
|
just exec "$service" "psql -U postgres -c 'SELECT version();'" "$file_arg"
|
|
else
|
|
just exec "$service" "pg_isready -U postgres"
|
|
just exec "$service" "psql -U postgres -c 'SELECT version();'"
|
|
fi
|
|
|
|
# List PostgreSQL databases
|
|
[group('database')]
|
|
list-databases service="postgres" compose-file="":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
echo -e "{{BLUE}}Listing PostgreSQL databases in service: $service{{NORMAL}}"
|
|
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "psql -U postgres -c '\\l'" "$file_arg"
|
|
else
|
|
just exec "$service" "psql -U postgres -c '\\l'"
|
|
fi
|
|
|
|
# List PostgreSQL users
|
|
[group('database')]
|
|
list-users service="postgres" compose-file="":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
echo -e "{{BLUE}}Listing PostgreSQL users in service: $service{{NORMAL}}"
|
|
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "psql -U postgres -c '\\du'" "$file_arg"
|
|
else
|
|
just exec "$service" "psql -U postgres -c '\\du'"
|
|
fi
|
|
|
|
# Create PostgreSQL database
|
|
[group('database')]
|
|
create-database database service="postgres" compose-file="":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
database="{{database}}"
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
|
|
if [ -z "$database" ]; then
|
|
echo "{{BOLD}}{{RED}}Error:{{NORMAL}} Database name is required" >&2
|
|
echo "{{YELLOW}}Usage:{{NORMAL}} just postgres create-database mydb" >&2
|
|
exit 1
|
|
fi
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
echo -e "{{BLUE}}Creating PostgreSQL database: $database{{NORMAL}}"
|
|
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "createdb -U postgres \"$database\"" "$file_arg"
|
|
else
|
|
just exec "$service" "createdb -U postgres \"$database\""
|
|
fi
|
|
|
|
# Drop PostgreSQL database
|
|
[group('database')]
|
|
[confirm]
|
|
drop-database database service="postgres" compose-file="":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
database="{{database}}"
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
|
|
if [ -z "$database" ]; then
|
|
echo "{{BOLD}}{{RED}}Error:{{NORMAL}} Database name is required" >&2
|
|
echo "{{YELLOW}}Usage:{{NORMAL}} just postgres drop-database mydb" >&2
|
|
exit 1
|
|
fi
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
echo -e "{{YELLOW}}WARNING: This will permanently delete database: $database{{NORMAL}}"
|
|
echo -e "{{BLUE}}Dropping PostgreSQL database: $database{{NORMAL}}"
|
|
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "dropdb -U postgres \"$database\"" "$file_arg"
|
|
else
|
|
just exec "$service" "dropdb -U postgres \"$database\""
|
|
fi
|
|
|
|
# PostgreSQL interactive shell
|
|
[group('database')]
|
|
shell service="postgres" compose-file="":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
echo -e "{{BLUE}}Opening PostgreSQL interactive shell in service: $service{{NORMAL}}"
|
|
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "psql -U postgres" "$file_arg"
|
|
else
|
|
just exec "$service" "psql -U postgres"
|
|
fi
|
|
|
|
# Restore PostgreSQL database from backup file
|
|
[group('database')]
|
|
[confirm]
|
|
restore backup_file service="postgres" compose-file="" backup_path="./backups":
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
backup_file="{{backup_file}}"
|
|
service="{{service}}"
|
|
compose_file="{{compose-file}}"
|
|
backup_path="{{backup_path}}"
|
|
|
|
if [ -z "$backup_file" ]; then
|
|
echo "{{BOLD}}{{RED}}Error:{{NORMAL}} Backup file name is required" >&2
|
|
echo "{{YELLOW}}Usage:{{NORMAL}} just postgres restore backup_file.sql" >&2
|
|
exit 1
|
|
fi
|
|
|
|
# Build compose file argument
|
|
file_arg=""
|
|
if [ -n "$compose_file" ]; then
|
|
file_arg="$compose_file"
|
|
fi
|
|
|
|
# Check if backup file exists
|
|
if [ ! -f "$backup_path/$backup_file" ]; then
|
|
echo -e "{{RED}}Error: Backup file '$backup_path/$backup_file' not found{{NORMAL}}" >&2
|
|
echo -e "{{YELLOW}}Available backups:{{NORMAL}}"
|
|
ls -la "$backup_path/" 2>/dev/null || echo "No backups directory found at $backup_path"
|
|
exit 1
|
|
fi
|
|
|
|
# Display backup file info
|
|
echo -e "{{BLUE}}Backup file information:{{NORMAL}}"
|
|
echo -e "{{YELLOW}}File:{{NORMAL}} $backup_path/$backup_file"
|
|
echo -e "{{YELLOW}}Size:{{NORMAL}} $(du -h "$backup_path/$backup_file" | cut -f1)"
|
|
echo -e "{{YELLOW}}Modified:{{NORMAL}} $(stat -c %y "$backup_path/$backup_file" 2>/dev/null || stat -f %Sm "$backup_path/$backup_file")"
|
|
echo ""
|
|
|
|
# Detect backup type
|
|
if [[ "$backup_file" == *.gz ]]; then
|
|
backup_type="gzipped SQL"
|
|
echo -e "{{BLUE}}Backup type:{{NORMAL}} $backup_type"
|
|
else
|
|
backup_type="plain SQL"
|
|
echo -e "{{BLUE}}Backup type:{{NORMAL}} $backup_type"
|
|
fi
|
|
|
|
echo -e "{{BLUE}}Target service:{{NORMAL}} $service"
|
|
echo ""
|
|
|
|
echo -e "{{RED}}⚠️ WARNING: This will OVERWRITE the current database!{{NORMAL}}"
|
|
echo -e "{{YELLOW}}This action will replace all data in the target database{{NORMAL}}"
|
|
echo -e "{{YELLOW}}Make sure you have a backup of current data if needed{{NORMAL}}"
|
|
echo ""
|
|
|
|
echo -e "{{BLUE}}Restoring database from $backup_file...{{NORMAL}}"
|
|
|
|
# Copy backup file to container and restore
|
|
if [[ "$backup_file" == *.gz ]]; then
|
|
# For gzipped files
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "gunzip -c /backups/$backup_file | psql -U postgres" "$file_arg"
|
|
else
|
|
just exec "$service" "gunzip -c /backups/$backup_file | psql -U postgres"
|
|
fi
|
|
else
|
|
# For plain SQL files
|
|
if [ -n "$file_arg" ]; then
|
|
just exec "$service" "psql -U postgres < /backups/$backup_file" "$file_arg"
|
|
else
|
|
just exec "$service" "psql -U postgres < /backups/$backup_file"
|
|
fi
|
|
fi
|
|
|
|
echo -e "{{GREEN}}✓ Database restored successfully from $backup_file{{NORMAL}}" |