Consul API Gateway v0.4.x 릴리즈 노트

Consul API Gateway v0.4.x 릴리즈 노트 (Consul API Gateway v0.4.x Release Notes)

이 버전은 Kubernetes Gateway API의 v0.5.0/v1beta1 지원과 URL 경로 접두사 재작성을 포함해요. 릴리즈 하이라이트, 변경 사항, 지원 소프트웨어, 알려진 이슈를 설명할게요.

출처: 문서

본문

릴리즈 하이라이트 (Release Highlights)

  • Kubernetes Gateway API 버전 0.5.0 및 v1beta1 API 지원: Kubernetes Gateway API의 v0.5.0 릴리즈는 일부 주요 API가 베타 API 버전(v1beta1)으로 성숙해졌다는 점에서 의미가 있습니다:
    • GatewayClass
    • Gateway
    • HTTPRoute
    • 다른 API(예: TCPRoute)는 여전히 v1alpha2 단계입니다. v1beta1 상태에 도달하면 사용자에게 더 큰 안정성과 이전 버전과의 호환성 요구 사항을 포함한 여러 이점이 있습니다. 기존 필드와 허용된 옵션은 API의 새 메이저 버전에서만 제거되거나 이름이 변경될 수 있습니다. API가 v1beta1 상태에 도달하면 향후 버전은 여러 이전 버전과의 호환성 요구 사항을 준수해야 합니다.
  • URL 경로 접두사 재작성 (URL Path Prefix Rewrite) 이 릴리즈는 HTTP 트래픽을 라우팅할 때 URL의 경로 접두사를 재작성하는 지원을 도입합니다. 이 기능을 사용하려면 HTTPRoute 구성에 URLRewrite 필터를 추가합니다. 이렇게 하면 게이트웨이가 요청을 서비스에 보내기 전에 클라이언트의 HTTP 요청에서 URL 경로를 재작성할 수 있습니다. 예를 들어 게이트웨이를 구성해 경로를 //store/checkout에서 //cart/checkout으로 변경할 수 있습니다. 추가 정보는 사용 문서를 참조하세요.

변경 사항 (What has Changed)

  • 참조 정책이 참조 승인으로 이름 변경 (Reference Policy Renamed to Reference Grant) Kubernetes Gateway API의 v0.5.0에서 ReferencePolicy가 ReferenceGrant로 이름이 변경되었습니다. 이 릴리즈는 둘 다 지원하지만 ReferencePolicy는 더 이상 권장되지 않으며 향후 표준 버전에서 제거될 것입니다. 이 버전의 Consul API Gateway로 업그레이드한 후 모든 기존 ReferencePolicy를 ReferenceGrant로 이름을 바꿔야 합니다. 추가 세부 정보는 업그레이드 지침을 참조하세요.

지원 소프트웨어 (Supported Software)

  • Consul 1.11.2+
  • HashiCorp Consul Helm 차트 0.47.1+
  • Kubernetes 1.21+
    • Kubernetes 1.24은 현재 지원되지 않습니다.
  • Kubectl 1.21+
  • Envoy 프록시 지원은 배포된 Consul 버전에 따라 결정됩니다. 자세한 내용은 Envoy 통합을 참조하세요.

Kubernetes Gateway API 사양 (Kubernetes Gateway API Specification)

지원되는 Gateway API 사양 버전: v0.5.0

업그레이드 (Upgrading)

업그레이드에 대한 자세한 정보는 업그레이드 페이지를 참조하세요.

알려진 이슈 (Known Issues)

v0.4.0 릴리즈에 존재하는 것으로 알려진 이슈는 다음과 같습니다:

  • 네임스페이스 미러링이 활성화되고 대상 네임스페이스가 존재하지 않으면 API Gateway 파드가 시작에 실패합니다. 자세한 내용은 GitHub 이슈 #248을 참조하세요.

변경 로그 (Changelogs)

이 메이저 릴리즈 버전과 모든 유지 관리 버전의 변경 로그는 아래에 나열되어 있습니다.

참고: 다음 링크는 GitHub 웹사이트의 변경 로그로 이동합니다.

더 알아보기 (Learn more)