Copy page

Guides

Go and Redis HTTP Server

This guide explains how to create and deploy a Go app with a Redis database. To run this example, follow these steps:

1. Install the CLI. Use the unikraft CLI or the legacy kraft CLI. You need a BuildKit builder. The easiest way to get one is via Docker. Alternatively, you can also directly set up and use BuildKit, see the quick start.

   The unikraft CLI is the current standard, while kraft is the legacy version. Choose one of the CLIs below and only run the commands associated with it for the rest of this guide.

2. Clone the examples repository and cd into the examples/httpserver-go1.22-redis directory:

Code
git clone https://github.com/unikraft-cloud/examples
cd examples/httpserver-go1.22-redis/

Make sure to log into Unikraft Cloud and pick a metro close to you. This guide uses fra (Frankfurt, 🇩🇪):

Deploy Redis

First, deploy the Redis instance. Redis is an internal service (not publicly accessible), reached via the go122-redis.internal domain. The Redis password is set at runtime via the REDIS_PASSWORD environment variable (defaults to unikraft if not provided).

Make sure to replace <my-org> with your username / org-name.

The output shows the Redis instance details:

Deploy Go HTTP Server

Next, deploy the Go HTTP server. It connects to Redis using the REDIS_ADDR and REDIS_PASS environment variables:

The output shows the instance address and other details:

In this case, the instance names are httpserver-go-122-redis-db-2xc9u and httpserver-go-122-redis-app-bnnnc. They're different for each run.

To set a value in Redis via the Go server, use the URL from the fqdn field:

Code
curl -X POST -d "key=my-key" -d "value=my-value" https://<FQDN>

Code
Success!

You can then retrieve the value:

Code
curl https://<FQDN>/?key=my-key

Code
Key "my-key" has value "my-value"

You can list information about the instances by running:

Clean up

When done, remove the instances:

Learn more

Use the --help option for detailed information on using Unikraft Cloud:

Or visit the CLI Reference or the legacy CLI Reference.