3 min • read

Install manually

In this guide, we'll walk you through installing Ambassador Edge Stack in your Kubernetes cluster.

The manual install process does not allow for as much control over configuration as the Helm install method, so if you need more control over your Ambassador Edge Stack installation, it is recommended that you use helm.

Before you begin

Ambassador Edge Stack is designed to run in Kubernetes for production. The most essential requirements are:

  • Kubernetes 1.11 or later
  • The kubectl command-line tool

Install with YAML

Ambassador Edge Stack is typically deployed to Kubernetes from the command line. If you don't have Kubernetes, you should use our Docker image to deploy Ambassador Edge Stack locally.

  1. In your terminal, run the following command:

    shell
    kubectl create namespace ambassador || true
    kubectl apply -f https://app.getambassador.io/yaml/edge-stack/3.0.0/aes-crds.yaml && \
    kubectl apply -f https://app.getambassador.io/yaml/edge-stack/3.0.0/aes.yaml && \
    kubectl -n ambassador wait --for condition=available --timeout=90s deploy edge-stack
  2. Determine the IP address or hostname of your cluster by running the following command:

    shell
    kubectl get -n ambassador service edge-stack -o "go-template={{range .status.loadBalancer.ingress}}{{or .ip .hostname}}{{end}}"

    Your load balancer may take several minutes to provision your IP address. Repeat the provided command until you get an IP address.

  3. Next Steps

    Ambassador Edge Stack shold now be successfully installed and running, but in order to get started deploying Services and test routing to them you need to configure a few more resources.

Upgrading an existing installation

See the migration matrix for instructions about upgrading Ambassador Edge Stack.