ワーカーホストのセットアップと設定 - Deadline クラウド
Python 環境を設定するワーカーエージェントをインストールするワーカーエージェントを設定するジョブのユーザーとグループを作成する

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

ワーカーホストのセットアップと設定

ワーカーホストとは、Deadline Cloud ワーカーを実行するホストマシンを指します。このセクションでは、ワーカーホストをセットアップし、特定のニーズに合わせて設定する方法について説明します。各ワーカーホストは、ワーカーエージェントと呼ばれるプログラムを実行します。ワーカーエージェントは以下を担当します。

  • ワーカーのライフサイクルの管理。

  • 割り当てられた作業、その進行状況、結果を同期します。

  • 実行中の作業のモニタリング。

  • 設定された送信先にログを転送する。

提供された Deadline Cloud ワーカーエージェントを使用することをお勧めします。ワーカーエージェントはオープンソースであり、機能リクエストをお勧めしますが、ニーズに合わせて開発およびカスタマイズすることもできます。

以下のセクションのタスクを完了するには、以下が必要です。

Linux

  • Linuxベースの Amazon Elastic Compute Cloud (Amazon EC2) インスタンス。Amazon Linux 2023 をお勧めします。

  • sudo 権限

  • Python 3.9 以降

Windows

  • Windowsベースの Amazon Elastic Compute Cloud (Amazon EC2) インスタンス。Windows Server 2022をお勧めします。

  • ワーカーホストへの管理者アクセス

  • すべてのユーザーにインストールされた Python 3.9 以降

Python 仮想環境を作成して設定する

Python 3.9 以降をインストールして に配置しLinuxている場合は、 で Python 仮想環境を作成できますPATH。

注記

ではWindows、エージェントファイルは Python のグローバル site-packages ディレクトリにインストールする必要があります。Python 仮想環境は現在サポートされていません。

Python 仮想環境を作成してアクティブ化するには

  1. root ユーザーとしてターミナルを開きます (または sudo / を使用しますsu)。

  2. Python 仮想環境を作成してアクティブ化します。

    python3 -m venv /opt/deadline/worker
source /opt/deadline/worker/bin/activate
pip install --upgrade pip

Deadline Cloud ワーカーエージェントをインストールする

Python をセットアップし、 に仮想環境を作成したらLinux、Deadline Cloud ワーカーエージェント Python パッケージをインストールします。

ワーカーエージェントの Python パッケージをインストールするには

Linux

  1. root ユーザーとしてターミナルを開きます (または sudo / を使用しますsu)。

  2. PyPI から Deadline Cloud ワーカーエージェントパッケージをダウンロードしてインストールします。

    /opt/deadline/worker/bin/python -m pip install deadline-cloud-worker-agent
Windows

  1. 管理者コマンドプロンプトまたは PowerShell ターミナルを開きます。

  2. PyPI から Deadline Cloud ワーカーエージェントパッケージをダウンロードしてインストールします。

    python -m pip install deadline-cloud-worker-agent

Windows ワーカーホストに長いパス名 (250 文字以上) が必要な場合は、次のように長いパス名を有効にする必要があります。

  1. ロングパスレジストリキーが有効になっていることを確認します。詳細については、Microsoft ウェブサイトの「ログパスを有効にするレジストリ設定」を参照してください。

  2. Windows SDK for Desktop C++ x86 アプリケーションをインストールします。詳細については、Windows開発センターの Windows SDK を参照してください。

  3. ワーカーエージェントがインストールされている環境で Python のインストール場所を開きます。デフォルトは C:\Program Files\Python311 です。という名前の実行可能ファイルがありますpythonservice.exe。

  4. pythonservice.exe.manifest 同じ場所に という名前の新しいファイルを作成します。以下を追加します。

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity type="win32" name="pythonservice" processorArchitecture="x86" version="1.0.0.0"/>
  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <longPathAware xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">true</longPathAware>
    </windowsSettings>
  </application>
</assembly>

  5. コマンドプロンプトを開き、作成したマニフェストファイルの場所で次のコマンドを実行します。

    "C:\Program Files (x86)\Windows Kits\10\bin\10.0.26100.0\x86\mt.exe" -manifest pythonservice.exe.manifest -outputresource:pythonservice.exe;#1

    次のような出力が表示されます:

    Microsoft (R) Manifest Tool
Copyright (c) Microsoft Corporation.
All rights reserved.

ワーカーは長いパスにアクセスできるようになりました。クリーンアップするには、 pythonservice.exe.manifest ファイルを削除して SDK をアンインストールします。

Deadline Cloud ワーカーエージェントを設定する

Deadline Cloud ワーカーエージェントの設定は、3 つの方法で設定できます。install-deadline-worker ツールを実行して、オペレーティングシステムのセットアップを使用することをお勧めします。

ワーカーエージェントは、Windows でのドメインユーザーとしての実行をサポートしていません。ドメインユーザーとしてジョブを実行するには、ジョブを実行するキューユーザーを設定するときにドメインユーザーアカウントを指定できます。詳細については、「Deadline Cloud ユーザーガイド」の「Deadline Cloud キュー」のステップ 7 を参照してください。 AWS

コマンドライン引数 — コマンドラインから Deadline Cloud ワーカーエージェントを実行するときに引数を指定できます。一部の設定は、コマンドライン引数では利用できません。使用可能なすべてのコマンドライン引数を表示するには、「」と入力しますdeadline-worker-agent --help。

環境変数 — で始まる環境変数を設定することで、Deadline Cloud ワーカーエージェントを設定できますDEADLINE_WORKER_。たとえば、使用可能なすべてのコマンドライン引数を表示するには、ワーカーエージェントの出力を詳細に設定export DEADLINE_WORKER_VERBOSE=trueするために使用できます。その他の例と情報については、/etc/amazon/deadline/worker.toml.exampleLinux「」またはC:\ProgramData\Amazon\Deadline\Config\worker.toml.example「」を参照してくださいWindows。

設定ファイル — ワーカーエージェントをインストールすると、 /etc/amazon/deadline/worker.toml Linuxまたは C:\ProgramData\Amazon\Deadline\Config\worker.tomlの にある設定ファイルが作成されますWindows。ワーカーエージェントは、起動時にこの設定ファイルをロードします。サンプル設定ファイル (/etc/amazon/deadline/worker.toml.example Linuxまたは C:\ProgramData\Amazon\Deadline\Config\worker.toml.example Windows) を使用して、特定のニーズに合わせてデフォルトのワーカーエージェント設定ファイルをカスタマイズできます。

最後に、ソフトウェアがデプロイされ、期待どおりに動作したら、ワーカーエージェントの自動シャットダウンを有効にすることをお勧めします。これにより、ワーカーフリートは必要に応じてスケールアップし、ジョブが終了したらシャットダウンできます。自動スケーリングは、必要なリソースのみを使用するのに役立ちます。自動スケーリンググループによって開始されたインスタンスをシャットダウンできるようにするには、 worker.toml を設定ファイルshutdown_on_stop=trueに追加する必要があります。

自動シャットダウンを有効にするには

root ユーザーとして:

  • パラメータ を使用してワーカーエージェントをインストールします--allow-shutdown。

    Linux

    次のとおりに入力します。

    /opt/deadline/worker/bin/install-deadline-worker \
  --farm-id FARM_ID \
  --fleet-id FLEET_ID \
  --region REGION \
  --allow-shutdown
    Windows

    次のとおりに入力します。

    install-deadline-worker ^
  --farm-id FARM_ID ^
  --fleet-id FLEET_ID ^
  --region REGION ^
  --allow-shutdown

ジョブのユーザーとグループを作成する

このセクションでは、エージェントユーザーとキューでjobRunAsUser定義されている との間の必要なユーザーとグループの関係について説明します。

Deadline Cloud ワーカーエージェントは、ホスト上のエージェント固有の専用ユーザーとして実行する必要があります。Deadline Cloud キューの jobRunAsUserプロパティを設定して、ワーカーがキュージョブを特定のオペレーティングシステムのユーザーおよびグループとして実行できるようにする必要があります。つまり、ジョブが持つ共有ファイルシステムのアクセス許可を制御できます。また、ジョブとワーカーエージェントユーザーとの間の重要なセキュリティ境界として も提供します。

Linux ジョブのユーザーとグループ

ローカルワーカーエージェントユーザー と を設定するにはjobRunAsUser、次の要件を満たしていることを確認します。Active Directory や LDAP などの Linux Pluggable Authentication Module (PAM) を使用している場合、手順は異なる場合があります。

ワーカーエージェントをインストールすると、ワーカーエージェントユーザーと共有jobRunAsUserグループが設定されます。デフォルトは deadline-worker-agentと ですがdeadline-job-users、ワーカーエージェントをインストールするときに変更できます。

install-deadline-worker \
    --user AGENT_USER_NAME \
    --group JOB_USERS_GROUP

コマンドはルートユーザーとして実行する必要があります。

  • 各 には、一致するプライマリグループjobRunAsUserが必要です。adduser コマンドを使用してユーザーを作成すると、通常、一致するプライマリグループが作成されます。

    adduser -r -m jobRunAsUser

  • のプライマリグループは、ワーカーエージェントユーザーのセカンダリグループjobRunAsUserです。共有グループを使用すると、ワーカーエージェントは実行中にジョブでファイルを使用できるようになります。

    usermod -a -G jobRunAsUser deadline-worker-agent

  • は、共有ジョブグループのメンバーjobRunAsUserである必要があります。

    usermod -a -G deadline-job-users jobRunAsUser

  • jobRunAsUser は、ワーカーエージェントユーザーのプライマリグループに属してはいけません。ワーカーエージェントによって書き込まれた機密ファイルは、エージェントのプライマリグループによって所有されます。jobRunAsUser がこのグループの一部である場合、ワーカーエージェントファイルはワーカーで実行されているジョブからアクセスできる可能性があります。

  • デフォルトは、ワーカーが属するファームのリージョンと一致する AWS リージョン 必要があります。これは、ワーカーのすべてのjobRunAsUserアカウントに適用する必要があります。

    sudo -u jobRunAsUser aws configure set default.region aws-region

  • ワーカーエージェントユーザーは、 としてsudoコマンドを実行できる必要がありますjobRunAsUser。次のコマンドを実行してエディタを開き、新しい sudoers ルールを作成します。

    visudo -f /etc/sudoers.d/deadline-worker-job-user

    ファイルに以下を追加します。

    # Allows the Deadline Cloud worker agent OS user to run commands
 # as the queue OS user without requiring a password.
deadline-worker-agent ALL=(jobRunAsUser) NOPASSWD:ALL

次の図は、エージェントユーザーとフリートに関連付けられたキューのjobRunAsUserユーザーおよびグループの関係を示しています。

エージェントユーザーとキューjobRunAsUser上の の関係の図。

Windows ユーザー

Windows ユーザーを として使用するにはjobRunAsUser、次の要件を満たしている必要があります。

  • すべてのキューjobRunAsUserユーザーが存在している必要があります。

  • パスワードは、キューの JobRunAsUserフィールドで指定されたシークレットの値と一致する必要があります。手順については、「Deadline Cloud ユーザーガイド」の「Deadline Cloud キュー」のステップ 7 を参照してください。 AWS

  • エージェントユーザーは、それらのユーザーとしてログオンできる必要があります。