Using Kubernetes

✨

Beta Feature

We're actively testing and improving our Kubernetes integration. If you have any feedback, please contact us (opens in a new tab).

Apoxy can be integrated into Kubernetes via the APIService API to provide a Kubernetes-native experience. This allows you to use the kubectl CLI to manage your Proxies, Domains, and more.

Apoxy's APIs run as a Kubernetes extension API server (opens in a new tab) which enables standard Kubernetes tooling for managing Apoxy resources such as kubectl and the client-go (opens in a new tab) library (including Informers).

Install the CLI

curl -fsSL https://raw.githubusercontent.com/apoxy-dev/apoxy-cli/master/install.sh | bash

Authenticate

apoxy login

Deploy the Kubernetes Controller

apoxy k8s install

Output:

applied apoxy (core/v1, Kind=Namespace)
applied kube-controller (core/v1, Kind=ServiceAccount)
applied kube-controller (rbac.authorization.k8s.io/v1, Kind=ClusterRole)
applied kube-controller (rbac.authorization.k8s.io/v1, Kind=ClusterRoleBinding)
applied kube-controller (apps/v1, Kind=Deployment)
applied kube-controller (core/v1, Kind=Service)

Manage Apoxy Resources with kubectl

kubectl get proxies example -o yaml

Output:

apiVersion: core.apoxy.dev/v1alpha
kind: Proxy
metadata:
  creationTimestamp: "2024-01-18T00:12:04Z"
  finalizers:
  - proxy.core.apoxy.dev/finalizer
  labels:
    edge: example
  name: example
  resourceVersion: "3671"
  uid: ee12f121-67e6-48a2-921b-c10012b7c175
spec:
  addressRef:
    kind: Address
    name: example-wxln5
  configData: |
    admin:
      address:
        socket_address: { address: 127.0.0.1, port_value: 9901 }
        ...

🔨

Coming Soon

We're working on making our Kubernetes integration even better. Soon you'll be able to seamlessly integrate Apoxy Cloud Proxies with your Kubernetes endpoints and Ingress rules.

Reach out to us (opens in a new tab) if you'd like to join our closed beta.

Envoy Proxies→Magic Domains→