Welcome to Ironic Python Agent!

Overview

Ironic Python Agent (often abbreviated as IPA) is an agent for controlling and deploying Ironic controlled baremetal nodes. Typically run in a ramdisk, the agent exposes a REST API for provisioning servers.

Contents

• Installing Ironic Python Agent
  • Image Builders
  • IPA Flags
  • IPA and TLS
    • Client Configuration
    • Server Configuration
  • Hardware Managers
• Ironic Python Agent Administration
  • How it works
    • Integration with Ironic
    • Inspection
    • Hardware Inventory
    • Image Checksums
  • Built-in hardware managers
    • GenericHardwareManager
  • Custom hardware managers
    • MellanoxDeviceHardwareManager
  • Rescue mode
    • Overview
    • Support in ironic-python-agent images
  • Troubleshooting Ironic-Python-Agent (IPA)
    • Gaining Access to IPA on a node
    • Set IPA to debug logging
    • Where can I find the IPA logs
    • Manually restart IPA
    • Cleaning halted with ProtectedDeviceError
    • References
• Contributing to Ironic Python Agent
  • Hardware Managers
    • How are methods executed on HardwareManagers?
    • Why build a custom HardwareManager?
    • How can I build a custom HardwareManager?
    • Custom HardwareManagers and Cleaning
    • Custom HardwareManagers and Deploying
    • Custom HardwareManagers and Service operations
  • Emitting metrics from Ironic-Python-Agent (IPA)
    • Overview
    • Using a context manager
    • Explicitly sending metrics
  • Rescue Mode
    • finalize_rescue command
  • Generated Developer Documentation

Indices and tables

• Index

• Search Page