翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Edge Manager エージェントを手動でダウンロードして設定する

お使いのオペレーティングシステム、アーキテクチャ、 AWS リージョンに基づいて Edge Manager エージェントをダウンロードします。このエージェントは定期的に更新されるため、リリース日とバージョンに基づいてエージェントを選択できます。エージェントを取得したら、JSON 形式の設定ファイルを作成します。デバイスの IoT モノオブジェクトの名前、フリート名、デバイスの認証情報、その他のキーバリューのペアを指定します。設定ファイルで指定する必要があるキーの完全なリストについては、「Edge Manager エージェントを実行する」を参照してください。エージェントは、実行可能バイナリファイルとして実行することも、動的共有オブジェクト (DSO) としてリンクすることもできます。

エージェントの仕組み

エージェントはデバイスの CPU で実行されます。エージェントはコンパイルジョブ中に指定したターゲットデバイスのフレームワークとハードウェアで推論を実行します。例えば、Jetson Nano のモデルをコンパイルした場合、エージェントは指定された深層学習ランタイム (DLR) の GPU をサポートします。

エージェントは、サポート対象のオペレーティングシステム向けに、バイナリ形式でリリースされます。お使いのオペレーティングシステムがサポートされ、次の表にある OS の最小要件を満たしていることを確認します。

Linux

バージョン: Ubuntu 18.04

サポートされているバイナリ形式: x86-64 ビット (ELF バイナリ) と ARMv8 64 ビット (ELF バイナリ)

Windows

バージョン: Windows 10 バージョン 1909

サポートされているバイナリ形式: x86-32 ビット (DLL) と x86-64 ビット (DLL)

Edge Manager エージェントをインストールする

Edge Manager エージェントを使用するには、まずリリースアーティファクトとルート証明書を取得する必要があります。リリースアーティファクトは、us-west-2 リージョンの Amazon S3 バケットに保存されています。このアーティファクトをダウンロードするには、オペレーティングシステム (<OS>) と <VERSION> を指定します。

お使いのオペレーティングシステムに基づいて、<OS> を以下のいずれかに置き換えます。

VERSION は <MAJOR_VERSION>.<YYYY-MM-DD>-<SHA-7> の 3 つのコンポーネントに分かれており、それぞれ次を表します。

<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 が示されています。

お使いのオペレーティングシステムに基づいて次のコマンドを使い、アーティファクトをインストールします。

Windows 32-bit

aws s3 cp s3://sagemaker-edge-release-store-us-west-2-windows-x86/Releases/<VERSION>/<VERSION>.zip .
aws s3 cp s3://sagemaker-edge-release-store-us-west-2-windows-x86/Releases/<VERSION>/sha256_hex.shasum .

Windows 64-bit

aws s3 cp s3://sagemaker-edge-release-store-us-west-2-windows-x64/Releases/<VERSION>/<VERSION>.zip .
aws s3 cp s3://sagemaker-edge-release-store-us-west-2-windows-x64/Releases/<VERSION>/sha256_hex.shasum .

Linux x86-64

aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-x64/Releases/<VERSION>/<VERSION>.tgz .
aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-x64/Releases/<VERSION>/sha256_hex.shasum .

Linux ARMv8

aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-armv8/Releases/<VERSION>/<VERSION>.tgz .
aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-armv8/Releases/<VERSION>/sha256_hex.shasum .

また、ルート証明書をダウンロードする必要があります。この証明書は、エッジデバイスにロード AWS する前に、 によって署名されたモデルアーティファクトを検証します。

<OS> をお使いのプラットフォーム (サポートされているオペレーティングシステムのリストに記載) に応じて置き換え、<REGION> をお使いの AWS リージョンに置き換えます。

aws s3 cp s3://sagemaker-edge-release-store-us-west-2-<OS>/Certificates/<REGION>/<REGION>.pem .

Edge Manager エージェントを実行する

SageMaker AI Edge Manager エージェントは、実行可能およびリンク可能形式 (ELF) 実行可能バイナリの形式でスタンドアロンプロセスとして実行することも、動的共有オブジェクト (.dll) としてリンクすることもできます。Linux は、スタンドアロンの実行可能なバイナリファイルとしての実行をサポートしており、これが推奨モードです。共有オブジェクト (.dll) としての実行は Windows でサポートされています。

Linux では、初期化 (init) システムの一部であるサービスを使用してバイナリファイルを実行することをお勧めします。バイナリを直接実行する場合は、次の例のように、ターミナルを使います。最新の OS を使用している場合は、エージェントを実行する前に他のものをインストールする必要はありません。すべての要件が実行可能ファイルに静的に組み込まれているため、エージェントはターミナルで、サービスとして、またはコンテナ内で柔軟に実行できます。

エージェントを実行するには、まず JSON 形式の設定ファイルを作成します。次のキーバリューのペアを指定します。

設定ファイルは、次の例の形式で独自の値を指定したものです。この例では、デフォルトの 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 を指定します。