Wranglerの使用 (コマンドラインインターフェース)

Cloudflare CLIであるWranglerを使用してPub/Subを管理する方法。

Wranglerは、Cloudflare Workers ↗、R2 StorageおよびCloudflare Pub/Subを含むCloudflareの開発者プラットフォームを構築および管理するためのコマンドラインツールです。

Wranglerの認証

WranglerをPub/Subで使用するには、Pub/Subの読み取りおよび書き込みの権限を持つAPIトークンが必要です。wrangler loginフローでは、Pub/Subの有効な権限を持つAPIトークンは発行されません。

Wranglerが使用できるAPIトークンを作成するには：

Cloudflareダッシュボード ↗にアクセスし、プロフィールアイコンをクリックしてマイプロフィールを選択します。
マイプロフィールの下で、APIトークンをクリックします。
APIトークン ↗ページで、トークンを作成をクリックします。
カスタムトークンを作成の隣にある始めるを選択します。
トークンに名前を付けます - 例：“Pub/Sub書き込みアクセス”
権限の見出しの下で、アカウントを選択し、最初のドロップダウンからPub/Subを選択し、権限として編集を選択します。
ページの下部で要約に進むをクリックし、_すべてのアカウント - Pub/Sub:編集_という権限が表示されることを確認します。
トークンを作成をクリックし、トークンの値をコピーします。

ターミナルで、Pub/Subトークンを使用してCLOUDFLARE_API_TOKEN環境変数を設定します。この変数が設定されていると、wranglerはCloudflare APIに対して認証に使用します。

export CLOUDFLARE_API_TOKEN="pasteyourtokenhere"

Pub/Subコマンド

Wranglerは、Pub/Subの設定を管理するための2つのコマンドグループを提供します：

wrangler pubsub namespace、これはブローカーがグループ化される名前空間を管理します。
wrangler pubsub broker、これは個々のブローカーを管理し、資格情報を発行および取り消し、Worker統合を更新します。

利用可能なwrangler pubsub namespaceサブコマンドには以下が含まれます：

wrangler pubsub namespace --help

Pub/Sub名前空間を管理する

コマンド:
  wrangler pubsub namespace create <name>    新しいPub/Sub名前空間を作成
  wrangler pubsub namespace list             既存のPub/Sub名前空間をリスト
  wrangler pubsub namespace delete <name>    Pub/Sub名前空間を削除
  wrangler pubsub namespace describe <name>  Pub/Sub名前空間を説明

利用可能なwrangler pubsub brokerサブコマンドには以下が含まれます：

wrangler pubsub broker --help

Pub/Subブローカーと対話する

コマンド:
  wrangler pubsub broker create <name>            新しいPub/Subブローカーを作成
  wrangler pubsub broker update <name>            既存のPub/Subブローカーの設定を更新
  wrangler pubsub broker list                     名前空間内のPub/Subブローカーをリスト
  wrangler pubsub broker delete <name>            既存のPub/Subブローカーを削除
  wrangler pubsub broker describe <name>          既存のPub/Subブローカーを説明
  wrangler pubsub broker issue <name>             特定のPub/Subブローカーの新しいクライアント資格情報を発行
  wrangler pubsub broker revoke <name>            指定されたブローカーに関連付けられたアクティブなクライアント資格情報のセットを取り消す
  wrangler pubsub broker unrevoke <name>          以前に取り消されたクライアント資格情報のセットへのアクセスを復元
  wrangler pubsub broker show-revocations <name>  以前に取り消されたすべてのクライアント資格情報を表示
  wrangler pubsub broker public-keys <name>       ブローカーの公開鍵を表示し、公開フックと資格情報の検証に使用

名前空間の作成

名前空間を作成するには：

wrangler pubsub namespace create NAMESPACE_NAME

ブローカーの作成

名前空間内にブローカーを作成するには：

wrangler pubsub broker create BROKER_NAME --namespace=NAMESPACE_NAME

認証トークンの発行

Wranglerを介してPub/Subブローカーのクライアント資格情報を直接発行できます。注意点：

トークンはブローカーごとにスコープされます
一度に複数のトークンを発行できます
トークンは現在、クライアントがブローカー上の_任意の_トピックに公開および/または購読することを許可します。

単一のトークンを発行するには：

wrangler pubsub broker issue BROKER_NAME --namespace=NAMESPACE_NAME

--number=<NUM>を使用して一度に複数のトークンを発行し、--expiration=<DURATION>を使用して発行されたトークンの有効期限を設定できます（例：4hまたは30d）。

トークンの取り消し

1つ以上のトークンを取り消すには—これにより、そのトークンが認証に使用されるのを即座に防ぎます—revokeサブコマンドを使用し、ユニークなトークンID（またはJTI）を渡します：

wrangler pubsub broker revoke BROKER_NAME --namespace=NAMESPACE_NAME --jti=JTI_ONE --jti=JTI_TWO

バグの報告

wrangler pubsub [...]コマンドのいずれかにバグを見つけた場合は、GitHubでバグを報告してください ↗、および使用しているwranglerのバージョンをwrangler --versionで含めてください。

Cloudflare Dashboard Discord Community Learning Center Support Portal

Cookie Settings