5.3. カスタムモデルの設定

1. コンテンツパーサーツールをコンピューターにインストールする
2. カスタムモデルトレーニングデータセットを生成する
3. 生成されたトレーニングデータセットを表示する
4. ansible-lint ルール違反を解決する (オプション: ansible-lint 前処理を使用してトレーニングデータセットを生成し、ansible-lint ルール違反を検出した場合)
5. 複数のトレーニングデータセットを 1 つの JSONL ファイルにマージする (オプション: 複数のトレーニングデータセットを生成した場合)

手順

1. 作業ディレクトリーを作成し、venv Python 仮想環境を設定します。

   $ python -m venv ./venv

   $ source ./venv/bin/activate

2. pip リポジトリーから最新バージョンのコンテンツパーサーツールをインストールします。

   $ pip install --upgrade pip

   $ pip install --upgrade ansible-content-parser

3. 以下のいずれかのタスクを実行します。

   • ansible-lint の前処理なしでトレーニングデータセットを生成するには、カスタムモデルトレーニングデータセットの生成 セクションを参照してください。

   • ansible-lint 前処理を使用してトレーニングデータセットを生成するには、最新バージョンの ansible-lint がコンピューターにインストールされていることを確認してください。

     1. コンピューターにインストールされている ansible-lint のバージョンを表示します。

        $ ansible-content-parser --version

        $ ansible-lint --version

        アプリケーションのバージョンとその依存関係のリストが表示されます。

     2. コンテンツパーサーツールでインストールされた ansible-lint のバージョンが、以前にインストールされた ansible-lint のバージョンと同じであることを出力で確認します。インストールされている ansible-lint のバージョンが一致しないと、コンテンツパーサーツールと ansible-lint の結果が矛盾します。

        たとえば、次の出力では、コンテンツパーサーツールのインストールには、以前にインストールされた ansible-lint バージョン 6.13.1 とは一致しない ansible-lint バージョン 6.20.0 が含まれています。

        $ ansible-content-parser --version
        ansible-content-parser 0.0.1 using ansible-lint:6.20.0 ansible-core:2.15.4
        $ ansible-lint --version
        ansible-lint 6.13.1 using ansible 2.15.4
        A new release of ansible-lint is available: 6.13.1  6.20.0

        Copy to Clipboard

     3. ansible-lint のバージョンが一致しない場合は、venv Python 仮想環境を非アクティブ化して、アクティブ化し直します。

        $ deactivate

        $ source ./venv/bin/activate

     4. コンテンツパーサーツールでインストールされた ansible-lint のバージョンが、以前にインストールされた ansible-lint のバージョンと同じであることを確認します。

        $ ansible-content-parser --version

        $ ansible-lint --version

        たとえば、次の出力は、コンピューター上の両方の ansible-lint インストールがバージョン 6.20.0 であることを示しています。

        $ ansible-content-parser --version
        ansible-content-parser 0.0.1 using ansible-lint:6.20.0 ansible-core:2.15.4
        $ ansible-lint --version
        ansible-lint 6.20.0 using ansible-core:2.15.4
        ansible-compat:4.1.10 ruamel-yaml:0.17.32 ruamel-yaml-clib:0.2.7

        Copy to Clipboard

手順

1. コンテンツパーサーツールを実行してトレーニングデータセットを生成します。

   • ansible-lint 前処理を使用する場合: $ ansible-content-parser source output

   • ansible-lint 前処理を使用しない場合: $ ansible-content-parser source output -S

     次の表に、必要なパラメーターをまとめています。

     パラメーター	説明
     source	トレーニングデータセットのソースを指定します。
     output	トレーニングデータセットの出力を指定します。
     -S または --skip-ansible-lint	トレーニングデータセットの生成中に ansible-lint の前処理をスキップするように指定します。

   例: ソースが Github URL https://github.com/ansible/ansible-tower-samples.git で、出力ディレクトリーが /tmp/out の場合、コマンドプロンプトは、
   $ ansible-content-parser https://github.com/ansible/ansible-tower-samples.git/tmp/out のようになります。

2. オプション: 追加情報を含むトレーニングデータセットを生成するには、コンテンツパーサーツールの実行中に次のパラメーターを指定します。

   パラメーター	説明
   --source-license	source ディレクトリーのライセンス情報をトレーニングのデータセットに含めるように指定します。
   --source-description	トレーニングデータセットにソースディレクトリーの説明を含めるように指定します。
   --repo-name	トレーニングデータセットにリポジトリー名を含めるように指定します。リポジトリー名を指定しない場合、コンテンツパーサーツールはソース名からリポジトリー名を自動的に生成します。
   --repo-url	トレーニングデータセットにリポジトリー URL を含めるように指定します。リポジトリー URL を指定しない場合、コンテンツパーサーツールはソース URL からリポジトリー URL を自動的に生成します。
   -v または --verbose	コンソールのログ情報を表示します。

   Github リポジトリー ansible-tower-samples のコマンドプロンプトの例

   $ ansible-content-parser --profile min \
   --source-license undefined \
   --source-description Samples \
   --repo-name ansible-tower-samples \
   --repo-url 'https://github.com/ansible/ansible-tower-samples' \
   git@github.com:ansible/ansible-tower-samples.git /var/tmp/out_dir

   Copy to Clipboard

   Github リポジトリーの ansible-tower-samples 用に生成されたトレーニングデータセットの例

   トレーニングデータセットは、コマンドライン JSON 処理ツールである Jeff Goldblum (jg) でフォーマットされます。

   $ cat out_dir/ftdata.jsonl| jq
   {
   "data_source_description": "Samples",
   "input": "---\n- name: Hello World Sample\n hosts: all\n tasks:\n - name: Hello Message",
   "license": "undefined",
   "module": "debug",
   "output": " debug:\n msg: Hello World!",
   "path": "hello_world.yml",
   "repo_name": "ansible-tower-samples",
   "repo_url": "https://github.com/ansible/ansible-tower-samples"
   }

   Copy to Clipboard

手順

1. コマンドプロンプトを使用して、親ディレクトリーに移動します。
2. 
   find . -name ftdata.json | xargs cat > concatenated.json コマンドを実行して、連結されたファイルを 1 つ作成します。
3. オプション: 識別しやすいように、連結されたファイルの名前を変更します。