mirror of
https://github.com/shadoll/just-commons.git
synced 2026-08-28 11:33:18 +00:00
sha
c359858ee9
- Add [confirm] attribute to all destructive operations: - volumes-clean-all, volumes-remove, volumes-remove-pattern - postgres-drop-database, postgres-restore - mysql-drop-database, mysql-restore - Remove manual read -p confirmations and conditional logic - Simplifies code and uses Just's built-in confirmation system - Ensures consistent confirmation behavior across all destructive operations This provides better UX and cleaner code using Just's native features.
113 lines
3.4 KiB
Markdown
113 lines
3.4 KiB
Markdown
# Just Commons
|
|
|
|
Universal Just command recipes for container management across projects.
|
|
|
|
## Overview
|
|
|
|
This repository contains reusable Just recipes for:
|
|
- **Container operations**: start, stop, restart, logs, shell, exec, status
|
|
- **Registry authentication**: login, logout, status checks for GitHub Container Registry
|
|
- **Image operations**: build, push, pull, tag, test, info, clean
|
|
- **Database operations**: PostgreSQL and MySQL database management
|
|
|
|
## Usage
|
|
|
|
Add as a Git submodule to your project:
|
|
|
|
```bash
|
|
git submodule add git@github.com:shadoll/just-commons.git
|
|
```
|
|
|
|
Import in your `justfile`:
|
|
|
|
```bash
|
|
# Import universal commands
|
|
import 'just-commons/core.just' # Core utilities
|
|
import 'just-commons/container.just' # Container operations
|
|
import 'just-commons/registry.just' # Registry authentication
|
|
import 'just-commons/images.just' # Image operations
|
|
|
|
# Import database and volume commands (optional)
|
|
import 'just-commons/postgres.just' # PostgreSQL operations
|
|
import 'just-commons/mysql.just' # MySQL operations
|
|
import 'just-commons/volumes.just' # Volume management
|
|
```
|
|
|
|
## Files
|
|
|
|
### Core Files
|
|
- `core.just` - Core utilities (_detect_runtime, _detect_compose, env-check)
|
|
- `container.just` - Universal container operations (start, stop, logs, shell, exec, status)
|
|
- `registry.just` - GitHub Container Registry authentication (registry-login, registry-logout, registry-check)
|
|
- `images.just` - Universal image operations (image-build, image-push, image-pull, image-tag, etc.)
|
|
|
|
### Database Files (Optional)
|
|
- `postgres.just` - PostgreSQL operations (postgres-sql, postgres-check, postgres-list-databases, etc.)
|
|
- `mysql.just` - MySQL operations (mysql-sql, mysql-check, mysql-list-databases, etc.)
|
|
|
|
### Volume Management (Optional)
|
|
- `volumes.just` - Volume operations (volumes-clean-all, volumes-remove, volumes-list, etc.)
|
|
|
|
### Command Structure
|
|
- **Container commands**: No prefix (start, stop, logs, shell, exec, status, restart)
|
|
- **All other commands**: Prefixed by file type (image-*, registry-*, postgres-*, mysql-*)
|
|
|
|
### Usage Examples
|
|
|
|
```bash
|
|
# Container operations (no prefix)
|
|
just start postgres
|
|
just logs postgres
|
|
just shell postgres
|
|
|
|
# Image operations (image- prefix)
|
|
just image-build postgres
|
|
just image-push postgres v1.0.0
|
|
|
|
# Registry operations (registry- prefix)
|
|
just registry-login
|
|
just registry-check
|
|
|
|
# Database operations (database- prefix)
|
|
just postgres-sql "SELECT version();"
|
|
just postgres-check
|
|
just mysql-sql "SELECT VERSION();"
|
|
|
|
# Volume operations (volumes- prefix)
|
|
just volumes-list "myproject_*"
|
|
just volumes-clean-all
|
|
just volumes-remove "old_volume"
|
|
```
|
|
|
|
## Requirements
|
|
|
|
### Just Command Runner
|
|
|
|
This library requires **Just 1.14.0 or later** to support the `group` attribute for organized command display.
|
|
|
|
#### Installation on Ubuntu 24.04 LTS
|
|
|
|
**Method 1: Snap (Recommended for latest version)**
|
|
```bash
|
|
sudo snap install just --classic
|
|
```
|
|
|
|
**Method 2: Manual Installation from GitHub**
|
|
```bash
|
|
# Get the latest version
|
|
JUST_VERSION=$(curl -s "https://api.github.com/repos/casey/just/releases/latest" | grep -Po '"tag_name": "\K[0-9.]+')
|
|
|
|
# Download and install
|
|
wget -qO just.tar.gz "https://github.com/casey/just/releases/latest/download/just-${JUST_VERSION}-x86_64-unknown-linux-musl.tar.gz"
|
|
tar -xzf just.tar.gz
|
|
sudo mv just /usr/local/bin/
|
|
chmod +x /usr/local/bin/just
|
|
|
|
# Verify installation
|
|
just --version
|
|
```
|
|
|
|
### Other Requirements
|
|
- Docker or Podman
|
|
- Git
|