Skip to content

JAngular v1.3.0 - Docker Infrastructure Update and CLI Enhancement

Latest
Latest
Compare
Choose a tag to compare
@nathangtg nathangtg released this 30 Apr 17:09
· 7 commits to master since this release
v1.3.0
951d172

JAngular v1.3.0 - Docker Infrastructure Update and CLI Enhancement

🚀 Overview

We're excited to announce the release of JAngular v1.3.0! This version introduces comprehensive Docker support with pre-configured services, making it easier than ever to set up your development environment and deploy your applications.

✨ New Features

Docker Integration

  • Ready-to-use Docker configuration - No need to start from scratch! Use our pre-configured Docker setup for your JAngular applications
  • Interactive CLI commands - Manage your Docker services with simple npx jangular docker commands
  • Multi-container architecture - Complete development stack with frontend, backend, and database services

Container Services

  • Spring Boot Backend - Java 21 container with Maven build system
  • Angular Frontend - Node.js 20 build environment with Nginx server
  • Database Services:
    • MySQL 8.0 with phpMyAdmin interface
    • PostgreSQL 15 with pgAdmin interface
  • Health checks and container dependency management for reliable startup
  • Persistent volumes for database data preservation

Developer Experience

  • Interactive Docker management menu with the following options:
    • Start all services
    • Start only databases
    • Start backend only
    • Start frontend only
    • Show running containers
    • View service logs with selection interface
    • Check database health
    • Stop all services
    • Reset volumes (with confirmation)
  • Colored output in terminal for better readability
  • Automatic verification of Docker dependencies
  • Service access information displayed automatically

🛠️ Technical Details

Service Endpoints

Service URL Credentials
Backend http://localhost:8080 -
Frontend http://localhost:4200 -
phpMyAdmin http://localhost:8081 root / rootpassword
pgAdmin http://localhost:8082 [email protected] / admin

Docker Files Added

  • docker-compose.yml - Main configuration file for all services
  • backend.Dockerfile - Multi-stage build for the Spring Boot application
  • frontend.Dockerfile - Multi-stage build for the Angular application

📋 Usage

Prerequisites

  • Docker
  • Docker Compose

Quick Start

# Start the interactive Docker menu
npx jangular docker

Or directly start all services


npx jangular docker start-all

Available Commands

npx jangular docker             # Open interactive menu
npx jangular docker start-all   # Start all containers
npx jangular docker start-db    # Start only database containers
npx jangular docker ps          # Show running containers
npx jangular docker logs        # View container logs
npx jangular docker health      # Check database health
npx jangular docker stop        # Stop all containers
npx jangular docker reset       # Reset all data volumes

📝 Notes

  • All database data is persisted in Docker volumes
  • Services are configured to restart automatically unless explicitly stopped
  • The backend service waits for databases to be healthy before starting

🔄 Upgrading from Previous Versions

If you're upgrading from a previous version, you can simply run:

npm update -g jangular
# or
npx jangular update

After updating, you'll have immediate access to the new Docker functionality.

🧪 Known Issues & Limitations

  • Docker commands require Docker and Docker Compose to be installed and running
  • The Docker menu currently only supports one configuration at a time
  • Custom environment variable configuration will be added in a future release

We hope this update makes your development workflow smoother! If you encounter any issues or have suggestions, please open an issue on our GitHub repository.

Assets 2
Loading