Added ansible scripts

arjunsuresh · arjunsuresh · commit a3635e02c05c · 2026-06-21T19:18:29.000+05:30
diff --git a/script/README.md b/script/README.md
@@ -1,6 +1,6 @@
 # MLCommons Automation Scripts
 
-*Last updated: 2026-06-14 16:16:11*
+*Last updated: 2026-06-21 19:18:29*
 
 This directory contains automation scripts for MLPerf benchmarks, AI/ML workflows, and development operations.
 
@@ -348,6 +348,9 @@ This directory contains automation scripts for MLPerf benchmarks, AI/ML workflow
 - **[install-terraform-from-src](install-terraform-from-src/)**
   - install-terraform-from-src
   - Tags: `install`, `terraform`, `from-src`
+- **[run-ansible](run-ansible/)**
+  - run-ansible
+  - Tags: `run`, `ansible`, `remote`, `configuration-management`
 - **[run-terraform](run-terraform/)**
   - run-terraform
   - Tags: `run`, `terraform`
@@ -456,6 +459,9 @@ This directory contains automation scripts for MLPerf benchmarks, AI/ML workflow
 - **[get-android-sdk](get-android-sdk/)**
   - get-android-sdk
   - Tags: `get`, `android`, `sdk`, `android-sdk`
+- **[get-ansible](get-ansible/)**
+  - get-ansible
+  - Tags: `get`, `ansible`, `get-ansible`
 - **[get-apptainer](get-apptainer/)**
   - get-apptainer
   - Tags: `get-apptainer`
@@ -582,6 +588,9 @@ This directory contains automation scripts for MLPerf benchmarks, AI/ML workflow
 - **[get-zendnn](get-zendnn/)**
   - get-zendnn
   - Tags: `get`, `zendnn`, `amd`, `from.src`
+- **[install-ansible-via-pip](install-ansible-via-pip/)**
+  - install-ansible-via-pip
+  - Tags: `install`, `ansible`, `via-pip`
 - **[install-apt-package](install-apt-package/)**
   - install-apt-package
   - Tags: `get`, `install`, `apt-package`, `package`
@@ -1244,8 +1253,8 @@ This directory contains automation scripts for MLPerf benchmarks, AI/ML workflow
 
 ## Statistics
 
-- **Total Scripts**: 366
-- **Categories**: 35
+- **Total Scripts**: 368
+- **Categories**: 34
 
 ## Usage
 
diff --git a/script/get-ansible/README.md b/script/get-ansible/README.md
@@ -0,0 +1,18 @@
+# Get Ansible
+
+This MLC script detects or installs Ansible.
+
+## Usage
+
+```bash
+# Detect ansible (installs if not found)
+mlcr get,ansible
+```
+
+## Exported Environment
+
+| Variable | Description |
+|----------|-------------|
+| `MLC_ANSIBLE_BIN_WITH_PATH` | Full path to ansible-playbook binary |
+| `MLC_ANSIBLE_INSTALLED_PATH` | Directory containing ansible binaries |
+| `MLC_ANSIBLE_VERSION` | Detected ansible version |
diff --git a/script/get-ansible/customize.py b/script/get-ansible/customize.py
@@ -0,0 +1,64 @@
+from mlc import utils
+import os
+
+
+def preprocess(i):
+
+    os_info = i['os_info']
+    env = i['env']
+    recursion_spaces = i['recursion_spaces']
+
+    file_name = 'ansible-playbook.exe' if os_info['platform'] == 'windows' else 'ansible-playbook'
+    env['FILE_NAME'] = file_name
+
+    if 'MLC_ANSIBLE_BIN_WITH_PATH' not in env:
+        r = i['automation'].find_artifact({'file_name': file_name,
+                                           'env': env,
+                                           'os_info': os_info,
+                                           'default_path_env_key': 'PATH',
+                                           'detect_version': True,
+                                           'env_path_key': 'MLC_ANSIBLE_BIN_WITH_PATH',
+                                           'run_script_input': i['run_script_input'],
+                                           'recursion_spaces': recursion_spaces})
+        if r['return'] > 0:
+            if r['return'] == 16:
+                env['MLC_REQUIRE_INSTALL'] = "yes"
+                return {'return': 0}
+            else:
+                return r
+
+    return {'return': 0}
+
+
+def detect_version(i):
+    r = i['automation'].parse_version({'match_text': r'ansible.*?(\d+\.\d+\.\d+)',
+                                       'group_number': 1,
+                                       'env_key': 'MLC_ANSIBLE_VERSION',
+                                       'which_env': i['env']})
+    if r['return'] > 0:
+        return r
+
+    logger = i['automation'].logger
+    version = r['version']
+
+    logger.info(
+        i['recursion_spaces'] +
+        '    Detected version: {}'.format(version))
+    return {'return': 0, 'version': version}
+
+
+def postprocess(i):
+    env = i['env']
+
+    r = detect_version(i)
+    if r['return'] > 0:
+        return r
+
+    version = r['version']
+    found_file_path = env['MLC_ANSIBLE_BIN_WITH_PATH']
+    found_path = os.path.dirname(found_file_path)
+
+    env['MLC_ANSIBLE_INSTALLED_PATH'] = found_path
+    env['MLC_ANSIBLE_CACHE_TAGS'] = 'version-' + version
+
+    return {'return': 0, 'version': version}
diff --git a/script/get-ansible/meta.yaml b/script/get-ansible/meta.yaml
@@ -0,0 +1,30 @@
+alias: get-ansible
+uid: a3b7c9d2e5f84610
+automation_alias: script
+automation_uid: 5b4e0237da074764
+
+# Metadata
+category: Detection or installation of tools and artifacts
+tags:
+- get
+- ansible
+- get-ansible
+
+# Cache
+cache: true
+clean_files: []
+
+# Environment
+new_env_keys:
+- MLC_ANSIBLE_*
+- +PATH
+
+# Dependencies
+deps:
+- tags: get,python3
+
+prehook_deps:
+- enable_if_env:
+    MLC_REQUIRE_INSTALL:
+    - 'yes'
+  tags: install,ansible,via-pip
diff --git a/script/get-ansible/run.bat b/script/get-ansible/run.bat
@@ -0,0 +1,3 @@
+@echo off
+ansible-playbook --version > tmp-ver.out
+IF %ERRORLEVEL% NEQ 0 EXIT /b 1
diff --git a/script/get-ansible/run.sh b/script/get-ansible/run.sh
@@ -0,0 +1,3 @@
+#!/bin/bash
+ansible-playbook --version > tmp-ver.out
+test $? -eq 0 || exit 1
diff --git a/script/install-ansible-via-pip/README.md b/script/install-ansible-via-pip/README.md
@@ -0,0 +1,18 @@
+# Install Ansible via pip
+
+This MLC script installs Ansible using pip.
+
+## Usage
+
+```bash
+# Install latest ansible
+mlcr install,ansible,via-pip
+
+# Install a specific version
+mlcr install,ansible,via-pip --version=9.0
+```
+
+## Dependencies
+
+- Python 3
+- pip
diff --git a/script/install-ansible-via-pip/customize.py b/script/install-ansible-via-pip/customize.py
@@ -0,0 +1,30 @@
+from mlc import utils
+import os
+
+
+def preprocess(i):
+
+    env = i['env']
+
+    package = env.get('MLC_ANSIBLE_PIP_PACKAGE', 'ansible')
+    version = env.get('MLC_ANSIBLE_VERSION_TO_INSTALL', '')
+
+    if version:
+        env['MLC_ANSIBLE_PIP_INSTALL_STRING'] = f'{package}=={version}'
+    else:
+        env['MLC_ANSIBLE_PIP_INSTALL_STRING'] = package
+
+    return {'return': 0}
+
+
+def postprocess(i):
+    env = i['env']
+    import shutil
+
+    ansible_bin = shutil.which('ansible-playbook')
+    if ansible_bin:
+        env['MLC_ANSIBLE_BIN_WITH_PATH'] = ansible_bin
+        env['MLC_ANSIBLE_INSTALLED_PATH'] = os.path.dirname(ansible_bin)
+        env['+PATH'] = [os.path.dirname(ansible_bin)]
+
+    return {'return': 0}
diff --git a/script/install-ansible-via-pip/meta.yaml b/script/install-ansible-via-pip/meta.yaml
@@ -0,0 +1,39 @@
+alias: install-ansible-via-pip
+uid: b4c8d1e7f3a24956
+automation_alias: script
+automation_uid: 5b4e0237da074764
+
+# Metadata
+category: Detection or installation of tools and artifacts
+tags:
+- install
+- ansible
+- via-pip
+
+# Environment
+default_env:
+  MLC_ANSIBLE_PIP_PACKAGE: ansible
+new_env_keys:
+- MLC_ANSIBLE_*
+- +PATH
+
+# Input mapping
+input_mapping:
+  version: MLC_ANSIBLE_VERSION_TO_INSTALL
+
+# Dependencies
+deps:
+- tags: get,python3
+- tags: get,generic-python-lib,_pip
+
+# Versions
+default_version: latest
+versions:
+  latest:
+    env: {}
+  '9.0':
+    env:
+      MLC_ANSIBLE_VERSION_TO_INSTALL: '9.0'
+  '10.0':
+    env:
+      MLC_ANSIBLE_VERSION_TO_INSTALL: '10.0'
diff --git a/script/install-ansible-via-pip/run.bat b/script/install-ansible-via-pip/run.bat
@@ -0,0 +1,9 @@
+@echo off
+
+echo Installing Ansible via pip...
+"%MLC_PYTHON_BIN_WITH_PATH%" -m pip install %MLC_ANSIBLE_PIP_INSTALL_STRING%
+IF %ERRORLEVEL% NEQ 0 EXIT /b 1
+
+echo.
+echo Ansible installed successfully.
+ansible --version
diff --git a/script/install-ansible-via-pip/run.sh b/script/install-ansible-via-pip/run.sh
@@ -0,0 +1,9 @@
+#!/bin/bash
+
+echo "Installing Ansible via pip..."
+${MLC_PYTHON_BIN_WITH_PATH} -m pip install ${MLC_ANSIBLE_PIP_INSTALL_STRING}
+test $? -eq 0 || exit 1
+
+echo ""
+echo "Ansible installed successfully."
+ansible --version
diff --git a/script/run-ansible/README.md b/script/run-ansible/README.md
@@ -0,0 +1,58 @@
+# Run Ansible Playbook
+
+This MLC script runs Ansible playbooks for configuration management and remote automation.
+
+## Usage
+
+```bash
+# Run a playbook against an inventory
+mlcr run,ansible --playbook=path/to/playbook.yml --inventory=path/to/inventory.ini
+
+# Run with extra variables
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --extra_vars="key1=value1 key2=value2"
+
+# Run with sudo (become)
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --become=yes
+
+# Run with specific tags
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --tags=install,configure
+
+# Run with increased verbosity
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --verbosity=vvv
+
+# Run with a specific SSH key
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --private_key=~/.ssh/my_key --user=ubuntu
+
+# Run with vault password file
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --vault_password_file=~/.vault_pass
+
+# Install galaxy requirements before running
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --galaxy_requirements=requirements.yml
+
+# Limit to specific hosts
+mlcr run,ansible --playbook=setup.yml --inventory=hosts.ini --limit=host1,host2
+```
+
+## Input Options
+
+| Option | Description |
+|--------|-------------|
+| `--playbook` | Path to the Ansible playbook YAML file (required) |
+| `--inventory` | Path to the inventory file |
+| `--extra_vars` | Extra variables to pass to the playbook |
+| `--limit` | Limit execution to specific hosts |
+| `--tags` | Only run tasks with these tags |
+| `--skip_tags` | Skip tasks with these tags |
+| `--forks` | Number of parallel processes (default: 5) |
+| `--verbosity` | Verbosity level: v, vv, vvv, or vvvv |
+| `--private_key` | Path to SSH private key |
+| `--user` | Remote SSH user |
+| `--become` | Run with sudo/become |
+| `--vault_password_file` | Path to vault password file |
+| `--config_file` | Path to ansible.cfg |
+| `--roles_path` | Path to additional roles |
+| `--galaxy_requirements` | Path to Galaxy requirements.yml to auto-install |
+
+## Examples
+
+See the `examples/` directory for sample playbooks and inventory files.
diff --git a/script/run-ansible/customize.py b/script/run-ansible/customize.py
diff --git a/script/run-ansible/examples/inventory.ini b/script/run-ansible/examples/inventory.ini
diff --git a/script/run-ansible/examples/setup-host.yml b/script/run-ansible/examples/setup-host.yml
diff --git a/script/run-ansible/meta.yaml b/script/run-ansible/meta.yaml
diff --git a/script/run-ansible/run.sh b/script/run-ansible/run.sh

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+@echo off`
	`2`	`+ansible-playbook --version > tmp-ver.out`
	`3`	`+IF %ERRORLEVEL% NEQ 0 EXIT /b 1`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+#!/bin/bash`
	`2`	`+ansible-playbook --version > tmp-ver.out`
	`3`	`+test $? -eq 0 \|\| exit 1`