Skip to main content

IONOS FinOps

License: MIT Python 3.8+

IONOS FinOps is an open-source cost estimation tool for IONOS Cloud infrastructure defined in Terraform. Similar to Infracost but specifically designed for IONOS, it provides 100% accurate pricing calculations for your infrastructure before deployment.

Features

  • 🎯 Accurate Pricing: Calculate exact costs based on IONOS's current pricing
  • 📊 Terraform Integration: Parse Terraform files and state to extract IONOS resources
  • 💰 Cost Breakdown: Detailed cost analysis per resource and resource type
  • 🔄 Diff Support: Compare costs between Terraform plans
  • 📈 Multiple Output Formats: JSON, Table, HTML reports
  • 🌍 Multi-Region Support: Pricing for all IONOS data center locations
  • 🔌 CI/CD Integration: Easy integration into your deployment pipelines

Supported IONOS Resources

  • Compute: Servers (VMs), Cubes, VCPUs, RAM
  • Storage: Block Storage, Object Storage (S3)
  • Networking: Load Balancers, IP Addresses, Network Bandwidth
  • Databases: DBaaS (PostgreSQL, MongoDB, MySQL, MariaDB)
  • Kubernetes: Managed Kubernetes clusters, node pools
  • Backup: Backup Units

Installation

From PyPI (when published)

pip install ionos-finops

From Source

git clone https://github.com/yourusername/ionos-finops.git
cd ionos-finops
pip install -e .

Quick Start

Basic Usage

# Calculate costs from Terraform directory
ionos-finops breakdown --path /path/to/terraform

# Calculate costs from Terraform plan
terraform plan -out=plan.tfplan
ionos-finops breakdown --plan-file plan.tfplan

# Output as JSON
ionos-finops breakdown --path . --format json

# Compare costs between current and planned state
ionos-finops diff --path .

Example Output

Project: my-ionos-infrastructure
Region: de/fra

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Resource                                    Monthly Cost    Yearly Cost      ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ ionos_server.web_server                    €45.00          €540.00          │
│   - 2 vCPUs                                 €20.00          €240.00          │
│   - 4 GB RAM                                €15.00          €180.00          │
│   - 50 GB Storage                           €10.00          €120.00          │
│                                                                               │
│ ionos_volume.data_volume                   €30.00          €360.00          │
│   - 200 GB SSD Storage                      €30.00          €360.00          │
│                                                                               │
│ ionos_loadbalancer.main_lb                 €25.00          €300.00          │
│                                                                               │
│ ionos_ipblock.public_ips                   €5.00           €60.00           │
│   - 2 IPv4 addresses                        €5.00           €60.00           │
├─────────────────────────────────────────────────────────────────────────────┤
│ TOTAL                                       €105.00         €1,260.00        │
└─────────────────────────────────────────────────────────────────────────────┘

Configuration

Create a .ionos-finops.yml file in your project root:

# IONOS API credentials (optional, for real-time pricing updates)
api_url: https://api.ionos.com/cloudapi/v6
api_token: ${IONOS_TOKEN}

# Default region
default_region: de/fra

# Currency
currency: EUR

# Pricing update frequency (in hours)
pricing_cache_ttl: 24

# Custom pricing overrides (optional)
custom_pricing:
  ionos_server:
    vcpu_hourly: 0.01
    ram_gb_hourly: 0.005

CI/CD Integration

GitHub Actions

name: IONOS Cost Estimation

on: [pull_request]

jobs:
  cost-estimate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup Terraform
        uses: hashicorp/setup-terraform@v2
      
      - name: Install IONOS FinOps
        run: pip install ionos-finops
      
      - name: Terraform Plan
        run: terraform plan -out=plan.tfplan
      
      - name: Calculate Costs
        run: ionos-finops breakdown --plan-file plan.tfplan --format json > costs.json
      
      - name: Comment PR
        uses: actions/github-script@v6
        with:
          script: |
            const fs = require('fs');
            const costs = JSON.parse(fs.readFileSync('costs.json', 'utf8'));
            // Add comment logic here

GitLab CI

ionos-cost-estimate:
  stage: plan
  script:
    - pip install ionos-finops
    - terraform plan -out=plan.tfplan
    - ionos-finops breakdown --plan-file plan.tfplan
  only:
    - merge_requests

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/yourusername/ionos-finops.git
cd ionos-finops

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
black .
flake8 .
mypy .

Project Structure

ionos-finops/
├── ionos_finops/
│   ├── __init__.py
│   ├── cli.py                 # CLI interface
│   ├── parser/
│   │   ├── __init__.py
│   │   ├── terraform.py       # Terraform file parser
│   │   └── hcl.py            # HCL parsing utilities
│   ├── pricing/
│   │   ├── __init__.py
│   │   ├── data.py           # Pricing data structures
│   │   ├── api.py            # IONOS API integration
│   │   └── calculator.py     # Cost calculation engine
│   ├── resources/
│   │   ├── __init__.py
│   │   ├── base.py           # Base resource class
│   │   ├── compute.py        # Compute resources
│   │   ├── storage.py        # Storage resources
│   │   ├── network.py        # Network resources
│   │   └── database.py       # Database resources
│   └── output/
│       ├── __init__.py
│       ├── table.py          # Table formatter
│       ├── json.py           # JSON formatter
│       └── html.py           # HTML report generator
├── tests/
├── examples/
├── pricing_data/             # Static pricing data
├── setup.py
├── requirements.txt
├── README.md
└── LICENSE

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

How to Contribute

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Pricing Data

Pricing data is maintained manually based on IONOS website pricing, with comprehensive validation and community contribution processes.

⚠️ Important: IONOS API Limitations

IONOS does not provide a public pricing API. Their APIs focus on account-specific billing data rather than public pricing catalogs.

📊 Current Pricing Data

Region Location Currency Status Source
de/fra Frankfurt EUR ✅ Current Manual
de/ber Berlin EUR ✅ Current Manual
de/fra2 Frankfurt 2 EUR ✅ Current Manual
gb/lhr London GBP ✅ Current Manual
gb/wor Worchester GBP ✅ Current Manual
fr/par Paris EUR ✅ Current Manual
es/log Logroño EUR ✅ Current Manual
us/las Las Vegas USD ✅ Current Manual
us/ewr Newark USD ✅ Current Manual
us/kc Lenexa USD ✅ Current Manual

🛠️ Manual Update Process

# Validate current pricing data
make validate-pricing

# Manual update workflow
# 1. Check IONOS website pricing
# 2. Update pricing files manually
# 3. Validate changes
make validate-pricing

# Test with sample infrastructure
ionos-finops breakdown --path examples/

🤝 Community Contributions

Help keep pricing current! If you notice pricing changes on the IONOS website:

  1. Check Current Pricing: Visit IONOS Pricing Calculator
  2. Update Files: Edit relevant pricing files in ionos_finops/pricing_data/
  3. Validate: Run make validate-pricing
  4. Test: Verify with sample Terraform files
  5. Submit PR: Create pull request with pricing changes

🔍 Pricing Validation

The tool includes comprehensive pricing validation:

# Validate all pricing data
make validate-pricing

# Check pricing API status
python scripts/check_pricing_status.py

# Run pricing validation tests
pytest tests/test_pricing_validation.py -v

📖 Documentation

See docs/pricing-updates.md for detailed pricing update procedures and limitations.

Roadmap

  • Support for all IONOS Terraform resources
  • Real-time pricing API integration
  • Cost optimization recommendations
  • Budget alerts and thresholds
  • Historical cost tracking
  • Multi-cloud comparison (IONOS vs AWS/Azure/GCP)
  • Terraform Cloud/Enterprise integration
  • Web UI for cost visualization

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Support

This project supports and complements larger infrastructure cost management initiatives. If you're using Infracost for multi-cloud environments, IONOS FinOps provides the same level of accuracy specifically for IONOS Cloud resources.


Made with ❤️ for the IONOS Cloud community

Metadata

Release files for ionos-finops 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ionos-finops 0.1.0
File Size Uploaded Provenance Actions
ionos_finops-0.1.0.tar.gz 52.9 kB Without provenance Details for ionos_finops-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ionos-finops 0.1.0
File Interpreter ABI Platform Actions
ionos_finops-0.1.0-py3-none-any.whl Python 3 none any Details for ionos_finops-0.1.0-py3-none-any.whl

Total release size: 93.9 kB

Release files / ionos_finops-0.1.0.tar.gz

Download URL ionos_finops-0.1.0.tar.gz
Size 52.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2eb79885661ab39f990c537fb816645780946f33c27eee9161a7a1895a6e9b03
BLAKE2b-256 checksum
How to use checksums
8dcfc5996380f1050f75d77b048a62f73f5432597f98685c773e1fd7eefae26b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Release files / ionos_finops-0.1.0-py3-none-any.whl

Download URL ionos_finops-0.1.0-py3-none-any.whl
Size 41.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5158532ba9dbb8829f2442a781d78d612dc613d535cb695c5260102507a4851c
BLAKE2b-256 checksum
How to use checksums
96e6b9ad9667f37a5c7eb7af38eaea011c91300d8bdb09255720246e309c25c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Security for ionos-finops 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page