Fluvio provides support for multiple profiles out of the box, meaning that you can
communicate with distinct clusters in an isolated and managed way. A profile is a
collection of settings and credentials that are applied to a Fluvio session. Each profile
defines the means to communicate with a particular Fluvio cluster. One profile
is active (or “current”) at any given time, and all other Fluvio commands will
interact with the cluster defined by the active profile. Profiles are defined
in the Fluvio configuration file at ~/.fluvio/config
, and the fluvio profile
family of commands is used to view and manipulate profiles.
Prints out the name of the active Fluvio profile. Let’s say you have a Fluvio Cloud account whose profile name is “cloud”, and you have a local Fluvio cluster installed that you use for development, whose profile name is “local”.
If your current profile is “local”, then a command such as fluvio topic create greeting
will
create a “greeting” topic on your local cluster.
fluvio-profile-current
Print the name of the current context
USAGE:
fluvio profile current
FLAGS:
-h, --help Prints help information
Example usage:
$ fluvio profile current
local
Deletes a profile from your Fluvio configuration (~/.fluvio/config
). This will
not delete a cluster (for that, see fluvio cluster delete
), but it will cause
the Fluvio CLI to no longer be able to interact with that cluster.
fluvio-profile-delete
Delete the named profile
USAGE:
fluvio profile delete <profile name>
FLAGS:
-h, --help Prints help information
ARGS:
<profile name>
Example usage:
$ fluvio profile delete local
profile local deleted
If you try to delete the current profile, you will get a warning, because other CLI commands depend on having a current profile being set.
$ fluvio profile delete local
profile local deleted
warning: this removed your current profile, use 'fluvio profile switch' to select a different one
Deletes cluster connection information from your Fluvio configuration. This will not delete
a cluster itself (for that see fluvio cluster delete
), but it will cause the Fluvio CLI to
no longer be able to connect to that cluster.
fluvio-profile-delete-cluster
Delete the named cluster
USAGE:
fluvio profile delete-cluster [FLAGS] <cluster name>
FLAGS:
-f, --force Deletes a cluster even if its active
-h, --help Prints help information
ARGS:
<cluster name> The name of a cluster connection to delete
Example usage:
$ fluvio profile delete-cluster local
Cluster local deleted
This switches the “current” profile. After switching current profiles, all subsequent Fluvio CLI commands that interact with a cluster will target the cluster of the new “current” profile.
fluvio-profile-switch
Switch to the named profile
USAGE:
fluvio profile switch <profile name>
FLAGS:
-h, --help Prints help information
ARGS:
<profile name>
Example usage:
$ fluvio profile switch cloud
Prints a table of your profiles, including the address of the associated cluster and which profile is active.
fluvio-profile-list
Display all Fluvio profiles
USAGE:
fluvio profile list
FLAGS:
-h, --help Prints help information
OPTIONS:
-O, --output <type> Output [default: table] [possible values: table,
yaml, json]
Example usage:
$ fluvio profile list
PROFILE CLUSTER ADDRESS TLS
* minikube minikube 10.99.16.213:9003 Disabled
local local localhost:9003 Disabled