Files
pulp-console/app/pulp_client.py
Hyemin Lee 6c41b89c53 feat: sync execution with 3s progress polling (stage 2)
- 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>
2026-06-17 11:09:37 +09:00

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)