Deploy prebuilt samples
Before you begin
-
If you’re new to Kalix, create an account so you can try it out for free.
-
Install the Kalix CLI.
Deploy one of the samples
Kalix has several ready made sample applications for you to try out! In the table below you can see the available samples and the container image URL you’ll need if you want to deploy that sample. Clicking on the language will take you to the GitHub repository with the source code.
Sample | Container image URL |
---|---|
A shopping cart based on a Value Entity (Key/Value store) |
Java: |
Java/Protobuf: |
|
A shopping cart based on an Event Sourced Entity |
Java: |
Java/Protobuf: |
- CLI
-
-
Log into your account:
kalix auth login
-
Choose the sample you want to deploy from the above table and run:
kalix services deploy <name> <Container image URL from above table>
-
To get an HTTP endpoint and enable CORS run:
kalix services expose <name> --enable-cors
-
Invoke your service
Once the service has started successfully, start a proxy locally to invoke the service:
kalix service proxy <service name> --grpcui
The --grpcui
option also starts and opens a gRPC web UI for exploring and invoking the service (available at http://127.0.0.1:8080/ui/).
Alternatively, command line clients such as grpcurl
or curl
can be used to invoke the service through the proxy at localhost:8080
, using plaintext connections.
Next steps
-
Try building and deploying your own Quickstart application in the programming language of your choice.