Kong Konnect 통합 카탈로그로 보는 API·서비스 관리 전략

핵심 메시지

• API와 서비스는 다르다. API는 아직 구현이 없는 설계 제안일 수도 있지만, 서비스는 이미 운영 중인 애플리케이션이다.
• Kong Konnect는 기존 "서비스 카탈로그"를 "카탈로그"로 재편해 API와 서비스를 한 곳에서 관리한다.
• 카탈로그는 조직의 진실의 원천(system of record)을 지향하며, 카탈로그 구축 자체는 무료다.
• 데브포털은 특정 대상에게 공개하는 배포 채널이고, 카탈로그는 엔지니어링이 모든 것을 담는 시스템 오브 레코드다.
• 스코어카드로 API·서비스의 성숙도를 점수화해 거버넌스와 개선 목표를 세울 수 있다.

쉽게 이해하기

Kong의 제이슨과 미코가 Konnect의 새로운 방향을 설명했다. 핵심은 사람들이 흔히 한 호흡에 말하는 "API와 서비스"가 사실 서로 다른 개념이라는 점이다. 하나의 API가 큰 서비스의 일부만 소비할 수도 있고, 반대로 하나의 API가 여러 서비스를 대표할 수도 있으며, 이벤트 기반 구조에서는 토픽을 생산·소비하는 워커가 서비스가 되기도 한다.

더 근본적인 차이는 이렇다. API는 설계 우선(design-first)·스펙 우선 환경에서 코드 한 줄 없이 제안된 설계일 수 있다. 반면 서비스는 언제나 실행 중인 애플리케이션이라 건강 상태와 운영을 챙겨야 한다. 그래서 서비스는 엔지니어링이 관리하는 헤드리스 자산이고, API는 "모두가 알아야 하고 일부가 소비하는" 대상이다. 플랫폼처럼 사고한다면 회사의 모든 구성원이 어떤 API가 존재하는지 알 수 있어야 한다.

이 관점에서 Konnect는 상단 메뉴를 바꿨다. 예전의 "서비스 카탈로그"가 "카탈로그"로 바뀌었고, 데브포털 아래 있던 API와 서비스가 이제 카탈로그 아래 함께 놓인다. 데브포털에는 여전히 API가 있지만, 그것은 특정 대상에게 게시(publish)한 것들뿐이다.

앞으로의 초점도 제시됐다. 서비스 객체에 커스텀 속성 부여, 서비스와 API의 직접 연결, GitHub·Datadog·PagerDuty 같은 서드파티와의 커스텀 통합, 그리고 GitHub를 API의 진실의 원천으로 여기는 고객을 위한 코드 저장소 연동이다. 이 모든 카탈로그 기능은 무료이며, 포털에 게시하거나 스코어카드로 거버넌스를 적용하는 시점부터 비용이 발생한다.

데브포털과 카탈로그의 역할도 정리됐다. 데브포털은 브랜딩과 가이드를 갖춰 내부 또는 파트너·고객이라는 특정 대상에게 API를 공개하는 채널이다. 카탈로그는 운영 상태와 소유자 정보까지 포함해 모든 것을 담는 엔지니어링 중심 공간으로, 여기서 섀도우·좀비 API를 찾아내고 스코어카드로 성숙도를 점수화해 개선 목표를 세운다.

주요 인사이트

• API ≠ 서비스: API는 구현 전 설계 제안일 수 있고, 서비스는 반드시 운영·관리해야 하는 실행 중 애플리케이션이다.
• 대상(audience) 중심 설계: 서비스는 엔지니어링이 돌보는 헤드리스 자산, API는 조직 전체가 학습하고 일부가 소비하는 자산이라는 점이 도구 분리의 근거다.
• 벤더 중립 진실의 원천: 카탈로그는 AWS·GitHub·Apigee 등 어디에 API가 있든 모아 검색·필터링하게 하며, Kong 게이트웨이 사용을 강제하지 않는다.
• 무료 카탈로그, 유료 게시·거버넌스: 카탈로그 구축은 무료이고, 포털 게시나 스코어카드 기반 거버넌스를 쓸 때만 과금된다.
• 거버넌스는 점수로: 스코어카드로 "지금 3점 → 3.5~4점" 같은 성숙도 목표를 세우고, 예컨대 인시던트 5분 내 확인 비율 같은 모범 사례 준수를 관리한다.

자주 묻는 질문

관련 AI 소식