SRE/DevOps 엔지니어가 Python SDK를 내부 패키지로 구축하고 Jenkins 파이프라인에 통합해 자동화 워크플로우 재사용성 확보

Context

SRE와 DevOps 팀은 인프라 자동화, 알림 관리, API 연동 작업을 수행할 때 일회용 스크립트에 의존하고 있었다. 이러한 스크립트는 코드 재사용이 어렵고 버전 관리가 불가능하며 팀 간 공유가 복잡했다.

Technical Solution

• Python 가상환경(venv)과 pip를 활용한 의존성 격리: 프로젝트별로 독립적인 패키지 환경 구성
• HTTP API 통신 계층 구현: requests 라이브러리로 GET, POST, DELETE 메서드 및 인증, 타임아웃, 재시도 로직 작성
• BaseClient 패턴의 SDK 아키텍처 설계: client.py, base_client.py, models.py, exceptions.py로 구조화된 클래스 기반 SDK 개발
• pyproject.toml과 python -m build를 통한 Python 패키지화: 버전 관리 및 wheel 형식으로 배포 가능한 상태로 전환
• Jenkins 파이프라인에 Python SDK 통합: pip install로 패키지 설치 후 Python 스크립트 실행, cron 스케줄링 적용
• pytest와 mocking을 활용한 테스트 작성: API 호출 없이 클라이언트 메서드 검증 및 안전한 실행 패턴 확보

Key Takeaway

내부 자동화 스크립트를 재사용 가능한 Python SDK로 패키징하고 Jenkins 파이프라인에서 호출하는 방식은 플랫폼 엔지니어링의 표준 패턴이다. 이를 통해 개별 팀이 작성한 도구를 회사 전체에서 일관되게 배포하고 유지보수할 수 있다.