2022-04-26 03:59:18 +00:00
|
|
|
---
|
|
|
|
layout: docs
|
|
|
|
page_title: 0.1.x
|
|
|
|
description: >-
|
|
|
|
Consul API Gateway release notes for version 0.1.x
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
# Consul API Gateway 0.1.0
|
|
|
|
|
2022-08-26 20:37:41 +00:00
|
|
|
## Overview
|
2022-04-26 03:59:18 +00:00
|
|
|
|
2022-04-26 20:14:10 +00:00
|
|
|
This is the first general availability (GA) release of Consul API Gateway. It
|
|
|
|
provides controlled access for network traffic from outside a Consul service
|
|
|
|
mesh to Services on the mesh
|
2022-04-26 03:59:18 +00:00
|
|
|
|
2022-04-26 20:14:10 +00:00
|
|
|
You can use API Gateway in Kubernetes deployments as an alternative to Consul's ingress
|
|
|
|
gateway functionality. It provides additional capabilities that ingress gateway does not. These include:
|
2022-04-26 03:59:18 +00:00
|
|
|
|
|
|
|
1. It allows you to configure and deploy new gateways at any time, without
|
|
|
|
rerunning the Consul Helm chart. The configuration of a running gateway can
|
2023-07-31 17:56:09 +00:00
|
|
|
be changed dynamically at anytime, usually without disrupting any the
|
2022-04-26 03:59:18 +00:00
|
|
|
traffic flowing through it.
|
|
|
|
1. Listeners on a gateway can use TLS server certificates signed by any
|
2022-04-26 20:14:10 +00:00
|
|
|
certificate authority (CA). This allows you to use certificates from public
|
|
|
|
CA's, such as Verisign and Let's Encrypt, and private CA's, such as a company's
|
2022-04-26 03:59:18 +00:00
|
|
|
internal CA.
|
|
|
|
|
|
|
|
## Release Highlights
|
2022-04-27 18:44:39 +00:00
|
|
|
|
2022-04-26 20:14:10 +00:00
|
|
|
This release includes the following features and capabilities:
|
2022-04-26 03:59:18 +00:00
|
|
|
|
2022-04-26 20:14:10 +00:00
|
|
|
1. Can be deployed in the following run time environments:
|
2022-04-27 18:44:39 +00:00
|
|
|
- Self-managed Kubernetes
|
|
|
|
- AWS EKS
|
|
|
|
- Google GKE
|
|
|
|
- Azure AKS.
|
2022-04-26 03:59:18 +00:00
|
|
|
1. Install via the HashiCorp Consul Helm chart.
|
2024-05-01 16:09:08 +00:00
|
|
|
1. Works with self-managed Consul Enterprise servers and HCP Consul Dedicated servers
|
2022-04-26 03:59:18 +00:00
|
|
|
1. Configure via Kubernetes Gateway API - v1alpha2
|
|
|
|
1. Deploy 1 or more logical API Gateways per Kubernetes cluster
|
2022-04-26 20:14:10 +00:00
|
|
|
1. Support for HTTP, HTTPS, TCP, and TCP+TLS
|
|
|
|
1. Support for HTTP versions 1.1 and 2
|
2022-09-14 22:45:42 +00:00
|
|
|
1. Load balance across a service's instances
|
2022-04-26 20:14:10 +00:00
|
|
|
1. Listeners load TLS certificates, signed by any CA, from Kubernetes secret storage
|
2022-04-26 03:59:18 +00:00
|
|
|
1. Route HTTP/S traffic to Services based on matching:
|
|
|
|
- Hostname
|
|
|
|
- URI Path
|
|
|
|
- HTTP Header
|
|
|
|
- HTTP Method
|
|
|
|
- HTTP Query parameters
|
2022-04-27 18:44:39 +00:00
|
|
|
1. HTTP header manipulation:
|
2022-04-26 03:59:18 +00:00
|
|
|
- Set header value
|
|
|
|
- Add header and/or value
|
|
|
|
- Remove header and/or value
|
2022-04-26 20:14:10 +00:00
|
|
|
1. TLS settings configurable per Kubernetes Listener:
|
2022-04-26 03:59:18 +00:00
|
|
|
- Set minimum allowed TLS version
|
2022-04-26 20:14:10 +00:00
|
|
|
- Enabled cipher-suites (a.k.a. cipher string)
|
|
|
|
1. Route to services in different namespaces
|
|
|
|
1. Split traffic across multiple services based on weight
|
|
|
|
1. Support for multi-runtime service mesh deployments
|
|
|
|
- Consul API Gateway must be running on Kubernetes, but it can route
|
|
|
|
traffic to services running outside of K8s as long the service is connected to the Consul service mesh.
|
2022-04-26 03:59:18 +00:00
|
|
|
|
2022-04-26 20:14:10 +00:00
|
|
|
## Supported Software
|
2022-04-26 03:59:18 +00:00
|
|
|
|
2022-04-26 20:14:10 +00:00
|
|
|
- Consul 1.11.2+
|
|
|
|
- HashiCorp Consul Helm chart 0.41.1+
|
|
|
|
- Kubernetes 1.21+
|
|
|
|
- Kubectl 1.21+
|
2023-01-25 16:52:43 +00:00
|
|
|
- Envoy proxy support is determined by the Consul version deployed. Refer to [Envoy Integration](/consul/docs/connect/proxies/envoy) for details.
|
2022-04-26 03:59:18 +00:00
|
|
|
|
|
|
|
## Kubernetes Gateway API Specification
|
|
|
|
|
2022-06-21 15:37:19 +00:00
|
|
|
Supported version of the [Gateway API](https://gateway-api.sigs.k8s.io/) spec: `v1alpha2`(v0.4.1)
|
2022-04-26 03:59:18 +00:00
|
|
|
|
2023-01-25 16:52:43 +00:00
|
|
|
For more detailed information, please refer to the [product documentation](/consul/docs/api-gateway).
|