Go to Qiita Advent Calendar 2024 Top
LoginSignup
3
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

@minarai(見習いさん)

GCP - Pub/Sub サービス構築チュートリアル

Last updated at Posted at 2020-05-19

GCP - Pub/Sub サービス概要からの続き
Pub/Sub サービスのセットアップ手順をまとめました。

サービスアカウント作成

まず初めに行いたいのがサービスアカウントの作成です。
サービスアカウントとはユーザーの代わりにシステムがGCP各サービスを利用するためのアカウントのこと。

アカウントの作成

今回はコンソール　サービスアカウントから作成をします。

ユーザー名 ロール1
minarai-pub-sub roles/pubsub.editor

POCなんでPub/SubのCRUD関連の権限までもたせてあります。
本番環境ではサービスアカウントに適切な権限だけを持たせたり、ポリシーを適用するなどして運用するのが正解だと思います。

サービスアカウントの鍵を作成

サービスアカウント一覧にminarai-pub-sub@****が表示されたら操作から**鍵を作成（json)**を選択すると鍵が生成されローカルPCにダウンロードされるので適切な場所に配置する

サービス実行アカウントを変更

作成したサービスアカウントをアクティブにする

  • 現在の設定一覧とアクティブなアカウントを確認する
% gcloud config configurations list
NAME     IS_ACTIVE  ACCOUNT                 PROJECT      COMPUTE_DEFAULT_ZONE  COMPUTE_DEFAULT_REGION
default  True       アカウント@gmail.com  プロジェクトID

# （省略化）　ついでにCOMPUTE_DEFAULT_ZONEも追加した
gcloud config set compute/region asia-northeast1
gcloud config set compute/zone asia-northeast1-a

# （省略化）　改めて確認
% gcloud config configurations list               
NAME     IS_ACTIVE  ACCOUNT                 PROJECT      COMPUTE_DEFAULT_ZONE  COMPUTE_DEFAULT_REGION
default  True       アカウント@gmail.com  プロジェクトID  asia-northeast1-a     asia-northeast1

構文： gcloud config configurations create NAME FLAG

% gcloud config configurations create minarai-pub-sub --activate
# アカウントを切り替えるとき
gcloud config configurations activate minarai-pub-sub

% gcloud config configurations list                                
NAME                IS_ACTIVE  ACCOUNT                 PROJECT      COMPUTE_DEFAULT_ZONE  COMPUTE_DEFAULT_REGION
default             False      アカウント@gmail.com  プロジェクトID  asia-northeast1-a     asia-northeast1
minarai-pub-sub     True

構文: gcloud config set core/project プロジェクトID
構文： gcloud config set core/account サービスアカウント
構文： gcloud　config set compute/region リージョン
構文： gcloud config set compute/zone ゾーン

% gcloud config set core/project プロジェクトID
% gcloud config set core/account サービスアカウント
% gcloud config set compute/region asia-northeast1
% gcloud config set compute/zone asia-northeast1-a

% gcloud config configurations list 
NAME                IS_ACTIVE  ACCOUNT                                                 PROJECT      COMPUTE_DEFAULT_ZONE  COMPUTE_DEFAULT_REGION
default             False      アカウント@gmail.com                                  プロジェクトID  asia-northeast1-a     asia-northeast1
minarai-app-engine  True       minarai-pub-sub@アカウント.iam.gserviceaccount.com  プロジェクトID  asia-northeast1-a     asia-northeast1
  • サービスアカウントの認証
% gcloud auth activate-service-account --key-file ~/Documents/gcp/key/pub-sub-key.json

エミュレータを使用したローカルでのアプリのテスト

アプリケーションをローカルで開発してテストするには、本番環境の Pub/Sub 環境のローカル エミュレーションを使用する Pub/Sub エミュレータを使用します。
Pub/Sub エミュレータは、gcloud コマンドライン ツールを使用して実行します。

エミュレータのインストール

コマンド プロンプトからエミュレータをインストールします。

% gcloud components install pubsub-emulator
% gcloud components update

エミュレータの開始

エミュレータを起動するには、コマンド プロンプトから pubsub start を実行します。
コマンドを実行する前に、PUBSUB_PROJECT_ID を Google Cloud プロジェクト ID に置き換えてください。 この場合、プロジェクト ID には任意の有効な文字列を指定できます。
Pub/Sub エミュレータがローカルで実行されるため、実際の Google Cloud プロジェクトを表す必要はありません。
オプションの一覧は、gcloud beta emulators pubsub start をご覧ください。

% gcloud beta emulators pubsub start --project=PUBSUB_PROJECT_ID [options]

環境変数の設定

エミュレータを起動した後、アプリケーションが Pub/Sub ではなくエミュレータに接続するように環境変数を設定する必要があります。これらの環境変数は、アプリケーションの実行に使用するマシンに設定します。

**エミュレータを起動するたびに、環境変数を設定する必要があります。**環境変数は、動的に割り当てられるポート番号に依存しています。この番号は、エミュレータを再起動するたびに変わる可能性があります。

環境変数の自動設定

アプリケーションとエミュレータが同じマシン上で動作している場合は、次のようにして環境変数を自動的に設定できます。

$(gcloud beta emulators pubsub env-init)

環境変数の手動設定 

# env-init コマンドを実行
gcloud beta emulators pubsub env-init

export PUBSUB_EMULATOR_HOST=localhost:8432
export PUBSUB_PROJECT_ID=my-project-id

Python App Engine スタンダード ローカル開発サーバーを使用している場合には、次のように環境変数をコマンドラインに渡す必要があります。

dev_appserver.py app.yaml --env_var PUBSUB_EMULATOR_HOST=${PUBSUB_EMULATOR_HOST}

エミュレータの使用

エミュレータでは Cloud Console および gcloud pubsub コマンドはサポートされていません。

実行手順

1） Pub/Sub サンプルアプリケーションをGitからpull

% git clone https://github.com/GoogleCloudPlatform/python-docs-samples
% cd python-docs-samples/pubsub/cloud-client

2） 必要なパッケージをインストール

% python3 -m venv pub-sub-env
% source pub-sub-env//bin/activate

% pip3 install -r requirements.txt

3） トピックを作成

% python publisher.py PUBSUB_PROJECT_ID create TOPIC_ID

4） （省略可）エミュレータで push サブスクリプションをテストするためのローカル push エンドポイントがない場合は、次の手順で http://localhost:3000/messages に作成

# JSON サーバーをインストール
npm install -g json-server
# JSON サーバーを起動
json-server --port 3000 --watch db.json
db.json
{
  "messages": []
}
  1. トピックへのサブスクリプションを作成
# pull サブスクリプションを作成
python subscriber.py PUBSUB_PROJECT_ID create TOPIC_ID SUBSCRIPTION_ID

# push サブスクリプションを作成
python subscriber.py PUBSUB_PROJECT_ID create-push TOPIC_ID SUBSCRIPTION_ID \
    PUSH_ENDPOINT
  1. トピックにメッセージをパブリッシュ
python publisher.py PUBSUB_PROJECT_ID publish TOPIC_ID
  1. ピックにパブリッシュされているメッセージを取得
python subscriber.py PUBSUB_PROJECT_ID receive SUBSCRIPTION_ID

# 取得結果の一例
{
      "messages": [
          {
              "subscription": "projects/PUBSUB_PROJECT_ID/subscriptions/SUBSCRIPTION_ID",
              "message": {
                  "data": "TWVzc2FnZSBudW1iZXIgMQ==",
                  "messageId": "10",
                  "attributes": {}
              },
              "id": 1
          },
          ...
      ]
    }

エミュレータの停止

エミュレータを停止するには、Ctrl+C キーを押します。
環境変数をアンセット

unset PUBSUB_EMULATOR_HOST

GCP - Pub/Sub サービスの利用へ続きます

3
4
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
3
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?