왜 API 버저닝 전략이 중요한가

Azure API Management

Fiodar Sazanavets

Senior Software Engineer at Microsoft

API 버저닝 소개

버저닝 소개

Azure API Management

API 버저닝 기본

버저닝 비유

  • 호환 불가 변경으로 이용자가 혼란스러울 때 사용

  • 새 노선을 만드는 동안 기존 노선을 계속 사용

  • 개정은 같은 노선의 유지보수 조정과 유사

    • 선로 수리, 표지 추가, 승차감 개선

  • APIM에서:

    • 버전은 버전 세트 내에 존재
    • 개정으로 편집·테스트하고 하나를 현재로 지정
Azure API Management

버전 표기

  • 지원되는 버전 표기 방식 3가지:
    • URL 경로에 버전 표시
    • 요청 헤더에 버전 지정
    • URL 쿼리 문자열에 버전 지정
  • 버저닝 전략은 일관되어야 함

URL 경로 버저닝

헤더 버저닝

쿼리 문자열 버저닝

Azure API Management

버전 vs 개정

버전 vs 개정

Azure API Management

카나리아 릴리스

카나리아 릴리스

  • 결과:
    • 피드백이 좋으면 -> 개정을 현재로 지정
    • 나쁘면 -> 이전 개정으로 롤백

  • 주방 테스트처럼: 새 레시피를 몇 테이블에만 먼저 제공

  • APIM에서:

    • 새 개정을 만들고 비공개로 테스트
    • 제한된 사용자에게 공개(파일럿 제품 또는 일부 호출자)
    • 개정 번호가 있는 특수 URL로 특정 개정을 타겟팅

  • 철도 비유: 테스터는 본선에 영향 없이 "유지보수 선로"를 이용

Azure API Management

핵심 개념 정리

  • 버전 vs 개정 사용 시점
  • 버전 체계 구성
  • 변경사항 롤포워드/롤백

API 관리

Azure API Management

연습해 봅시다!

Azure API Management

Preparing Video For Download...