feat(docker): add async port change and docker compose reload for services

- Introduce async `change_port` to update service port and reload docker compose
- Add `run_docker_command` for running docker compose commands asynchronously
- Implement `_get_random_port` utility for selecting available ports
- Refactor service discovery and port change logic to use new async methods
- Update proxy and manager logic to support new port change workflow

app/integrations/docker/__init__.py

@@ -1,7 +1,7 @@
 from integrations.docker.compose import (
-	find_docker_compose,
-	get_all_services,
-	get_services,
+    find_docker_compose,
+    get_all_services_in_dir,
+    get_services,
 )
 from integrations.docker.editor import change_port
 from integrations.docker.models import DockerContainer
@@ -10,6 +10,6 @@ __all__ = [
 	"DockerContainer",
 	"find_docker_compose",
 	"get_services",
-	"get_all_services",
+    "get_all_services_in_dir",
 	"change_port",
 ]

app/integrations/docker/compose.py

@@ -1,3 +1,4 @@
+import asyncio
 from pathlib import Path
 
 import yaml
@@ -19,7 +20,7 @@ def _get_visible_folders(directory: Path) -> list[Path]:
     ]
 
 
-def find_docker_compose(path: Path) -> tuple[dict, str] | None:
+def find_docker_compose(path: Path) -> tuple[dict, Path] | None:
     if not path or not path.is_dir():
         return None
 
@@ -27,7 +28,7 @@ def find_docker_compose(path: Path) -> tuple[dict, str] | None:
         file = path / name
         if file.is_file():
             content = yaml.safe_load(file.read_text()) or {}
-            return content, file.name
+            return content, file
 
     return None
 
@@ -61,7 +62,7 @@ def get_services(folder: Path) -> list[DockerContainer] | None:
     return services
 
 
-def get_all_services(directory: str | Path) -> list[DockerContainer]:
+def get_all_services_in_dir(directory: str | Path) -> list[DockerContainer]:
     path = Path(directory)
     if not path.is_dir():
         return []
@@ -73,3 +74,27 @@ def get_all_services(directory: str | Path) -> list[DockerContainer]:
             services.extend(sub_services)
 
     return services
+
+
+async def run_docker_command(
+        file: Path,
+        command: list[str]
+) -> dict | None:
+    if not command:
+        return None
+
+    full_command = ["docker", "compose", "-f", f"{file}", *command]
+
+    process = await asyncio.create_subprocess_exec(
+        *full_command,
+        cwd=str(file.parent),
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE
+    )
+
+    stdout, stderr = await process.communicate()
+
+    if process.returncode == 0:
+        return {"status": "success", "output": stdout.decode()}
+    else:
+        return {"status": "error", "reason": stderr.decode()}

app/integrations/docker/editor.py

@@ -2,7 +2,7 @@ from pathlib import Path
 
 import yaml
 
-from integrations.docker.compose import find_docker_compose
+from integrations.docker.compose import find_docker_compose, run_docker_command
 from integrations.docker.ports import _get_port_index, _replace_port_in_mapping
 
 
@@ -12,9 +12,9 @@ def _backup_path_for(compose_path: Path) -> Path:
     return compose_path.with_name(f"{compose_path.name}.bak")
 
 
-def change_port(
-        folder: Path,
+async def change_port(
         service_name: str,
+        folder: Path,
         port_from: int,
         port_to: int,
 ) -> bool:
@@ -22,7 +22,7 @@ def change_port(
     if compose_data is None:
         return False
 
-    docker_compose, filename = compose_data
+    docker_compose, compose_path = compose_data
     compose_services = docker_compose.get("services") or {}
     if not compose_services:
         return False
@@ -41,10 +41,19 @@ def change_port(
 
     mappings[idx] = _replace_port_in_mapping(mappings[idx], port_from, port_to)
 
-    compose_path = folder / filename
     backup_path = _backup_path_for(compose_path)
+    original_text = compose_path.read_text()
+
     backup_path.write_text(compose_path.read_text())
     compose_path.write_text(yaml.dump(docker_compose, default_flow_style=False, sort_keys=False))
 
-    # TODO: run docker compose commands
+    result = await run_docker_command(
+        compose_path,
+        ["up", "-d", service_name],
+    )
+
+    if result is None or result.get("status") != "success":
+        compose_path.write_text(original_text)
+        return False
+
     return True

app/integrations/docker/ports.py

@@ -1,6 +1,19 @@
+import socket
 from collections.abc import Mapping
 
 
+def _get_random_port() -> int:
+    # os automatically assigns an available port when binding to port 0, so we can use that to find a free port
+    try:
+        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+            s.bind(('', 0))
+            s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            port = s.getsockname()[1]
+            return port
+    except Exception as e:
+        raise RuntimeError(f"Could not find an available port: {e}")
+
+
 def _get_service_port(mapping: str | int | Mapping[str, object]) -> int | None:
     if isinstance(mapping, int):
         return mapping