Solar Boat CLI 🚀

Solar Boat is a command-line interface tool designed for Infrastructure as Code (IaC) and GitOps workflows. It provides intelligent Terraform operations management with automatic dependency detection and stateful/stateless module handling.

Why "Solar Boat"? ⛵

Inspired by the Ancient Egyptian Solar Boats that carried Pharaohs through their celestial journey, this CLI tool serves as a modern vessel that carries developers through the complexities of operations and infrastructure management. Just as the ancient boats handled the journey through the afterlife so the Pharaoh didn't have to worry about it, Solar Boat CLI handles the operational journey so developers can focus on what they do best - writing code.

Features ✨

Current Features

• Intelligent Terraform Operations
  • Automatic detection of changed modules
  • Smart handling of stateful and stateless modules
  • Automatic dependency propagation
  • Parallel execution of independent modules
  • Detailed operation reporting

Coming Soon

• Self-service ephemeral environments on Kubernetes
• Infrastructure management and deployment
• Custom workflow automation

Installation 📦

Using Cargo (Recommended)

# Install the latest version
cargo install solarboat

# Install a specific version
cargo install solarboat --version 0.1.2

Building from Source

git clone https://github.com/devqik/solarboat.git
cd solarboat
cargo build

Usage 🛠️

Basic Commands

# Plan Terraform changes
solarboat plan

# Plan and save outputs to a specific directory
solarboat plan --output-dir ./terraform-plans

# Apply Terraform changes
solarboat apply

Module Types

Solar Boat CLI recognizes two types of Terraform modules:

• Stateful Modules: Modules that manage actual infrastructure state (contain backend configuration)
• Stateless Modules: Reusable modules without state (no backend configuration)

When changes are detected in stateless modules, the CLI automatically identifies and processes any stateful modules that depend on them.

GitHub Actions Integration

Solar Boat provides a GitHub Action for seamless integration with your CI/CD pipeline. The action can scan for changes, generate Terraform plans, and automatically comment on pull requests with the results.

Basic Usage

name: Infrastructure Management

on:
  pull_request:
    branches: [ main ]
  push:
    branches: [ main ]

jobs:
  infrastructure:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0  # Important for detecting changes

      - name: Plan Infrastructure Changes
        if: github.event_name == 'pull_request'
        uses: devqik/solar-boat-action@v1
        with:
          command: plan
          output_dir: terraform-plans
          github_token: ${{ secrets.GITHUB_TOKEN }}
          
      - name: Apply Infrastructure Changes
        if: github.ref == 'refs/heads/main'
        uses: devqik/solar-boat-action@v1
        with:
          command: apply
          github_token: ${{ secrets.GITHUB_TOKEN }}

This workflow will:

1. Run terraform plan on pull requests
2. Save plan artifacts for review
3. Comment on the PR with results
4. Apply changes when merged to main

Action Inputs

Features

• Automatic Plan Generation: Generates Terraform plans for changed modules
• PR Comments: Automatically comments on pull requests with plan results
• Artifact Upload: Uploads plan files as artifacts for review
• Plan Retention: Keeps plan artifacts for 5 days
• Change Detection: Smart detection of changed Terraform modules

PR Comment Example

When a plan is generated, the action will automatically comment on the pull request with:

• Summary of changes detected
• Links to plan artifacts
• Next steps for review
• Retention period information

Security Note

The action requires GITHUB_TOKEN for commenting on PRs and managing artifacts. This token is automatically provided by GitHub Actions, but you need to pass it explicitly to the action.

Contributing ��

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

License 📄

This project is licensed under the BSD-3-Clause License - see the LICENSE file for details.

Support 💬

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Wiki

Acknowledgments 🙏

Special thanks to all contributors who help make this project better! Whether you're fixing bugs, improving documentation, or suggesting features, your contributions are greatly appreciated.

~ @devqik (Creator)