Add SQLite database integration with SQLAlchemy async, migration tooling, and comprehensive CRUD operations for hosts, tasks, schedules, and logs

This commit is contained in:
2025-12-04 21:37:55 -05:00
parent 28276f326b
commit ad3a8a5639
38 changed files with 2503 additions and 388 deletions
+91
View File
@@ -0,0 +1,91 @@
from __future__ import annotations
import asyncio
from logging.config import fileConfig
import os
from pathlib import Path
from sqlalchemy import pool
from sqlalchemy.engine import Connection
from sqlalchemy.ext.asyncio import async_engine_from_config
from alembic import context
# Add project root to sys.path for module imports
import sys
ROOT_DIR = Path(__file__).resolve().parents[1]
if str(ROOT_DIR) not in sys.path:
sys.path.insert(0, str(ROOT_DIR))
from app.models.database import Base, metadata_obj, DATABASE_URL # noqa: E402
# this is the Alembic Config object, which provides
# access to the values within the .ini file in use.
config = context.config
# Interpret the config file for Python logging.
if config.config_file_name is not None:
fileConfig(config.config_file_name)
# Override sqlalchemy.url from environment if provided
url_from_env = os.environ.get("DATABASE_URL")
if url_from_env:
config.set_main_option("sqlalchemy.url", url_from_env)
else:
config.set_main_option("sqlalchemy.url", str(DATABASE_URL))
# add your model's MetaData object here
# for 'autogenerate' support
# from myapp import mymodel
# target_metadata = mymodel.Base.metadata
target_metadata = metadata_obj
def run_migrations_offline() -> None:
"""Run migrations in 'offline' mode."""
url = config.get_main_option("sqlalchemy.url")
context.configure(
url=url,
target_metadata=target_metadata,
literal_binds=True,
dialect_opts={"paramstyle": "named"},
compare_type=True,
)
with context.begin_transaction():
context.run_migrations()
def do_run_migrations(connection: Connection) -> None:
context.configure(
connection=connection,
target_metadata=target_metadata,
compare_type=True,
)
with context.begin_transaction():
context.run_migrations()
def run_migrations_online() -> None:
"""Run migrations in 'online' mode."""
connectable = async_engine_from_config(
config.get_section(config.config_ini_section, {}),
prefix="sqlalchemy.",
poolclass=pool.NullPool,
future=True,
)
async def async_main() -> None:
async with connectable.connect() as connection:
await connection.run_sync(do_run_migrations)
await connectable.dispose()
asyncio.run(async_main())
if context.is_offline_mode():
run_migrations_offline()
else:
run_migrations_online()
+122
View File
@@ -0,0 +1,122 @@
"""Initial database schema for Homelab Automation
Revision ID: 0001_initial
Revises:
Create Date: 2025-12-04
"""
from __future__ import annotations
from alembic import op
import sqlalchemy as sa
# revision identifiers, used by Alembic.
revision = "0001_initial"
down_revision = None
branch_labels = None
depends_on = None
def upgrade() -> None:
op.create_table(
"hosts",
sa.Column("id", sa.String(), primary_key=True),
sa.Column("name", sa.String(), nullable=False),
sa.Column("ip_address", sa.String(), nullable=False, unique=True),
sa.Column("status", sa.String(), nullable=False, server_default=sa.text("'unknown'")),
sa.Column("ansible_group", sa.String(), nullable=True),
sa.Column("last_seen", sa.DateTime(timezone=True), nullable=True),
sa.Column("reachable", sa.Boolean(), nullable=False, server_default=sa.text("0")),
sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
sa.Column("updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
sa.Column("deleted_at", sa.DateTime(timezone=True), nullable=True),
)
op.create_table(
"bootstrap_status",
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
sa.Column("host_id", sa.String(), sa.ForeignKey("hosts.id", ondelete="CASCADE"), nullable=False),
sa.Column("status", sa.String(), nullable=False),
sa.Column("automation_user", sa.String(), nullable=True),
sa.Column("last_attempt", sa.DateTime(timezone=True), nullable=True),
sa.Column("error_message", sa.Text(), nullable=True),
sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
)
op.create_table(
"tasks",
sa.Column("id", sa.String(), primary_key=True),
sa.Column("action", sa.String(), nullable=False),
sa.Column("target", sa.String(), nullable=False),
sa.Column("status", sa.String(), nullable=False, server_default=sa.text("'pending'")),
sa.Column("playbook", sa.String(), nullable=True),
sa.Column("started_at", sa.DateTime(timezone=True), nullable=True),
sa.Column("completed_at", sa.DateTime(timezone=True), nullable=True),
sa.Column("error_message", sa.Text(), nullable=True),
sa.Column("result_data", sa.JSON(), nullable=True),
sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
)
op.create_table(
"schedules",
sa.Column("id", sa.String(), primary_key=True),
sa.Column("name", sa.String(), nullable=False),
sa.Column("playbook", sa.String(), nullable=False),
sa.Column("target", sa.String(), nullable=False),
sa.Column("schedule_type", sa.String(), nullable=False),
sa.Column("schedule_time", sa.DateTime(timezone=True), nullable=True),
sa.Column("recurrence_type", sa.String(), nullable=True),
sa.Column("recurrence_time", sa.String(), nullable=True),
sa.Column("recurrence_days", sa.Text(), nullable=True),
sa.Column("cron_expression", sa.String(), nullable=True),
sa.Column("enabled", sa.Boolean(), nullable=False, server_default=sa.text("1")),
sa.Column("tags", sa.Text(), nullable=True),
sa.Column("next_run", sa.DateTime(timezone=True), nullable=True),
sa.Column("last_run", sa.DateTime(timezone=True), nullable=True),
sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
sa.Column("updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
sa.Column("deleted_at", sa.DateTime(timezone=True), nullable=True),
)
op.create_table(
"schedule_runs",
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
sa.Column("schedule_id", sa.String(), sa.ForeignKey("schedules.id", ondelete="CASCADE"), nullable=False),
sa.Column("task_id", sa.String(), sa.ForeignKey("tasks.id", ondelete="SET NULL"), nullable=True),
sa.Column("status", sa.String(), nullable=False),
sa.Column("started_at", sa.DateTime(timezone=True), nullable=False),
sa.Column("completed_at", sa.DateTime(timezone=True), nullable=True),
sa.Column("duration", sa.Float(), nullable=True),
sa.Column("error_message", sa.Text(), nullable=True),
sa.Column("output", sa.Text(), nullable=True),
sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
)
op.create_table(
"logs",
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
sa.Column("level", sa.String(), nullable=False),
sa.Column("source", sa.String(), nullable=True),
sa.Column("message", sa.Text(), nullable=False),
sa.Column("details", sa.JSON(), nullable=True),
sa.Column("host_id", sa.String(), sa.ForeignKey("hosts.id", ondelete="SET NULL"), nullable=True),
sa.Column("task_id", sa.String(), sa.ForeignKey("tasks.id", ondelete="SET NULL"), nullable=True),
sa.Column("schedule_id", sa.String(), sa.ForeignKey("schedules.id", ondelete="SET NULL"), nullable=True),
sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
)
op.create_index("idx_logs_created_at", "logs", ["created_at"])
op.create_index("idx_logs_level", "logs", ["level"])
op.create_index("idx_logs_source", "logs", ["source"])
def downgrade() -> None:
op.drop_index("idx_logs_source", table_name="logs")
op.drop_index("idx_logs_level", table_name="logs")
op.drop_index("idx_logs_created_at", table_name="logs")
op.drop_table("logs")
op.drop_table("schedule_runs")
op.drop_table("schedules")
op.drop_table("tasks")
op.drop_table("bootstrap_status")
op.drop_table("hosts")