Skip to content

Latest commit

 

History

History
137 lines (91 loc) · 4.46 KB

README.md

File metadata and controls

137 lines (91 loc) · 4.46 KB

Momento CLI

Japanese: 日本語 Portuguese: Português

Command-line tool for managing Momento Serverless Cache. Supports the following:

Prerequisites

First things first - go to the Momento Console to sign up. Generate an auth token to use with the CLI in the tokens tab.

This token uniquely identifies cache interactions. The token should be treated like a sensitive password and all essential care must be taken to ensure its secrecy. We recommend that you store this token in a secret vault like AWS Secrets Manager. See the docs for more information on Momento auth tokens.

Installation

Mac (intel or apple silicon)

brew tap momentohq/tap
brew install momento-cli

Upgrading to a newer version

brew upgrade momento-cli

Linux

Visit the web page for the latest github release. There, you will find .deb and .rpm files for both x86_64 and aarch64.

.deb files have been tested on modern versions of Ubuntu and Debian. .rpm files have been tested on modern versions of RHEL, Amazon Linux 2, Rocky Linux, and CentOS.

If you have problems with any of these packages on your favorite platform, please file an issue and let us know!

We also provide tarballs for both x86_64 and aarch64; these contain the momento binary, which you may add anywhere you like in your execution path.

Windows

Our CLI is available in the Windows Package Manager (winget). To install, run the following from PowerShell or the Command Prompt:

winget install momento.cli

Alternatively visit the web page for the latest github release. There you will find an .msi installer for Windows platforms, as well as a windows .zip file if you prefer to manually copy the momento executable to your preferred location.

If you have problems with the windows packages please file an issue and let us know!

Tab Completion

We provide tab completion configuration for zsh and bash. For linux installs via deb/rpm, no additional shell configuration should be necessary if you already have zsh/bash tab completion enabled. For Homebrew, see https://docs.brew.sh/Shell-Completion

Quick Start

These instructions assume you have the momento executable on your path, after following the appropriate installation steps above.

# Configure your account with the auth token copied from the console
# plus default cache name (`default-cache`) and TTL (600 seconds)
# This will also create the cache `default-cache` in your account
momento configure --quick

# Set and Get values from your default cache, with default ttl
momento cache set key value
momento cache get key

# Make a different cache
momento cache create example-cache

# Set and Get values from a non-default cache with a different ttl
momento cache set key value --ttl 100 --cache example-cache
momento cache get key --cache example-cache

Configure

First time configuration

# default profile name is default
momento configure

This will prompt you for your Momento Auth Token, default cache name, default TTL, and save them to be reused as a part of your default profile.

momento configure --profile new-profile

This will prompt you the same as above and save them to be reused as a part of your new-profile profile.


Update existing configuration

To update your desired profile, use the same command as above.

Use CLI

# use default profile
momento cache create example-cache
momento cache set key value --ttl 100 --cache example-cache
momento cache get key --cache example-cache

You can also specify your desired profile.

# use new-profile
momento cache create example-cache --profile new-profile
momento cache set key value --ttl 100 --cache example-cache --profile new-profile
momento cache get key --cache example-cache --profile new-profile

Use Momento in Your Project

Check out our SDKs to integrate Momento into your project!

Contributing

If you would like to contribute to the Momento Cli, please read out Contributing Guide