Developer

Documentation and guides for building high performance microservices and APIs

Get going with Kalix in 3 easy steps based on programming language of your choice

1Design your API and data model

Design your API

@EntityType("customer")
@EntityKey("customer_id")
@RequestMapping("/customer/{customer_id}")
public class CustomerEntity extends 
  ValueEntity<Customer> {

    @PostMapping("/changeAddress")
    public Effect<String> changeAddress(
      @RequestBody Address newAddress) {
      // ...
    }
}

Describe API endpoints and API data model. Expose your API as gRPC, REST or let it connect to a message broker.

Design your data

public record Customer(
  String email, String name, Address address) {

    public Customer withName(String newName) {
      return new Customer(email, newName, address);
    }

    public Customer withAddress(
      Address newAddress) {
        return new Customer(
          email, name, newAddress
        );
      }
}

Describe your domain data and choose your preferred durable storage model (key/value, event sourcing, or CRDTs).

2Implement your business logic

@PostMapping("/changeAddress")
public Effect<String> changeAddress(@RequestBody Address newAddress) {
  Customer updatedCustomer = currentState().withAddress(newAddress);
  return effects().updateState(updatedCustomer).thenReply("OK");
}

Kalix Maven plugin, based on the defined API, generates required resources for focusing only on implementing the business logic code.

NO CODE required for data persistence and query. The data is automatically injected into your service on an as-needed basis, and queries are consumed through live materialized views.

3Deploy


kalix service deploy customer-registry myrepo/customerregistry:latest

Kalix Maven plugin builds and publishes the image to an image repository of your choice and the Kalix CLI tool is used to deploy and manage your service on Kalix.

Kalix, as a fully managed runtime environment, removes a need for any operations and maintenance of the infrastructure and takes care of security, logging, monitoring, zero-downtime upgrades, and auto-scaling.

Getting Started Videos

Subscribe Follow

What is Kalix

This is the first video of this nine-part video series with an overview of What is Kalix?

Setting Up a Kalix Development Environment

Learn how to create an account, use the Kalix CLI and console, and look at some quickstart projects.

How to Create Kalix Java Development Projects

Java developers get an introduction to creating and developing Kalix projects.

Intro to Design and Implementation of Kalix Services

Here we dig into the design, development, testing, and managing of Kalix services.

Implementing Kalix Event Sourced Entities

See how easy it is to implement dynamic and effective event-sourced entity services in Java.

Implementing Kalix Key-Value Entities

The more CRUD-like key-value entities are similar to event-sourced entities, and they are also more familiar to most developers.

Implementing Kalix Views

Kalix views provide the flexibility of SQL queries of data created by event-sourced and key-value entities.

Implementing Kalix Actions

Actions are the glue that binds topics to entities, entities to entities, and much more.

Building Kalix Event-Driven Micro Stream Applications

Finally, we look at how entities, views, and actions, the core Kalix building blocks, are used to build Kalix micro stream/state stream applications.