The Fluvio CLI (command-line interface) is an all-in-one tool for setting up, interacting, and managing with Fluvio clusters.
Install the Fluvio CLI by running the following command:
$ curl -fsS https://packages.fluvio.io/v1/install.sh | bash
With CLI, you can create and manage fluvio clusters on Kubernetes. Before you can create a Fluvio cluster, you need to have a Kubernetes cluster up and running.
Either you can create a cluster on your local machine or you can deploy it to a cloud provider.
For installing on your local machine, here are suggested Kubernetes installation options:
After installing Kubernetes, you can run the following command to check if your Kubernetes cluster is up and running:
$ kubectl config current-context
k3d-fluvio
Some of Kubernetes installation will install kubectl and helm. You can check it by:
$ kubectl version
Client Version: version.Info{Major:"1", Minor:"21", GitVersion:"v1.21.3", GitCommit:"ca643a4d1f7bfe34773c74f79527be4afd95bf39", GitTreeState:"clean", BuildDate:"2021-07-15T21:04:39Z", GoVersion:"go1.16.6", Compiler:"gc", Platform:"linux/amd64"}
Server Version: version.Info{Major:"1", Minor:"21", GitVersion:"v1.21.2", GitCommit:"092fbfbf53427de67cac1e9fa54aaa09a28371d7", GitTreeState:"clean", BuildDate:"2021-06-16T12:53:14Z", GoVersion:"go1.16.5", Compiler:"gc", Platform:"linux/amd64"}
$ helm version
version.BuildInfo{Version:"v3.6.2", GitCommit:"ee407bdf364942bcb8e8c665f82e15aa28009b71", GitTreeState:"clean", GoVersion:"go1.16.5"}
If you didn’t install kubectl and helm, you can install them in the following way:
kubectl is the Kubernetes command-line tool. It is used to run commands against Kubernetes clusters.
Follow the instructions at the kubectl installation page and follow the instructions to download and install kubectl on Linux.
Helm is the package manager for Kubernetes.
Follow the instructions at the helm installation page and follow the instructions to download and install helm on Linux.
You can start a Fluvio cluster by running fluvio cluster start.
$ fluvio cluster start
📝 Running pre-flight checks
✅ Kubernetes config is loadable
✅ Supported helm version is installed
✅ Fixed: Missing Fluvio system charts.
✅ Previous fluvio installation not found
🛠️ Installing Fluvio
✅ Fluvio app chart has been installed
🔎 Found SC service addr: 172.19.0.2:30814
👤 Profile set
🤖 SPU group launched (1)
✅ All SPUs confirmed
🎯 Successfully installed Fluvio!
You can start a Fluvio cluster by running:
$ fluvio version
Release Channel : stable
Fluvio CLI : 0.10.0
Fluvio CLI SHA256 : c39222aacf9f0f5d60f9ae2c992f7cebe6729600c43fce433e624e13c09dec16
Fluvio channel frontend SHA256 : b77ef03027a73738747a6ccd64f1f423f474e828456b9e462e6273dc330a0201
Fluvio Platform : 0.10.0 (k3d-fluvio)
Git Commit : a948a2fca7d2e306789df8bf85d8de5042fce0d7
OS Details : Ubuntu 20.04 (kernel 5.15.0-1022-azure)
=== Plugin Versions ===
Fluvio Runner (fluvio-run) : 0.0.0
Infinyon Cloud CLI (fluvio-cloud) : 0.2.4
Congratulations, you’ve successfully installed Fluvio on your local machine!
Let’s use the Fluvio CLI to play with some basic functionality.
The first thing we need to do is create a topic.
$ fluvio topic create greetings
topic "greetings" created
Now that we have a topic, we can produce some messages!
Use the following command to send a message to the greetings topic:
$ echo "Hello, Fluvio" | fluvio produce greetings
Finally, we can consume messages back from the topic
$ fluvio consume greetings -B -d
Consuming records from the beginning of topic 'greetings'
Hello, Fluvio
Way to go! You’re well on your way to writing real-time distributed apps with Fluvio!
If you run into any problems along the way, make sure to check out our troubleshooting page to find a fix.
