E2E(エンドツーエンド)コール¶
ここではiscp-pyを使用したE2Eコールのサンプルを示します。コントローラノードが対象ノードに対して指示を出し、対象ノードは受信完了のリプライを行う簡単なサンプルです。
環境¶
python 3.10
事前準備¶
本サンプルを動作させるための準備をします。 まず、コントローラ用のノードと対象用のノードを作成します。 そして環境に合わせて下記に示す値を環境変数としてセットします。
[1]:
import os
URL_API = os.getenv("URL_API", "http://localhost:8080")
TARGET_NODE_ID = os.getenv("TARGET_NODE_ID", "target-node-id")
TARGET_NODE_SECRET = os.getenv("TARGET_NODE_SECRET", "xxxxxxx")
CONTROLLER_NODE_ID = os.getenv("CONTROLLER_NODE_ID", "controller-node-id")
CONTROLLER_NODE_SECRET = os.getenv("CONTROLLER_NODE_SECRET", "xxxxxxx")
ADDRESS_WEBSOCKET = os.getenv("ADDRESS_WEBSOCKET", "localhost:8080")
アクセストークンの発行¶
コントローラ用のアクセストークンと、対象用のアクセストークンをそれぞれ発行します。
[2]:
import string
import requests
from oauthlib.oauth2 import BackendApplicationClient
from requests_oauthlib import OAuth2Session
_URL_TOKEN_ENDPOINT = f"{URL_API}/api/auth/oauth2/token"
def token_client_credentials(edge_id: str, secret: str) -> str:
"""
トークンの払い出しコード
"""
oauth = OAuth2Session(client=BackendApplicationClient(client_id=edge_id))
oauth.fetch_token(
token_url=_URL_TOKEN_ENDPOINT,
client_id=edge_id,
client_secret=secret,
include_client_id=True,
)
return oauth.token["access_token"]
[3]:
target_token=token_client_credentials(TARGET_NODE_ID, TARGET_NODE_SECRET)
[4]:
controller_token=token_client_credentials(CONTROLLER_NODE_ID, CONTROLLER_NODE_SECRET)
コントローラノードのコード定義¶
コントローラノードからメッセージを送信するサンプルです。 このサンプルでは文字列メッセージを対象ノードに対して送信し、対象ノードからのリプライを待ちます。
[5]:
import iscp
import asyncio
connected_target = asyncio.Event()
async def send():
async with await iscp.Conn.connect(ADDRESS_WEBSOCKET, iscp.WebSocketConnector(),
token_source=lambda: controller_token, node_id=CONTROLLER_NODE_ID
) as conn:
await connected_target.wait()
got = await conn.send_call_and_wait_reply_call(
iscp.UpstreamCall(
destination_node_id=TARGET_NODE_ID, name="greeting", type="string", payload=b"hello",
),
)
print(f"Received reply call: {got}")
対象ノードのコード定義¶
コントローラノードからのコールを受け付け、すぐにリプライをするサンプルです。
[6]:
import iscp
import json
import dataclasses
async def reply():
async with await iscp.Conn.connect(ADDRESS_WEBSOCKET, iscp.WebSocketConnector(),
token_source=lambda: target_token, node_id=TARGET_NODE_ID
) as conn:
connected_target.set()
call = await conn.calls().__anext__()
print(f"Received request call: {call}")
await conn.send_reply_call(
iscp.UpstreamReplyCall(
request_call_id=call.call_id,
destination_node_id=call.source_node_id,
name="reply_greeting",
type="string",
payload=b"world",
),
)
実行¶
[7]:
import asyncio
await asyncio.gather(reply(), send())
Received request call: DownstreamCall(call_id='892a9032-d0fd-4956-bef2-6cfdc211a786', source_node_id='3e6e8296-19fa-4561-9250-b16d80880ea2', name='greeting', type='string', payload=b'hello')
Received reply call:DownstreamReplyCall(call_id='16c69c3b-0de3-42fb-b902-71747d803275', request_call_id='892a9032-d0fd-4956-bef2-6cfdc211a786', source_node_id='06af612e-fc8d-49a5-ad92-c28039b0daa8', name='reply_greeting', type='string', payload=b'world')
[7]:
[None, None]