Zenn
🚀

Buf Schema Registry

2023/08/07に公開
protobuf
gRPC
bsr
tech

環境：Mac OS

https://buf.build/docs/introduction

Install the Buf CLI

brew install bufbuild/buf/buf

Clone the Git repository 

git clone https://github.com/bufbuild/buf-tour

gitを削除

rm -rf .git

ディレクトリを切り替える

cd start/getting-started-with-bsr

Log in to the BSR

Buf Schema Registryにログインします。

Create an API token

  1. buf.build/settings/user ページにアクセスします。
  2. Create New Token ボタンをクリックします。.
  3. 有効期限を選択します。オプションで、このトークンを他のトークンと区別するためのメモを追加することができます（CLI、Development、またはその他の名前を付けることをお勧めします）。
  4. Create をクリックします。.
  5. トークンをクリップボードにコピーします。このトークンは、このガイドの残りの部分で使用します。

buf registry login

ログインに必要なのは、上記で作成したAPIトークンだけです。以下のコマンドを実行してください

buf registry login

Output

Log in with your Buf Schema Registry username. If you don't have a username, create one at https://buf.build.

Username: <YOUR USERNAME>
Token: <YOUR TOKEN>

Push a module

Create a repository

  1. home page にアクセスします。
  2. 右上のユーザー名を選択します。
  3. ドロップダウンから Repositories をクリックします。
  4. Create repository をクリックします。
  5. リポジトリに名前をつけます。

Configure a name

ターミナルに戻り、proto ディレクトリに移動します。

cd proto

buf.yaml を更新し、 name が先程作成したリポジトリと一致するようにする

version: v1

name: buf.build/<YOUR USERNAME>/<YOUR REPOSITRY>

breaking:
  use:
    - FILE
lint:
  use:
    - DEFAULT

Push the module 

buf push

Discussion