モデルの変換に Azure Blob Storage を使用する
モデルの変換サービスでは、入力データを取得して出力データを格納できるように、Azure Blob Storage へのアクセスが必要です。 この記事では、それを行う最も一般的な手順について説明します。
Azure Storage アカウントを準備する
- ストレージ アカウント (StorageV2) を作成する
- そのストレージ アカウントで入力 BLOB コンテナー (たとえば、"arrinput" という名前) を作成する
- そのストレージ アカウントで出力 BLOB コンテナー (たとえば、"arroutput" という名前) を作成する
ヒント
ストレージ アカウントを設定する手順の詳細については、「クイックスタート: モデルをレンダリング用に変換する」を参照してください
ストレージ アカウントと BLOB コンテナーの作成は、次のいずれかのツールを使用して行うことができます。
- Azure Portal
- az コマン ドライン
- Azure 記憶域エクスプローラー
- SDK (C#、Python ...)
Azure Remote Rendering が自分のストレージ アカウントにアクセスできることを確認する
Azure Remote Rendering では、ストレージ アカウントからモデル データを取得し、それにデータを書き戻す必要があります。
次の 2 通りの方法で、自分のストレージ アカウントへのアクセスを Azure Remote Rendering に許可できます。
自分の Azure Storage アカウントを Azure Remote Rendering アカウントに接続する
アカウントの作成に関するセクションに記載されている手順に従います。
ストレージ コンテナーの SAS を取得する
Shared Access Signature (SAS) を使用して、入力に対する読み取りアクセスと出力に対する書き込みアクセスを許可します。 モデルが変換されるたびに、新しい URI を生成することをお勧めします。 URI はしばらくすると期限切れになるため、これらを長期間保持すると、アプリケーションが予期せず中断する危険性があります。
SAS の詳細については、SAS のドキュメントを参照してください。
SAS URI は、次のいずれかを使用して生成できます。
- Az PowerShell モジュール
- 「PowerShell スクリプトの例」を参照
- az コマン ドライン
- Azure 記憶域エクスプローラー
- コンテナーを右クリックして [Shared Access Signature の取得] を選択する (入力コンテナーに対しては読み取りとリスト アクセス、出力コンテナーに対しては書き込みアクセス)
- SDK (C#、Python ...)
アセット変換での Shared Access Signature の使用例は、「PowerShell スクリプトの例」の「Conversion.ps1」に示されています。
重要
ストレージ アカウントを構成する場合は、すべての IP アドレスを許可一覧表示する場合でも、許可される IP アドレス範囲を指定しないでください。
IP 範囲を指定すると、SAS トークンが ARR で動作せず、モデルの読み込みが失敗する可能性があります。
入力モデルをアップロードする
モデルの変換を開始するには、次のいずれかのオプションを使用して、モデルをアップロードする必要があります。
- Azure Storage Explorer - Azure Blob Storage でファイルをアップロード、ダウンロード、管理するための便利な UI
- Azure コマンド ライン
- Azure PowerShell モジュール
- 「PowerShell スクリプトの例」を参照
- Storage SDK (Python、C# ...) の使用
- Azure Storage REST API の使用
- Azure Remote Rendering Toolkit (ARRT) の使用
変換のためにデータをアップロードする方法の例については、「PowerShell スクリプトの例」の「Conversion.ps1」を参照してください。
Note
入力モデルをアップロードする場合は、サービスで Windows のパスの長さの制限に関する問題を回避するために、ファイル名やフォルダー構造が長くならないように注意する必要があります。
変換されたモデルの SAS URI を取得する
この手順は、ストレージ コンテナーの SAS を取得するのと似ています。 ただし、ここでは、出力コンテナーに書き込まれたモデル ファイルの SAS URI を取得する必要があります。
たとえば、Azure Storage Explorer を使用して SAS URI を取得するには、モデル ファイルを右クリックし、[Shared Access Signature の取得] を選択します。
自分のストレージ アカウントを Azure Remote Rendering アカウントに接続していない場合は、モデルを読み込むために Shared Access Signature (SAS) が必要です。 アカウントを接続する方法については、アカウントの作成に関するセクションを参照してください。