- リリース ノート
- 要件
- インストール
- 基本情報
- プロジェクト
- データセット
- ML パッケージ
- パイプライン
- ML スキル
- ML ログ
- AI Fabric での Document Understanding
- 基本的なトラブルシューティング ガイド
AI Fabric シングル ノード
AI Fabric のインストールでは、大まかに以下の手順を実行する必要があります。
| 手順 | アクティブ時間 | 待機時間 |
|---|---|---|
| 1. AIF マシンをプロビジョニングする | 5 分未満 | -- |
| 2. データベースを構成する | 1 分未満 | -- |
| 3. Orchestrator を構成する | 5 分未満 | -- |
| 4. AI Fabric インフラストラクチャ インストーラーを実行する | 1 分未満 | 約 20 分 |
| 5. AI Fabric アプリケーション インストーラーを実行する | 5 分未満 | 約 20 分 |
| 6. インストールを検証する | 約 5 分 | -- |
- AI Fabric のインストール先とする Linux マシンは、Orchestrator マシン (ドメインとポート) に接続できる必要があります。
- AI Fabric のインストール先とする Linux マシンは、SQL Server (ドメイン/IP とポート) に接続できる必要があります。
- AI Fabric を利用する Robot/Studio は、AI Fabric の Linux マシンに接続できる必要があります。
Document Understanding の周辺コンポーネント (Data Manager および OCR エンジン) の場合:
- 事前ラベル付けが必要な場合 (事前ラベル付けは任意)、Data Manager はオンプレミス版 AI Fabric (:<port_number>) またはパブリック SaaS エンドポイント (https://invoices.uipath.com など) にアクセスできる必要があります。
- Data Manager は OCR エンジン (:<port_number>) にアクセスできる必要があります。OCR エンジンとしては、オンプレミスの UiPath Document OCR、オンプレミスの Omnipage OCR、Google Cloud Vision OCR、Microsoft Read Azure、オンプレミスの Microsoft Read が考えられます。
- ロボットが OCR (:<port_number>) にアクセスできる必要があります。上記と同じ OCR オプション (Omnipage を除く) を、アクティビティ パッケージとしてロボットで直接利用できます。
AI Fabric のオンライン インストールとは、AI Fabric アプリケーションおよび関連するすべての成果物 (マシン ラーニング モデルなど) をインターネットからダウンロードするオンプレミスのインストールです。
AI Fabric インストーラーはコンテナー イメージおよびマシン ラーニング モデルをダウンロードして、AI Fabric インスタンスにすぐに使えるマシン ラーニングを実装します (Document Understanding モデルを含む)。このため、インストール時に Linux マシンは、https (ポート 443) 経由でこれらのエンドポイントにアクセスできる必要があります。
| ホスト名 | 目的 |
|---|---|
| registry.replicated.com | アップストリームの Docker イメージが registry.replicated.com 経由で取得されます。このドメインは Replicated, Inc (本社: カリフォルニア州ロサンゼルス) が所有しています。 |
| proxy.replicated.com | アップストリームの Docker イメージが proxy.replicated.com 経由で取得されます。オンプレミスの Docker クライアントがライセンス ID を使用して proxy.replicated.com に対する認証を行います。このドメインは Replicated, Inc (本社: カリフォルニア州ロサンゼルス) が所有しています。 |
| replicated.app | アップストリーム アプリケーション YAML およびメタデータが replicated.app から取得されます。アプリケーションの現在の実行バージョン (指定されている場合) は、ライセンス ID に加えて送信されます。アプリケーション ID は、これらの REPLICATED.APP を認証および受信するためにアプリケーション ID が送信されます。このドメインは Replicated, Inc (本社: カリフォルニア州ロサンゼルス) が所有しています。 |
| get.replicated.com | Replicated からの成果物を同期します。このドメインは Replicated, Inc (本社: カリフォルニア州ロサンゼルス) が所有しています。 |
| api.replicated.com | インフラストラクチャ インストーラーへの API 要求です。このドメインは Replicated, Inc (本社: カリフォルニア州ロサンゼルス) が所有しています。 |
| k8s.kurl.sh | Kubernetes クラスターのインストール スクリプトと成果物が kurl.sh から提供されます。アプリケーション識別子が URL パスで送信され、bash スクリプトとバイナリ実行ファイルが kurl.sh から提供されます。このドメインは Replicated, Inc (本社: カリフォルニア州ロサンゼルス) が所有しています。 |
| kurl-sh.s3.amazonaws.com | 埋め込みクラスターのインストール時に、tar.gz パッケージが Amazon S3 からダウンロードされます。ホワイトリストに登録する IP アドレスの範囲を AWS IP Address Ranges1 文書から動的にスクレイピングできます。 |
| *.docker.io | アップストリームの Docker イメージが docker.io から取得されます。registry-1.docker.io のようなサブドメインが複数存在する可能性があるため、右側のパターンが許容される必要があります。 |
| *.docker.com | 他のアップストリームの Docker イメージが docker.com から取得されます。サブドメインが複数存在する可能性があるため、右側のパターンが許容される必要があります。 |
| raw.githubusercontent.com | 永続ボリューム要求のデプロイを作成するスクリプト用。 |
| quay.io | コンテナー イメージを提供します。 |
| registry.k8s.io | アップストリーム イメージが registry.k8s.io から取得されます。 |
これらのエンドポイントへの接続は、AI Fabric で GPU を使用するためだけに行われます。GPU のインストールはすべて、手順「4. AI Fabric インフラストラクチャ インストーラーを実行する」で GPU インストーラー スクリプトを使用して行われます。
| ホスト名 | 目的 |
|---|---|
| developer.download.nvidia.com | NVIDIA から GPU ドライバーをダウンロードします。 |
| nvidia.github.io | https://nvidia.github.io/nvidia-docker/gpgkey および nvidia-docker.list をダウンロードします。 |
| raw.githubusercontent.com | スクリプトが、github.com/NVIDIA/k8s-device-plugin から YAML ファイルを内部でダウンロードします。 |
実行時、オンライン インストーラーを使用してインストールした AI Fabric がこれらのエンドポイントに接続します。
| ホスト名 | 目的 |
|---|---|
| du-metering.uipath.com | Document Understanding のライセンスを考慮し、検証します。 |
| registry.replicated.com | アップストリームの Docker イメージが、registry.replicated.com からプライベート Docker レジストリ経由で取得されます。このドメインは Replicated, Inc (本社: カリフォルニア州ロサンゼルス) が所有しています。 |
| raw.githubusercontent.com | OOB モデルを毎日更新するスクリプト用。 |
| github.com | OOB モデルを毎日更新するスクリプト用。 |
| カスタム (任意) | これは、AI Fabric を使用するペルソナが ML パッケージの構築をどのように選択しているかによって異なります。AI Fabric がコンテナー イメージを動的に構築します。そのイメージの依存関係は ML パッケージ内にバンドルする (その場合、余分なアウトバウンド ネットワーク呼び出しが行われません) か、requirements.txt ファイル内で指定できます。このファイルで、依存関係のダウンロード元の場所を指定できます。 |
AI Fabric のエアギャップ インストールとは、uipath ドメインからのワンタイム ダウンロードの後でトリガーされるオンプレミスでのインストールです。
インストール時にインターネット接続は不要です (注: ノードに GPU がある場合、エアギャップ インストールの前提条件で詳しく説明しているように、NVIDIA ドライバーのバージョン 450.51.06 および nvidia-container-runtime がインストール済みであることが前提となります)。
アプリケーション実行時に接続性が必要かどうかは、全面的に AI Fabric のユーザーの判断によります。AI Fabric のユーザーが、AI Fabric でデプロイしてトレーニングできる ML パッケージを作成します。AI Fabric は、その ML パッケージからコンテナー イメージを動的に構築します。そのイメージの依存関係は ML パッケージ内にバンドルする (その場合、余分なアウトバウンド ネットワーク呼び出しが行われません) か、requirements.txt ファイル内で指定できます。このファイルで、内部でセキュリティが保護された Python パッケージの依存関係リポジトリなど、依存関係のダウンロード元の場所を指定できます。
