デバイスの接続

IronFlock は、ハードウェアやオペレーティングシステムに応じて、複数のデバイス接続方法をサポートしています。手元にハードウェアがない場合でも、数分でラップトップ上でデバイスをシミュレートできます。

前提条件

デバイスを接続する前に、以下を確認してください：

1. IronFlock 上にプロジェクトが作成されていること
2. プロジェクト内にデバイスエントリが作成されていること（プロジェクトの Settings -> Devices パネルで NEW DEVICE をクリック）
3. デバイス設定ファイル（.flock）がダウンロード済みであること

まずはテスト：ラップトップでデバイスをシミュレート

IronFlock を試すために物理的なハードウェアは必要ありません。FlockFlasher アプリは IronFlock エージェントをラップトップ上で直接実行できるため、ラップトップがプロジェクト内で実際のデバイスになりすまします。実機に展開する前にアプリやダッシュボードをテストするのに最適です。

1. Docker Desktop（Linux の場合は Docker Engine）をインストールし、起動していることを確認します。
2. お使いの OS 用の FlockFlasher アプリをダウンロードしてインストールします。
3. ダウンロード済みのデバイスの .flock ファイルをダブルクリックします。FlockFlasher が開き、デバイスがリストに表示されます。（または、FlockFlasher を開いて + ボタンからファイルを追加することもできます。）
4. デバイスエントリの Test Device（▶）ボタンをクリックします。FlockFlasher は初回使用時に IronFlock エージェントを自動的にダウンロードし、お使いのデバイス設定で起動します。

これで、ラップトップは IronFlock プロジェクト内でこのデバイスとして動作します。デバイスはオンラインとして表示され、実際のデバイスとまったく同じようにアプリをインストールして実行できます。アプリはラップトップ上で Docker コンテナとして実行されます。

テストが終わったら、FlockFlasher でテストを停止してください。同じ .flock ファイルは、後で実機のプロビジョニングにも使用できます。ただし、同じデバイス設定を実行するマシンは、常に 1 台のみにしてください。

方法1：SD カードのフラッシュ

SD カードからブートする Raspberry Pi やその他の ARM デバイスに最適です。

1. お使いの OS 用の FlockFlasher アプリをダウンロードします。
2. SD カード（最低 16 GB）をコンピュータに挿入します。
3. FlockFlasher を開き、+ ボタンをクリックして .flock ファイルを読み込みます。
4. SD カードドライブを選択します（FlockFlasher は外部ドライブを自動検出します）。
5. デバイスに適したイメージを選択します（Raspberry Pi 3/4、Zero など）。
6. 必要に応じて WiFi を設定し、設置先でデバイスが接続できるようにします。
7. Flash をクリックし、書き込み、検証、設定の完了を待ちます。
8. SD カードをデバイスに挿入して電源を入れます。

デバイスは 20分以内にオンラインになるはずです。

警告：フラッシュ処理により、選択したドライブのすべてのデータが消去されます。FlockFlasher はデフォルトで内蔵ドライブを非表示にしますが、選択内容を必ず確認してください。

方法2：産業用 PC 向け USB インストーラー

EFI ブート対応の AMD64 デバイス（例：Siemens SIMATIC Box IPC）向け。

1. USB スティック（最低 16 GB）を挿入し、FlockFlasher を開きます。
2. .flock ファイルを読み込み、USB ドライブを選択します。
3. Industrial PC x86_64 (EFI) イメージを選択します。
4. Flash をクリックし、完了を待ちます。
5. 必要に応じて、デバイスの BIOS でブート順序を USB ブートに変更します。
6. USB スティックを挿入してデバイスの電源を入れます。

デバイスは 60分以内にオンラインになるはずです。

方法3：カスタムインストール

既存の Linux OS を維持するデバイス向け。NVIDIA Jetson やカスタムハードウェアに最適です。

注意：この手動インストール方法は、産業用 PC、ゲートウェイ、組み込みデバイスなどの実際の本番ハードウェアを対象としており、ラップトップ向けではありません。ラップトップで IronFlock を試したいだけの場合は、代わりにまずはテスト：ラップトップでデバイスをシミュレートに従ってください。手動でのエージェントインストールは不要です。

Linux / Unix デバイス

1. デバイスに SSH 接続します。
2. セットアップバイナリをダウンロードします：

   curl -sSL https://instance-registry.ironflock.com/dl/reswarmify/install.sh | bash

3. .flock ファイルをコンピュータからデバイスにコピーします：

   scp mydevice.flock user@device-ip:/home/user/

4. エージェントを実行します：

   sudo ./ironflock-init -c mydevice.flock

企業プロキシの背後で運用していますか？ ステップ 2 の前にプロキシをエクスポートしてダウンロードが成功するようにし、ステップ 4 では ironflock-init に --http-proxy / --https-proxy を渡して、Docker エンジンの設定を自動で行わせてください。完全なコマンドと企業 CA の手順については、企業プロキシの背後で を参照してください。

Windows デバイス

1. デバイスに Docker Desktop をインストールし、Docker Desktop の設定で Start Docker Desktop when you sign in を有効にします。無人運用のデバイスでは、再起動後に誰もサインインしなくても Docker が利用できるよう、Windows の自動サインインも設定してください。
2. reagent.exe をダウンロードします。
3. .flock ファイルをデバイスにコピーします。
4. 管理者権限のコマンドプロンプトから、エージェントを Windows サービスとしてインストールして起動します：

   reagent.exe service install -config path\to\config.flock

   サービスはすぐに開始され、以降はシステム起動時にも自動的に開始されます。障害時には自動的に再起動し、エージェントを常に最新の状態に保ちます。起動せずにインストールするには -noStart を追加してください。状態はいつでも reagent.exe service status で確認できます。

企業プロキシの背後にいる場合は？ service install コマンドに -proxy http://proxy.example.com:3128 を追加し、Docker Desktop のプロキシは Settings → Resources → Proxies で設定してください。詳細と企業 CA の手順は 企業プロキシの背後で をご覧ください。

接続の確認

接続後、プロジェクトでデバイスのステータスを確認します：

• 緑のインジケーター — デバイスはオンラインで、IronFlock と通信中です。
• 赤のインジケーター — デバイスはオフラインです。ネットワーク接続を確認し、エージェントが実行中であることを確認してください。

デバイスマップビューには、プロジェクト内のすべてのデバイスの地理的な位置が表示されます。