accelize.xilinx_xrt
Xilinx XRT Ansibleロール
このAnsibleロールは、Xilinx FPGAデバイス向けアプリケーションを実行するために必要なXilinx XRTをインストールします。
要件
ターゲットホストに互換性のあるXilinx FPGAデバイスが必要です。
ロールはターゲットホスト上でrootユーザーとして実行する必要があります。
ロール変数
- xilinx_xrt_install:
trueの場合、XRTをインストールします。 デフォルトはtrueです。 - xilinx_xrt_version: インストールするXilinx XRTのバージョン。 デフォルトは最新のものです。
- xilinx_xrt_from_src:
trueの場合、Xilinx提供のパッケージではなくソースからXRTをインストールします。 デフォルトはfalseです。 - xilinx_xrt_env: XRT固有の環境。
サポートする値:
aws、azure。 指定しない場合、クラシックなXilinx XRT環境がデフォルトとなります。 - xilinx_xrt_platforms: FPGAプラットフォームのリスト。指定された場合、関連するデプロイメントターゲットプラットフォームパッケージをインストールします。
サポートする値:
u50、u55c、u200、u250、u280。 - xilinx_xrt_ensure_compatible_kernel:
trueの場合、インストールされているLinuxカーネルが互換性があることを確認します。 デフォルトはfalseです。 - xilinx_xrt_bashrc:
trueの場合、XRTのセットアップスクリプトのソースをユーザーの~/.bashrcに追加します。 デフォルトはfalseです。 - xilinx_xrt_check_fpga:
trueの場合、FPGAを検出してXRTが正しくインストールされているか確認します。 デフォルトはfalseです。 - xilinx_xrt_container: コンテナ内でロールを実行してカーネルバージョンの不一致問題を避けるためにこれを
trueに設定します。 デフォルトはfalseです。 - xilinx_xrt_rhel7_devtoolset: RHEL/CentOS 7上でXRT提供の依存関係インストールスクリプトによってインストールされていない場合に使用するRed Hat Developer Toolsetのバージョン。
xilinx_xrt_from_srcが
falseの場合は効果ありません。 デフォルトは9です。
AWS FPGA
AWS環境はAWS FPGAに関連する追加変数をサポートしています。
以下はxilinx_xrt_envがawsに設定されている場合のみ利用可能です。
- aws_fpga_install:
trueの場合、AWS FPGAランタイムライブラリをインストールします。 デフォルトはtrueです。 - aws_fpga_src_install: 指定された場合、指定されたディレクトリにAWS FPGAソースをインストールします。 デフォルトではソースはインストールしません。
- aws_fpga_version: インストールするAWS FPGAのバージョン。 デフォルトは最新のものです。
- aws_fpga_allow_non_root:
trueの場合、FPGAデバイスへのアクセスをすべてのユーザーまたは特定のグループのユーザーに許可します。aws_fpga_sdk_othersも参照してください。 デフォルトはfalseです。 - aws_fpga_sdk_others:
trueの場合、FPGAデバイスへのアクセスをすべてのユーザーに許可するか、そうでない場合はaws_fpga_sdk_groupで指定されたグループのユーザーにアクセスを許可します。 デフォルトはfalseです。 aws_fpga_allow_non_rootがfalseの場合は効果ありません。 - aws_fpga_sdk_group: FPGAデバイスにアクセスできるユーザーのグループ名。
デフォルトは
fpgauserです。 aws_fpga_allow_non_rootがfalseまたはaws_fpga_sdk_othersがtrueの場合は効果ありません。 - aws_fpga_sdk_override_group:
trueの場合、aws_fpga_sdk_groupで指定されたグループがすでに存在していてもエラーを発生させません。 デフォルトはfalseです。 aws_fpga_allow_non_rootがfalseまたはaws_fpga_sdk_othersがtrueの場合は効果ありません。 - aws_fpga_driver: 指定された場合、指定の代替ドライバーをインストールします。
指定がない場合はデフォルトのXOCLドライバーを使用します。
これには* xilinxxxx_xrt_install*が
falseに設定されている必要があります。 サポートする値:xdma。
Xilinx Video SDK
Alveo U30/AWS VT1向けのXilinx Video SDKに関連する追加変数。
- xilinx_video_sdk_install:
trueの場合、Xilinx Video SDKをインストールします。 デフォルトはfalseです。 - xilinx_video_sdk_version: インストールするXilinx Video SDKのバージョン。 デフォルトは最新のものです。
注意: xilinx_xrt_installはXilinx Video SDKで自動的にfalseに設定されます。なぜなら、既にXRTが含まれているからです。
例のプレイブック
変数をパラメーターとして渡して使用する例を含めることは、ユーザーにとってもいいことです：
- hosts: servers
become: true
roles:
- role: accelize.xilinx_xrt
依存関係
xilinx_xrt_ensure_compatible_kernelがtrueに設定されている場合、ロールaccelize.linux_kernelが必要です。
ライセンス
著作権 Accelize 2019、Apache 2.0
インストールされたコンポーネントのライセンス：
このAnsibleロールはXilinxまたはAWSによって承認または提携されていません。
著者情報
このロールは、Accelizeによって提供されています。