pm5 0.1.4

pm5 (Process Manager) - README

Overview

pm5 is a Python package inspired by pm2, designed to easily manage multiple services and their configurations. It is particularly useful for advanced scenarios where precise control over CPU usage, service monitoring, and automatic restarts are required. This package was created to overcome limitations in managing multiple Celery queues and workers, allowing for more granular control of allocated CPU.

pm5 is a simple tool for developers and system administrators who need advanced control over multiple services and their configurations. Its ability to manage resources, automate restarts, and handle graceful shutdowns makes it an essential tool for complex service management scenarios.

Use Cases

• Managing Multiple Celery Queues: Gain fine-grained control over the number of workers per queue, overcoming limitations of Celery's worker management.
• Service Stack Management: Manage and configure multiple services as a single stack, simplifying the deployment and monitoring process.
• Advanced Resource Management: Allocate CPU resources more effectively across multiple services, ensuring optimal performance and resource utilization.

Features

• Service Management: Start, stop, and monitor multiple services with ease.
• Advanced CPU Management: Control the number of instances per service based on CPU availability.
• Automatic Restarts: Automatically restart services on failure with configurable restart limits.
• Environment Management: Pass specific environment variables to each service.
• Graceful Shutdown: Handle graceful shutdowns and cleanups of services.
• Configuration Flexibility: Easily configure services through a JSON ecosystem file.

Installation

pip install pm5

Configuration

Create an ecosystem configuration file (e.g., ecosystem.config.json) to define the services you want to manage.

Example ecosystem.config.json

{
  "services": [
    {
      "name": "Test Application 1",
      "interpreter": "python3.9",
      "interpreter_args": [],
      "script": "test.py",
      "args": [],
      "instances": 1,
      "wait_ready": true,
      "autorestart": true,
      "max_restarts": 3,
      "env": {
        "ENV_VAR": "value"
      },
      "disabled": false
    }
  ]
}

Configuration Fields

Usage

Help

❯ pm5 --help
usage: pm5 [-h] {start,stop} ...

Like pm2 but without node.js.

positional arguments:
  {start,stop}
    start       Start the process manager daemon
    stop        Stop the process manager daemon

optional arguments:
  -h, --help    show this help message and exit

Start the stack as a daemon

pm5 start

Stop the daemonized stack

pm5 stop

Start the app without daemonizing

pm5 start --debug