# 버전 역사

Keycloak는 2014년 초반 베타 버전(1.0.0.Beta)을 시작으로 꾸준히 발전해 왔다. 첫 공식 안정 버전(1.0 Final)은 2015년에 공개되었으며, 이후 2.x, 3.x, 4.x 등 메이저 버전을 거듭하면서 엔터프라이즈 환경에서의 운영 편의성과 보안 기능을 대폭 강화했다. 특히 17.x 버전부터는 Quarkus 기반의 새로운 아키텍처가 도입되어 퍼포먼스와 확장성 면에서 큰 전환점이 되었다.

버전별로 살펴보면 다음과 같은 특징을 갖는다.

* **1.x 시리즈 (2014\~2015)**
  * 2014년 공개된 베타 버전(1.0.0.Beta)을 시작으로, 2015년에 처음으로 1.0 Final 발표
  * 초기 사용자 인증/인가 기능과 관리 콘솔의 기반을 확립
* **2.x \~ 3.x 시리즈 (2016\~2017)**
  * Social Login(소셜 로그인), Identity Brokering 등 다양한 연결 기능 강화
  * OIDC(OpenID Connect)와 SAML 프로토콜 지원이 안정화
* **4.x \~ 6.x 시리즈 (2018\~2019)**
  * 클라우드 환경에서의 컨테이너 운용(특히 Docker, Kubernetes) 지원 확대
  * 사용자 연동 API 확장 및 UI/UX 개선
* **7.x \~ 9.x 시리즈 (2019\~2020)**
  * 국제화(i18n) 기능 및 인증 플로우 커스터마이징 기능 개선
  * Admin Console 레이아웃 일부 개편
* **10.x \~ 16.x 시리즈 (2020\~2022)**
  * 인증 플로우의 세분화 및 인증 계정 관리 기능 강화
  * Kubernetes Operator, Helm Chart 등 클라우드 네이티브 운영을 위한 배포 옵션 추가
* **17.x 이후(2022\~)**
  * Quarkus 기반의 런타임 도입
  * WildFly 기반 Legacy 배포와 Quarkus 기반 배포가 공존하나, 점차 Quarkus가 기본으로 전환
  * 성능과 확장성 향상, 클라우드 네이티브 환경에서의 최적화

{% @mermaid/diagram content="timeline
title Keycloak 주요 버전 릴리스
dateFormat YYYY-MM

```
2014-02 : "1.0.0.Beta 공개"
2015-06 : "1.0 Final"
2016-07 : "2.x 시리즈"
2017-04 : "3.x 시리즈"
2018-02 : "4.x 시리즈"
2019-06 : "6.x 시리즈"
2020-02 : "9.x 시리즈"
2022-04 : "17.x (Quarkus 기반)"
2023-05 : "최신 20.x 이상 버전"" %}
```

위 타임라인은 메이저 버전 위주로 정리한 것으로, 실제 릴리스 주기는 Minor 및 마이크로 버전까지 포함하면 더 빈번하다. 릴리스 노트(Release Notes)와 마이그레이션 가이드는 매 버전에서 변경되는 기능이나 설정 가이드를 자세히 제공하므로, 실제 운영 환경 업그레이드 시에는 해당 문서를 반드시 참고해야 한다.