Skip to content

0.0.3

Choose a tag to compare

View all tags
@snonux snonux released this 12 Jul 10:55
· 131 commits to master since this release
0.0.3
7419fd7

Release 0.0.3

Release Notes

This release significantly enhances fapi's functionality and usability, introducing comprehensive F5 BigIP load balancer management capabilities with improved documentation and streamlined workflows.

🚀 New Features

Complete Load Balancer Management Suite

  • Node Management: Create, delete, and manage server nodes with automatic FQDN and IP address resolution
  • Pool Operations: Full pool lifecycle management including member addition/removal and monitor associations
  • Virtual Server Control: Create and configure virtual servers with support for nPath, NAT, and SNAT services
  • Monitor Integration: Associate and manage health monitors for pools to ensure service availability

Enhanced CLI Experience

  • Intuitive Command Structure: Simplified syntax for common operations (e.g., f node, f pool, f vserver)
  • Flexible Object Naming: Support for both short names and full partition paths for all operations
  • Automatic Resolution: FQDN and IP address auto-resolution reduces manual configuration errors
  • Rich Output Formatting: Newline-separated results for better script integration

Authentication & Session Management

  • BigIP Integration: Seamless login via bigsuds library with partition management
  • Secure Connections: Built-in support for F5's iControl API with proper authentication handling

📚 Documentation & Setup

Comprehensive Documentation

  • Quick Start Guide: Step-by-step installation and configuration instructions
  • Practical Examples: Real-world scenarios including nPath service setup
  • API Reference: Complete iControl API documentation links for advanced users
  • Man Page: Detailed command-line reference with examples

Simplified Installation

  • Debian Package: Official .deb package with automatic dependency management
  • Bundled Dependencies: Includes bigsuds library in contrib directory
  • Configuration Templates: Sample configuration files to get started quickly

🔧 Improvements

Developer Experience

  • Exception Handling: Robust error handling with informative messages
  • Code Organization: Refactored codebase with improved modularity and maintainability
  • Lazy Evaluation: Performance optimizations for better responsiveness

Operational Enhancements

  • Detailed Information: Enhanced detail views for nodes, pools, and virtual servers
  • Flexible Configuration: Support for multiple load balancer failover scenarios
  • Streamlined Workflows: Simplified commands for common administrative tasks

📦 Dependencies

Required Libraries

  • bigsuds: F5's official Python iControl library (included in contrib/)
  • Python Dependencies: All required packages automatically handled via setup.py

Installation Requirements

  • Access to F5 DevCentral for bigsuds library
  • Valid F5 BigIP credentials with appropriate permissions
  • Python environment with SSL support for HTTPS connections

🔄 Migration Notes

This release maintains backward compatibility while introducing new command structures. Users can immediately benefit from the enhanced CLI without modifying existing scripts, though the new simplified syntax is recommended for new implementations.

🎯 Getting Started

  1. Install the package: aptitude install fapi
  2. Copy sample configuration: cp /usr/share/fapi/fapi.conf.sample ~/.fapi.conf
  3. Configure your BigIP credentials in ~/.fapi.conf
  4. Start managing your load balancers with intuitive commands like f node list and f pool create

This release transforms fapi from a basic tool into a comprehensive F5 BigIP management solution, making load balancer administration more accessible and efficient for both newcomers and experienced administrators.

Assets 2
Loading