Download the PHP package netserva/fleet without Composer
On this page you can find all versions of the php package netserva/fleet. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download netserva/fleet
More information about netserva/fleet
Files in netserva/fleet
Package fleet
Short Description NetServa Fleet Management Plugin - VSite->VNode->VHost infrastructure tracking
License MIT
Homepage https://netserva.org
Informations about the package fleet
NetServa Fleet Management Plugin
A comprehensive infrastructure management plugin for NetServa that tracks and manages your VSiteβVNodeβVHost hierarchy across mixed infrastructure environments.
Overview
NetServa Fleet provides unified management for:
- VSites - Hosting providers/locations (local Incus, BinaryLane VPS, customer hardware)
- VNodes - Physical/virtual servers
- VHosts - VM/CT instances (complete virtualized environments, not just web vhosts)
Key Features
ποΈ Three-Tier Infrastructure Hierarchy
- VSite (hosting provider/location) β VNode (server) β VHost (VM/CT instance)
- Supports mixed infrastructure: local Incus, local Proxmox, BinaryLane VPS, customer hardware
- Role-based node classification: compute, network, storage, mixed
π SSH-Based Discovery
- Automatic system information discovery via SSH
- Graceful error handling for unreachable nodes
- Role-specific discovery commands for different node types
- Scheduled scanning with configurable frequency
π Comprehensive Management Interface
- Full Filament 4.0 admin interface for fleet management
- Real-time discovery status and system information
- Bulk operations for discovery and management
- Integration with existing NetServa SSH host management
π NetServa Integration
- Import existing infrastructure from
var/directory structure - Sync with NetServa 54-variable environment files
- Support for
/srv/filesystem layout standard - Integration with existing SSH host configurations
Installation
-
Add to your Laravel application's composer.json:
-
Install the package:
-
Run migrations:
- Publish configuration (optional):
Usage
Import Existing Infrastructure
Import from your existing var/ directory structure:
Discovery Management
Discover system information via SSH:
Web Interface
Access the fleet management interface at /admin/fleet-vsites in your Filament admin panel.
Configuration
VSite Directory Mappings
Configure how var/ directory names map to VSites in config/fleet.php:
Discovery Commands
Customize discovery commands for different node roles:
Architecture
Database Schema
fleet_vsites (Hosting Providers)
- Tracks hosting providers and technologies
- Unique constraint on provider+technology+location
- Capabilities and API endpoint configuration
fleet_vnodes (Servers)
- Physical/virtual servers with SSH access
- Role-based classification and discovery
- System information and discovery status
- Links to SSH host configurations
fleet_vhosts (VM/CT Instances)
- Complete virtualized environments
- NetServa environment variable integration
- Instance type and resource tracking
- File system integration with var/ directory
Discovery Architecture
- Role-based discovery: Different commands for compute/network/storage nodes
- Graceful failure handling: Continue discovery even if some commands fail
- SSH-only approach: All discovery via SSH with proper error handling
- Scheduled scanning: Configurable frequency with automatic retry for failures
Error Handling
- SSH connection failures are logged but don't stop discovery
- Command failures are tracked per-node for debugging
- Partial discovery results are saved (get what we can)
- Failed nodes are scheduled for retry at shorter intervals
Testing
Run the test suite:
NetServa Compliance
This plugin follows NetServa standards:
- β
Uses NetServa 5-character environment variables (
$NSVAR,$NSSSH, etc.) - β Supports 54-variable NetServa environment files
- β
Compatible with
/srv/filesystem layout - β Integrates with existing SSH host management
- β Follows MIT license with consistent headers
- β Uses Pest 4.0 for testing
- β Filament 4.0 admin interface
License
MIT License - see LICENSE file for details.
Support
For issues and feature requests, please use the main NetServa repository issue tracker.
All versions of fleet with dependencies
laravel/framework Version ^12.0
filament/filament Version ^4.0
netserva/core Version ^0.0.3