# DragonflyDB import { Tabs, TabsContent, TabsList, TabsTrigger } from "zudoku/ui/Tabs" {/* vale off */} {/* THIS FILE WAS AUTOGENERATED FROM THE PUBLIC EXAMPLE REPOSITORY. DO NOT EDIT THIS FILE DIRECTLY. */} This guide shows you how to deploy [Dragonfly](https://www.dragonflydb.io/), a simple, performant, and cost-efficient in-memory data store. To run this example, follow these steps: 1. Install the CLI. Use the [unikraft CLI](/cli/unikraft) or the legacy [kraft CLI](https://unikraft.org/docs/cli/install). You need a [BuildKit](https://github.com/moby/buildkit) builder. The easiest way to get one is via [Docker](https://docs.docker.com/engine/install/). Alternatively, you can also directly set up and use BuildKit, see the [quick start](https://github.com/moby/buildkit#quick-start). :::note 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](https://github.com/unikraft-cloud/examples) and `cd` into the `examples/dragonflydb/` directory: ```bash git clone https://github.com/unikraft-cloud/examples cd examples/dragonflydb/ ``` Make sure to log into Unikraft Cloud and pick a [metro](/platform/metros) close to you. This guide uses `fra` (Frankfurt, 🇩🇪): ```bash title="unikraft" unikraft login ``` ```bash title="kraft" # Set Unikraft Cloud access token export UKC_TOKEN=token # Set metro to Frankfurt, DE export UKC_METRO=fra ``` When done, invoke the following command to deploy this app on Unikraft Cloud: ```bash title="unikraft" unikraft build . --output /dragonflydb:latest unikraft run --scale-to-zero policy=off --metro fra -p 443:6379/http+tls -m 512M --image /dragonflydb:latest ``` ```bash title="kraft" kraft cloud deploy --scale-to-zero off -p 443:6379/http+tls -M 512Mi . ``` The output shows the instance address and other details: ```ansi title="unikraft" metro: fra name: dragonflydb-10zgk uuid: 6282ef0c-2161-494c-a3f3-2d16055096c2 state: starting image: /dragonflydb resources: memory: 512MiB vcpus: 1 service: uuid: 18326b44-a571-6195-b9e6-9368832ff2b3 name: dry-moon-x6bgl6c0 domains: - fqdn: dry-moon-x6bgl6c0.fra.unikraft.app networks: - uuid: 87aa7a40-2a83-f315-b656-e07a8637af64 private-ip: 10.0.6.5 mac: 12:b0:8f:c2:51:55 timestamps: created: just now ``` ```ansi title="kraft" [●] Deployed successfully! │ ├───────── name: dragonflydb-10zgk ├───────── uuid: 6282ef0c-2161-494c-a3f3-2d16055096c2 ├──────── metro: https://api.fra.unikraft.cloud/v1 ├──────── state: starting ├─────── domain: https://dry-moon-x6bgl6c0.fra.unikraft.app ├──────── image: oci://unikraft.io//dragonflydb@sha256:21e6d3ff1f86292e14266bcf5c6e73d3b7a86a0ec4102c66a0961373af743f19 ├─────── memory: 512 MiB ├────── service: dry-moon-x6bgl6c0 ├─ private fqdn: dragonflydb-10zgk.internal └─── private ip: 10.0.6.5 ``` In this case, the instance name is `dragonflydb-10zgk` and the address is `https://dry-moon-x6bgl6c0.fra.unikraft.app`. They're different for each run. Use `curl` to query the Unikraft Cloud instance of Drangonfly. ```bash curl https://dry-moon-x6bgl6c0.fra.unikraft.app ``` ```html
Status:OK
Started on:1970-01-01T00:00:00
Uptime:474611:3:38
Render Latency:110 us
``` You can list information about the instance by running: ```bash title="unikraft" unikraft instances list ``` ```bash title="kraft" kraft cloud instance list ``` ```ansi title="unikraft" METRO NAME STATE IMAGE ARGS MEMORY VCPUS FQDN CREATED fra dragonflydb-10zgk running /dragonflydb 512MiB 1 dry-moon-x6bgl6c0.fra.unikraft.app 2 minutes ago ``` ```ansi title="kraft" NAME FQDN STATE STATUS IMAGE MEMORY VCPUS ARGS BOOT TIME dragonflydb-10zgk dry-moon-x6bgl6c0.fra.unikraft.app running 1 minute ago oci://unikraft.io//dragonflydb@sha256:... 512 MiB 1 28.74 ms ``` When done, you can remove the instance: ```bash title="unikraft" unikraft instances delete dragonflydb-10zgk ``` ```bash title="kraft" kraft cloud instance remove dragonflydb-10zgk ``` ## Customize your app To customize the app, update the files in the repository, listed below: * `Kraftfile`: the Unikraft Cloud specification, including command-line arguments * `Dockerfile`: In case you need to add files to your instance's rootfs ## Learn more Use the `--help` option for detailed information on using Unikraft Cloud: ```bash title="unikraft" unikraft --help ``` ```bash title="kraft" kraft cloud --help ``` Or visit the [CLI Reference](/cli/unikraft) or the [legacy CLI Reference](/cli/kraft/overview). {/* vale on */}