5.3. 配置自定义模型

1. 在机器上安装内容解析程序工具
2. 生成自定义模型培训数据集
3. 查看生成的培训数据集
4. （可选：如果您生成了带有 ansible-lint 预处理和检测到的 ansible-lint 规则违反情况的培训数据，则 解决 ansible-lint 规则违反情况
5. （可选：如果您生成了多个培训数据集），请将多个培训数据集放入单个 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.20.0，它与之前安装的 ansible-lint 版本 6.13.1 不匹配：

        $ 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 Toggle word wrap

     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 Toggle word wrap

流程

1. 运行内容解析程序工具来生成培训数据集：

   • 使用 ansible-lint 预处理 ：$ ansible-content-parser source output

   • 没有 ansible-lint 预处理 ：$ ansible-content-parser source output -S

     下表列出了所需的参数。

     Expand

     参数	描述
     source	指定培训数据集的来源。
     output	指定培训数据集的输出。
     -s 或 --skip-ansible-lint	指定在生成培训数据集时跳过 ansible-lint 预处理。

     Show more

   例如： 如果源是 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. 可选： 要使用其他信息生成培训数据集，请在运行内容解析器工具时指定以下参数。

   Expand

   参数	描述
   --source-license	指定在培训数据集中包含源目录的许可信息。
   --source-description	指定在培训数据集中包含源目录的描述。
   --repo-name	指定在培训数据集中包含存储库名称。如果没有指定存储库名称，则内容解析程序工具会自动从源名称生成。
   --repo-url	指定在培训数据集中包含存储库 URL。如果没有指定存储库 URL，则内容解析程序工具会自动从源 URL 生成它。
   -v or --verbose	显示控制台日志信息。

   Show more

   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 Toggle word wrap

   为 Github 存储库 ansible-tower-samples生成的培训数据集示例

   培训数据集被格式化为 Jeff Goldblum (jg)，它是一个命令行 JSON 处理工具。

   $ 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 Toggle word wrap

流程

1. 使用命令提示符，前往父目录。
2. 运行以下命令来创建单个串联文件：
   find . -name ftdata.json | xargs cat > concatenated.json
3. 可选：重命名串联的文件以便轻松识别。