One of the primary goals of Upstash is to enable every developer to create Upstash resources easily using various tools. In the past, we have announced Developer Api, Terraform Provider, and now it is time for Upstash CLI.
Announcing @upstash/cli
We are thrilled to announce Upstash command-line tool so that every developer can create their Upstash resources with a single command.
It is available on GitHub, npm or built binaries
Get started
Upstash CLI requires a developer api key. A new api key can be created in the Console.
npm install -g @upstash/cliOr visit the GitHub release page for prebuilt binaries.
After installing, execute the following command to log in. It will ask for your email and api key:
upstash auth loginThat's all. You are now logged in and can manage your Upstash resources from the command line.
If you are unsure what a command does, use the --help flag, and it will explain all available commands and flags.
upstash redis --helpAll parameters can be given via CLI, but the CLI will ask you if a required parameter is missing.
Creating Resources
Creating Redis Database
upstash redis create --name=cli-powered-db --region=eu-central-1You only need to provide the name of your database and region. Other optional flags can be provided like tls, multizone, etc.
Creating Kafka Cluster
upstash kafka create --name=$name --region=$regionSimilar to redis, kafka resources requires 2 parameters name and region. After creating a region, a topic can be created.
upstash kafka topic create --name=mytopic --cluster-id=$idOther Commands
Upstash CLI includes many different commands to perform CRUD operations on your Upstash Resources.
- Team: This allows you to manage teams and their members
upstash team- Redis: Create/edit/delete redis databases
upstash redis- Kafka: Create/edit/delete kafka clusters and topics
upstash kafka cluster
upstash kafka topicClosing words
If you have any questions, please reach out to us on GitHub or the channels below.