Skip to main content

Getting Started with Zilla


Getting Started with Zilla

Zilla can validate API requests and message streams using your OpenAPI and AsyncAPI schemas. Zilla implements the OpenAPI and AsyncAPI schemas directly meaning there are little or no changes necessary to start serving you existing operations through Zilla. You can just drop in an existing OpenAPI/AsyncAPI specification and Zilla can seamlessly integrate with your current API management workflows and tooling.

You can see a working Petstore Demoopen in new window using OpenAPI/AsyncAPI schemas. Zilla can also define and proxy MQTT endpoints utilizing a pair of AsyncAPI schemas. Check out the Taxi Demoopen in new window to see a Zilla MQTT proxy defined using AsyncAPI, which is deployed Liveopen in new window using Kubernetes. We added an event-driven backend to the popular TodoMVC UI frontend in the TodoMVC CQRS Demoopen in new window where all of the new tasks will sync live to any open browsers.

Petstore Demoopen in new window | Taxi Demoopen in new window | TodoMVC CQRS Demoopen in new window

You can explicitly define your APIs in a Zilla configuration by carefully orchestrating all of the different Bindings Zilla has to offer. You can see many of them on display by using the Kafka Proxy Quickstart or checking out the Zilla Examplesopen in new window repo.

Kafka Proxy Quickstart | Zilla Examplesopen in new window

Homebrew

You can install Zilla using our homebrew tapopen in new window.

brew tap aklivity/tap
brew install zilla

Now you can run any zilla.yaml config.

zilla start -ve -c ./zilla.yaml

Docker

You can run your zilla.yaml config inside of a container. If you want to deploy on Kubernetes, you can use our helm chart.

docker run -v ./zilla.yaml:/etc/zilla/zilla.yaml ghcr.io/aklivity/zilla:latest start -ve

The zilla.yaml Config

The zilla.yaml config is declaratively configured to clearly define API mappings and endpoints that Zilla implements. This makes creating and managing your Zilla services easy.

Zilla config intro | bindings | guards | vaults | catalogs | telemetry

Zilla HTTP Proxy

The Zilla HTTP Kafka Proxy lets you configure application-centric REST APIs and SSE streams that unlock Kafka event-driven architectures.

Overview and Features | Simple CRUD API | Simple SSE Stream | Petstore Demoopen in new window

Zilla gRPC Proxy

The Zilla gRPC Kafka Proxy lets you implement gRPC service definitions from protobuf files to produce and consume messages via Kafka topics.

Overview and Features | Simple gRPC Server | Route Guide example

Zilla MQTT Proxy

The Zilla MQTT Kafka Proxy manages MQTT Pub/Sub connections and messages on and off of Kafka.

Overview and Features | Simple MQTT Broker | MQTT Kafka broker | Taxi Demoopen in new window

Zilla Plus

Everything in OSS plus commercial integrations and enterprise support. Partner-certified solutions for Confluent Cloud, Redpanda, and AWS MSK. Check out the Zillaopen in new window product page and find detailed instructions for each of our marketplace offerings below.

Amazon MSK Secure Public Access
This allows Kafka clients from outside the private network access to the full functionality of your Amazon MSK cluster.

Confluent Cloud Secure Public Access
This allows Confluent and Kafka clients from outside the private network access to the full functionality of your Confluent Cloud cluster.

Amazon MSK IoT Access and Control
Your Amazon cluster is turned into a fully-fledged MQTT broker.

Confluent Cloud IoT Access and Control
Your Confluent Cloud cluster is turned into a fully-fledged MQTT broker.

Redpanda IoT Access and Control
Your Redpanda cluster is turned into a fully-fledged MQTT broker.