- pulp_client: get_repo / sync_repo / get_task (비동기 task href 반환)
- POST /repos/{uuid}/sync: remote 확인 후 동기화 시작, 진행률 조각 반환
- GET /repos/{uuid}/progress: progress_reports 합산 → 바/퍼센트,
완료/실패 시 hx-trigger 제거로 폴링 중단
- task_store: uuid→task_href 메모리 추적 (단일 인스턴스), 대시보드 '동기화 중' 집계
- views.task_progress: state/done/total/percent + created_resources에서 새 vN
- 동기화는 안전 동작이라 확인 모달 없이 실행 (스펙 §5-1)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
91 lines
3.3 KiB
Python
91 lines
3.3 KiB
Python
"""Pulp REST API 호출 래퍼 (스펙 §7).
|
|
|
|
브라우저가 아니라 이 BFF 가 Basic Auth 를 쥐고 Pulp 를 호출한다(스펙 §2).
|
|
객체는 이름이 아니라 ``pulp_href``(경로 문자열) 기준으로 참조한다(스펙 §4).
|
|
|
|
폴링은 화면(HTMX)이 담당하므로 여기서는 task 단발 조회만 둔다. sync/deploy 등
|
|
도메인 메서드는 이후 단계에서 추가한다.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
import httpx
|
|
|
|
from .config import Settings, get_settings, tls_verify
|
|
|
|
API_PREFIX = "/pulp/api/v3"
|
|
|
|
|
|
class PulpClient:
|
|
def __init__(self, settings: Settings | None = None) -> None:
|
|
self.settings = settings or get_settings()
|
|
self._client = httpx.Client(
|
|
base_url=self.settings.pulp_base_url.rstrip("/"),
|
|
auth=(self.settings.pulp_username, self.settings.pulp_password),
|
|
verify=tls_verify(self.settings),
|
|
timeout=30.0,
|
|
)
|
|
|
|
def close(self) -> None:
|
|
self._client.close()
|
|
|
|
def __enter__(self) -> PulpClient:
|
|
return self
|
|
|
|
def __exit__(self, *exc: object) -> None:
|
|
self.close()
|
|
|
|
# --- 저수준 호출 (Basic Auth 포함) ---------------------------------
|
|
def get(self, path: str, **kwargs: Any) -> dict[str, Any]:
|
|
resp = self._client.get(path, **kwargs)
|
|
resp.raise_for_status()
|
|
return resp.json()
|
|
|
|
def post(self, path: str, json: Any | None = None, **kwargs: Any) -> dict[str, Any]:
|
|
resp = self._client.post(path, json=json, **kwargs)
|
|
resp.raise_for_status()
|
|
return resp.json()
|
|
|
|
def patch(
|
|
self, href: str, json: Any | None = None, **kwargs: Any
|
|
) -> dict[str, Any]:
|
|
resp = self._client.patch(href, json=json, **kwargs)
|
|
resp.raise_for_status()
|
|
return resp.json()
|
|
|
|
# --- 도메인 헬퍼 ----------------------------------------------------
|
|
def status(self) -> dict[str, Any]:
|
|
"""헬스체크: GET /pulp/api/v3/status/"""
|
|
return self.get(f"{API_PREFIX}/status/")
|
|
|
|
def list_repos(self) -> list[dict[str, Any]]:
|
|
"""RPM 저장소 목록: GET /pulp/api/v3/repositories/rpm/rpm/ → results."""
|
|
data = self.get(f"{API_PREFIX}/repositories/rpm/rpm/")
|
|
return data.get("results", [])
|
|
|
|
def get_version(self, version_href: str) -> dict[str, Any]:
|
|
"""RepositoryVersion 단건 조회 (href 기준). content_summary 등 포함."""
|
|
return self.get(version_href)
|
|
|
|
def get_repo(self, uuid: str) -> dict[str, Any]:
|
|
"""저장소 단건 조회 (remote href 등 확인용)."""
|
|
return self.get(f"{API_PREFIX}/repositories/rpm/rpm/{uuid}/")
|
|
|
|
def sync_repo(self, uuid: str, remote_href: str) -> str:
|
|
"""동기화 시작 → 비동기 task. 반환 task_href 를 폴링으로 추적한다(스펙 §4).
|
|
|
|
POST .../repositories/rpm/rpm/{uuid}/sync/ body {"remote": <remote_href>}
|
|
응답 {"task": "/pulp/api/v3/tasks/<uuid>/"} 에서 task href 추출.
|
|
"""
|
|
data = self.post(
|
|
f"{API_PREFIX}/repositories/rpm/rpm/{uuid}/sync/",
|
|
json={"remote": remote_href},
|
|
)
|
|
return data["task"]
|
|
|
|
def get_task(self, task_href: str) -> dict[str, Any]:
|
|
"""task 단건 조회 (state, progress_reports, created_resources, error)."""
|
|
return self.get(task_href)
|