Edge Stack

gravitee-io/ee/edge-stack

Ambassador Edge Stack API gateway

Deploys Ambassador Edge Stack, a Kubernetes-native API gateway built on Envoy Proxy, into a local Kind cluster.

Install gck#

go install github.com/gravitee-io-labs/gck@latest

For other installation methods, see Installation .

Usage#

Create#

gck create --from gravitee-io/ee/edge-stack

Cleanup#

gck delete

Quick Start#

Edge Stack is available at http://localhost:30080 (HTTP) and https://localhost:30443 (HTTPS).

To configure routing, create Mapping resources in the ambassador namespace. For a guided walkthrough, see the Edge Stack getting started tutorial .

License#

This is an Enterprise Edition (EE) context. Place your Edge Stack license at $HOME/opt/gravitee/edge-stack/license.jwt and gck will automatically mount it into the cluster as the ambassador-edge-stack Secret. If the file is missing, the license component is silently skipped (onMissing: ignore).

To use a different path, override it in your gck.yaml:

components:
  - name: license
    k8s:
      secrets:
        - name: ambassador-edge-stack
          entries:
            - key: license-key
              fromFile: '/custom/path/to/license.jwt'

Composition chain

This context is composed from the following base contexts:

redis/standalone

gravitee-io/ee/edge-stack

Endpoints

Services this context exposes on your machine after gck create, including the ones it inherits from the contexts it composes. Rows marked with a flag only exist when you pass it.

Service	URL	From
Redis	`localhost:30379`	`redis/standalone`
Edge Stack HTTP	`http://localhost:30080`	`gravitee-io/ee/edge-stack`
Edge Stack HTTPS	`https://localhost:30443`	`gravitee-io/ee/edge-stack`

Variables

Template variables overridable with --set. Use --set path.segments.var=value to target a specific context in the composition chain.

Variable	Default	Origin	Description
`clusterName`	`gravitee`	`gravitee-io/ee/edge-stack`	Name of the Kind cluster
`imageRepository`	`docker.io/datawire/aes`	`gravitee-io/ee/edge-stack`	Ambassador Edge Stack Docker image repository
`imageTag`	`3.12.7`	`gravitee-io/ee/edge-stack`	Ambassador Edge Stack Docker image tag