メインコンテンツまでスキップ

Momento Serverless Cache をはじめてみる

SDK または CLI を使って Momento Serverless Cache をすぐに使い始める方法をお探しでしたら、ここから始めましょう。ソフトウェアのインストールを全くせずにMomento をすぐに体験してみたいですか?でしたら、ブラウザを使ってここからすぐに始められます。もしくは、既に開発環境を整えてMomento を使ったアプリケーションを使い始める準備ができている場合は、以下のシンプルな手順に従って下さい。

CLI とSDK をブラウザ上で試してみる

ブラウザ上で、今すぐにMomento Serverless Cache を試してみることができます。何もソフトウェアをインストールする必要がありません!

注記

Momento Serverless Cache はAPI ベースのサーバーレスサービスです。皆さんの(AWS、GCP、Azure、等)のアカウントには何もデプロイしません。


まずはじめに、無料の認証トークンを作成し、キャッシュを作成し、そのキャッシュ上でsetget コマンドを実行してみましょう。以下を起動します。

CLI lab



続いて、Node.js SDK を使ったJavaScript のアプリケーションを動かして、認証トークンと今作成したキャッシュを使ってみましょう。以下を起動します。

SDK lab



Momento command line interface (CLI) をインストールする

ブラウザ上で実行するのではなく自身のマシン上で CLI を実行してみたい場合には、こちらに沿って各オペレーティングシステムごとの 方法でインストールしてください:

macOS では Homebrewを利用

brew tap momentohq/tap
brew install momento-cli

Linux

最新の GitHub release のウェブページに行って下さい。 そこに、x86_64 とaarch64 向けの.deb.rpm があります。

.deb ファイルは新し目のUbuntu とDebian のバージョンでテストされています。 .rpm ファイルは新し目のRHEL、Amazon Linux 2、Rocky Linux、そしてCentOS でテストされています。

もしこれらのパッケージに何か問題があれば、issue を作成して私たちにお知らせ下さい。

また、x86_64 とaarch64 それぞれにtarball も提供しています。これは momento コマンドのバイナリを含んでいて、それを実行パス上の好きなところに追加してお使いになれます。

Windows

私たちのCLI はWindows Package Manager (winget) から利用可能です。インストールするには、以下のコマンドをPowerShell かコマンドプロンプトから実行します:

winget install momento.cli

または、最新のGitHub release のウェブページに行って下さい。 そこに、Windows 用の.msi インストーラーと、手動でmomento 実行可能ファイルを好きな場所に配置したい方向けのWindows 用の.zip ファイルがあります。

もしWindows のパッケージに何か問題があれば、issue を作成して私たちにお知らせ下さい。

CLI が正しくインストールされたかを確認するには、ヘルプコマンドを実行してみます:

$ momento -h  
CLI for Momento APIs

Usage: momento [OPTIONS] <COMMAND>

Commands:
cache Interact with caches
configure Configure credentials
account Manage accounts
signing-key Manage signing keys
help Print this message or the help of the given subcommand(s)

Options:
--verbose Log more information
-p, --profile <PROFILE> User profile [default: default]
-h, --help Print help
-V, --version Print version

認証トークンを取得する

Momento における認証は認証トークンによって行われ、コマンドラインを使って直接 Momento Serverless Cache にサインアップすることもできます。

認証トークンは Momento Serverless Cache の各クラウドプロバイダーとリージョンに紐づいています。account コマンドをご希望のクラウドプロバイダーとリージョンを指定しながら使うと、各リージョン用の認証トークンを生成することができます:

AWS [利用可能リージョンは us-west-2, us-east-1, ap-northeast-1, ap-south-1]

momento account signup aws --email <TYPE_YOUR_EMAIL_HERE> --region <TYPE_DESIRED_REGION>

GCP [利用可能リージョンは us-east1, asia-northeast1]

momento account signup gcp --email <TYPE_YOUR_EMAIL_HERE> --region <TYPE_DESIRED_REGION>

Azure (まもなく対応) もしご興味があればお問い合わせ下さい

momento account signup azure --email <TYPE_YOUR_EMAIL_HERE> --region <TYPE_DESIRED_REGION>

<TYPE_YOUR_EMAIL_HERE><TYPE_DESIRED_REGION> を実際の値に置き換えるのを忘れない様にしてください。

注: もしお使いのクラウドプロバイダーで使いたいリージョンが利用可能でない場合は、それを追加することに関してぜひ私たちにお問い合わせください

読み書き操作のために、Momento CLI を設定する

Momento から認証トークンが E メールで送られてきます。そうしたら、momento configure コマンドを使って、ローカルの CLI がそのトークンを使うように設定することができます:

$ momento configure
Token: // < Enter token from email here.
Default Cache [default-cache]: my-first-cache // Name of cache to use on CLI by default.
Default TTL Seconds [600]: 30 // Sets the default TTL for cache entries. For demostration purposes we are setting this lower right now.
[2022-03-31T15:31:25Z INFO momento::commands::cache::cache_cli] creating cache...
[2022-03-31T15:31:33Z INFO momento::commands::configure::configure_cli] default cache successfully created

これでもうあなたの Momento Serverless Cache は稼働しています!続いて、Momento Serverless Cache にデータをキャッシュするためにどうやって Momento CLI を使うかを見ていきましょう。

データをいくつかキャッシュしてみる

Momento CLI のcache コマンドは Momento Serverless Cache と対話するのに使われます。実際にいくつかのコマンドを見てみましょう。

まず、set サブコマンドを使ってデフォルトの Momento Serverless Cache にアイテムを 1 つ保存することができます:

$ momento cache set --key test --value value
[2022-03-31T15:45:17Z INFO momento::commands::cache::cache_cli] setting key: test into cache: my-first-cache
[2022-03-31T15:45:18Z INFO momento::commands::cache::cache_cli] set success

そうしたら、そのキーをget サブコマンドを使って取り出すことができます:

$ momento cache get --key test
[2022-03-31T15:45:25Z INFO momento::commands::cache::cache_cli] getting key: test from cache: my-first-cache
value

キャッシュを設定する際に、デフォルトの Time to Live (TTL) を 30 秒に設定しています。もし 30 秒待ってからキャッシュを取り出してみると、アイテムが消えているでしょう:

$ sleep 30 // wait for item to expire
$ momento cache get --key test
[2022-03-31T15:46:02Z INFO momento::commands::cache::cache_cli] getting key: test from cache: my-first-cache
[2022-03-31T15:46:03Z INFO momento::commands::cache::cache_cli] cache miss

これらが Momento CLI を使った標準的なgetsetデータプレーン操作になります。

また、Momento CLI を使ってコントロールプレーン操作、例えばキャッシュを作成したり、削除したり、利用可能なキャッシュ一覧を見たりすることもできます。

cache コマンドの利用可能な全てのサブコマンドは momento cache -h をターミナルで実行すると見ることができます:

$ momento cache -h
Interact with caches

Usage: momento cache [OPTIONS] <COMMAND>

Commands:
create Create a cache
delete Delete a cache
list List all caches
set Store an item in a cache
get Get an item from the cache
help Print this message or the help of the given subcommand(s)

Options:
-e, --endpoint <ENDPOINT> An explicit hostname to use; for example, cell-us-east-1-1.prod.a.momentohq.com
--verbose Log more information
-p, --profile <PROFILE> User profile [default: default]
-h, --help Print help

さらに、デフォルトの設定値以外のコマンドオプション、例えば異なるリージョン、キャッシュ名、TTL などを指定することもできます。

サブコマンドの全てのパラメータについての詳しい情報は momento cache $SUBCOMMAND --help を実行して学ぶことができます。

次のステップ

CLI はMomento Serverless Cache API の基本を試して理解するには良いですが、ほとんどのキャッシュの仕事はアプリケーション上で行われます。それらには、Momento SDK を使うことができます。

現在、以下の言語で SDK が利用可能です。各レポジトリを確認して、詳細な手順と利用例をご確認ください。

よくある質問

Momento は何かのリソースを私のクラウドアカウント上にデプロイしますか?
いいえ、しません。Momento Serverless Cache はAPI ベースのサーバーレスサービスで、皆さんのアプリケーションのコードから呼び出します。