翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Edge Manager エージェントを手動でダウンロードして設定する
お使いのオペレーティングシステム、アーキテクチャ、 AWS リージョンに基づいて Edge Manager エージェントをダウンロードします。このエージェントは定期的に更新されるため、リリース日とバージョンに基づいてエージェントを選択できます。エージェントを取得したら、JSON 形式の設定ファイルを作成します。デバイスの IoT モノオブジェクトの名前、フリート名、デバイスの認証情報、その他のキーバリューのペアを指定します。設定ファイルで指定する必要があるキーの完全なリストについては、「Edge Manager エージェントを実行する」を参照してください。エージェントは、実行可能バイナリファイルとして実行することも、動的共有オブジェクト (DSO) としてリンクすることもできます。
エージェントの仕組み
エージェントはデバイスの CPU で実行されます。エージェントはコンパイルジョブ中に指定したターゲットデバイスのフレームワークとハードウェアで推論を実行します。例えば、Jetson Nano のモデルをコンパイルした場合、エージェントは指定された深層学習ランタイム
エージェントは、サポート対象のオペレーティングシステム向けに、バイナリ形式でリリースされます。お使いのオペレーティングシステムがサポートされ、次の表にある OS の最小要件を満たしていることを確認します。
Edge Manager エージェントをインストールする
Edge Manager エージェントを使用するには、まずリリースアーティファクトとルート証明書を取得する必要があります。リリースアーティファクトは、us-west-2 リージョンの Amazon S3 バケットに保存されています。このアーティファクトをダウンロードするには、オペレーティングシステム (<OS>) と <VERSION> を指定します。
お使いのオペレーティングシステムに基づいて、<OS> を以下のいずれかに置き換えます。
| Windows 32 ビット | Windows 64 ビット | Linux x86-64 | Linux ARMv8 |
|---|---|---|---|
| windows-x86 | windows-x64 | linux-x64 | linux-armv8 |
VERSION は <MAJOR_VERSION>.<YYYY-MM-DD>-<SHA-7> の 3 つのコンポーネントに分かれており、それぞれ次を表します。
-
<MAJOR_VERSION>: リリースのバージョン。現在、リリースバージョンは1に設定されています。 -
<YYYY-MM-DD>: アーティファクトリリースのタイムスタンプ。 -
<SHA-7>: リリースのビルド元のリポジトリコミット ID。
<MAJOR_VERSION> とタイムスタンプ (YYYY-MM-DD の形式) で指定する必要があります。最新のタイムスタンプを持つリリースアーティファクトを使用することをお勧めします。
コマンドラインで次のコマンドを実行して、最新のタイムスタンプを取得します。<OS> をお使いのオペレーティングシステムに置き換えます。
aws s3 ls s3://sagemaker-edge-release-store-us-west-2-<OS>/Releases/ | sort -r
例えば、Windows 32 ビット OS を使用している場合は、以下を実行します。
aws s3 ls s3://sagemaker-edge-release-store-us-west-2-windows-x86/Releases/ | sort -r
これにより、次が返されます。
2020-12-01 23:33:36 0 PRE 1.20201218.81f481f/ PRE 1.20201207.02d0e97/
この例で返された出力には、2 つのリリースアーティファクトが表示されています。1 つ目のリリースアーティファクトファイルには、リリースバージョンのメジャーリリースバージョン 1、タイムスタンプ 20201218 (YYYY-MM-DD 形式)、SHA-7 コミット ID 81f481f が示されています。
注記
前述のコマンドは、 AWS Command Line Interfaceが設定済みであることを前提としています。が とやり取りするために使用する設定を構成する方法の詳細については、 AWS CLI 「 CLI の設定 AWS AWS」を参照してください。
お使いのオペレーティングシステムに基づいて次のコマンドを使い、アーティファクトをインストールします。
また、ルート証明書をダウンロードする必要があります。この証明書は、エッジデバイスにロード AWS する前に、 によって署名されたモデルアーティファクトを検証します。
<OS> をお使いのプラットフォーム (サポートされているオペレーティングシステムのリストに記載) に応じて置き換え、<REGION> をお使いの AWS
リージョンに置き換えます。
aws s3 cp s3://sagemaker-edge-release-store-us-west-2-<OS>/Certificates/<REGION>/<REGION>.pem .
Edge Manager エージェントを実行する
SageMaker Edge Manager エージェントは、実行可能およびリンク可能形式 (ELF) の実行可能バイナリの形式でスタンドアロンプロセスとして実行することも、動的共有オブジェクト (.dll) としてリンクすることもできます。Linux は、スタンドアロンの実行可能なバイナリファイルとしての実行をサポートしており、これが推奨モードです。共有オブジェクト (.dll) としての実行は Windows でサポートされています。
Linux では、初期化 (init) システムの一部であるサービスを使用してバイナリファイルを実行することをお勧めします。バイナリを直接実行する場合は、次の例のように、ターミナルを使います。最新の OS を使用している場合は、エージェントを実行する前に他のものをインストールする必要はありません。すべての要件が実行可能ファイルに静的に組み込まれているため、エージェントはターミナルで、サービスとして、またはコンテナ内で柔軟に実行できます。
エージェントを実行するには、まず JSON 形式の設定ファイルを作成します。次のキーバリューのペアを指定します。
-
sagemaker_edge_core_device_name: デバイスの名前。このデバイス名は、 SageMaker Edge Manager コンソールでデバイスフリートと一緒に登録する必要があります。 -
sagemaker_edge_core_device_fleet_name: デバイスが属するフリートの名前。 -
sagemaker_edge_core_region: デバイス、フリート、および Amazon S3 バケットに関連付けられた AWS リージョン。これは、デバイスが登録され、Amazon S3 バケットが作成されたリージョンと一致します (同じであることが予想されます)。モデル自体は別のリージョンの SageMaker Neo でコンパイルできますが、この設定はモデルコンパイルリージョンとは関係ありません。 -
sagemaker_edge_core_root_certs_path: ルート証明書へのフォルダの絶対パス。これは、関連する AWS アカウントでデバイスを検証するために使用されます。 -
sagemaker_edge_provider_aws_ca_cert_file: Amazon ルート CA 証明書 (AmazonRootCA1.pem) への絶対パス。これは、関連する AWS アカウントでデバイスを検証するために使用されます。AmazonCAは、 が所有する証明書です AWS。 -
sagemaker_edge_provider_aws_cert_file: ルート証明書 AWS IoT に署名するための絶対パス (*.pem.crt）。 -
sagemaker_edge_provider_aws_cert_pk_file: AWS IoT プライベートキーへの絶対パス。 （*.pem.key）。 -
sagemaker_edge_provider_aws_iot_cred_endpoint: AWS IoT 認証情報エンドポイント (識別子.iot.region.amazonaws.com)。このエンドポイントは、認証情報の検証に使用されます。詳細については、「デバイスの AWS IoTへの接続」を参照してください。 -
sagemaker_edge_provider_provider: これは、プロバイダーインターフェイスの実装を使用していることを示します。プロバイダーインターフェイスは、アップロード、ハートビート、登録の検証のためにエンドネットワークサービスと通信します。デフォルトでは、"Aws"に設定されています。プロバイダーインターフェイスのカスタム実装もできます。そのため、プロバイダーがない場合はNoneに、または関連する共有オブジェクトパスを使用するカスタム実装の場合はCustomに設定できます。 -
sagemaker_edge_provider_provider_path: プロバイダーが実装する共有オブジェクト (.so ファイルまたは.dll ファイル) への絶対パスを指定します。"Aws"プロバイダーの .dll または .so ファイルまたは so ファイルは、エージェントのリリースで提供されます。これは必須フィールドです。 -
sagemaker_edge_provider_s3_bucket_name: Amazon S3 バケットの名前 (Amazon S3 バケット URI ではありません)。バケットの名前には文字列sagemakerが含まれている必要があります。 -
sagemaker_edge_log_verbose(ブール値): 任意。デバッグログを設定します。[True] または [False] のいずれかを選択します。 -
sagemaker_edge_telemetry_libsystemd_path: (Linux のみ)systemdはエージェントのクラッシュカウンタのメトリクスを実装します。libsystemd の絶対パスを設定して、クラッシュカウンタのメトリクスを有効にします。デフォルトの libsystemd パスは、デバイスのターミナルでwhereis libsystemdを実行することで見つけられます。 -
sagemaker_edge_core_capture_data_destination: キャプチャデータをアップロードする場所 (送信先)。["Cloud"] または ["Disk"] のいずれかを選択します。デフォルトでは"Disk"に設定されています。"Disk"に設定すると、入力および出力テンソルと補助データをローカルファイルシステムの任意の場所に書き込みます。"Cloud"に書き込む場合、sagemaker_edge_provider_s3_bucket_name設定で指定された Amazon S3 バケット名が使用されます。 -
sagemaker_edge_core_capture_data_disk_path: ローカルファイルシステムの絶対パスを設定します。"Disk"が送信先になっている場合は、ここにキャプチャデータのファイルが書き込まれます。"Cloud"が送信先として指定されている場合は、このフィールドは使用されません。 -
sagemaker_edge_core_folder_prefix: Amazon S3 の親プレフィックス。キャプチャデータの送信先 (sagemaker_edge_core_capture_data_disk_path)) に"Cloud"を指定した場合は、ここにキャプチャデータが保存されます。"Disk"がデータの送信先として設定されている場合、キャプチャしたデータはsagemaker_edge_core_capture_data_disk_pathのサブフォルダに保存されます。 -
sagemaker_edge_core_capture_data_buffer_size(整数値): キャプチャデータのリングバッファサイズ。これは、バッファに保存されているリクエストの最大件数を示します。 -
sagemaker_edge_core_capture_data_batch_size(整数値): キャプチャデータのバッチサイズ。これは、バッファで処理されるリクエストのバッチサイズを示します。この値は、sagemaker_edge_core_capture_data_buffer_size以下にする必要があります。バッチサイズをバッファのサイズを最大値の半分にすることをお勧めします。 -
sagemaker_edge_core_capture_data_push_period_seconds(整数値): キャプチャデータのプッシュ期間 (秒)。バッファ内のリクエストのバッチは、バッファにバッチのリクエストがある場合、またはこの期間が終了したとき (どちらか早いほう) に処理されます。この設定では、その期間を設定します。 -
sagemaker_edge_core_capture_data_base64_embed_limit: キャプチャデータのアップロード制限 (バイト)。整数値。
設定ファイルは、次の例の形式で独自の値を指定したものです。この例では、デフォルトの AWS provider("Aws") を使用しており、定期的なアップロードを指定していません。
{ "sagemaker_edge_core_device_name":"device-name", "sagemaker_edge_core_device_fleet_name":"fleet-name", "sagemaker_edge_core_region":"region", "sagemaker_edge_core_root_certs_path": "<Absolute path to root certificates>", "sagemaker_edge_provider_provider": "Aws", "sagemaker_edge_provider_provider_path" : "/path/to/libprovider_aws.so", "sagemaker_edge_provider_aws_ca_cert_file": "<Absolute path to Amazon Root CA certificate>/AmazonRootCA1.pem", "sagemaker_edge_provider_aws_cert_file": "<Absolute path to AWS IoT signing root certificate>/device.pem.crt", "sagemaker_edge_provider_aws_cert_pk_file": "<Absolute path to AWS IoT private key.>/private.pem.key", "sagemaker_edge_provider_aws_iot_cred_endpoint": "https://<AWS IoT Endpoint Address>", "sagemaker_edge_core_capture_data_destination": "Cloud", "sagemaker_edge_provider_s3_bucket_name": "sagemaker-bucket-name", "sagemaker_edge_core_folder_prefix":"Amazon S3 folder prefix", "sagemaker_edge_core_capture_data_buffer_size": 30, "sagemaker_edge_core_capture_data_batch_size": 10, "sagemaker_edge_core_capture_data_push_period_seconds": 4000, "sagemaker_edge_core_capture_data_base64_embed_limit": 2, "sagemaker_edge_log_verbose": false }
リリースアーティファクトには、/bin ディレクトリに sagemaker_edge_agent_binary という名前のバイナリ実行可能ファイルが含まれています。バイナリファイルを実行するには、-a フラグを使用して、選択したディレクトリにソケットファイル記述子 (.sock) を作成し、-c フラグを使用して作成した、エージェントの JSON 形式の設定ファイルのパスを指定します。
./sagemaker_edge_agent_binary -a<ADDRESS_TO_SOCKET>-c<PATH_TO_CONFIG_FILE>
次に、ディレクトリとファイルパスを指定したコードスニペットの例を示します。
./sagemaker_edge_agent_binary -a /tmp/sagemaker_edge_agent_example.sock -c sagemaker_edge_config.json
この例では、/tmp ディレクトリに sagemaker_edge_agent_example.sock という名前のソケットファイル記述子が作成され、エージェントと同じ作業ディレクトリにある設定ファイル sagemaker_edge_config.json を指定します。
