Cisco AI Pods Repository Guide

This repository contains automation and runbooks for Cisco AI Pods infrastructure across Intersight, storage, OpenShift, and observability workflows.

Table of Contents

• Cisco AI Pods Repository Guide
  • Table of Contents
  • Overview
  • Primary Workstreams
  • Repository Layout
  • Runbook Documents
  • Environment Preparation
  • Quick Start Workflow
  • Common Commands
  • Troubleshooting and Operations

Overview

Current repository workflows are primarily:

• Python-based automation for Intersight/UCS configuration
• Ansible-based automation for Everpure, OpenShift, and observability integrations

Legacy Terraform references were removed from this guide to reflect the current model.

Primary Workstreams

1. Intersight and UCS deployment

• Guide: intersight/README.md
• Entry point: intersight/deploy_intersight_ucs.py

2. Everpure storage and Portworx

• Guide: everpure/README.md
• Array and Portworx specifics: everpure/README_everpure_arrays.md, everpure/README_portworx.md

3. OpenShift lifecycle modules

• Guide: openshift/README.md

4. Splunk observability integration

• Guide: splunk-ai-pods/README.md

5. NetApp/Trident assets

• Guide: netapp/README.md

Repository Layout

Top-level structure (abbreviated):

Cisco-AI-Pods/
  best_practices/
  everpure/
  intersight/
  netapp/
  openshift/
  playbooks/
  roles/
  schema/
  splunk-ai-pods/
  guide_cisco_ai_pods_runbook.md
  guide_prepare_the_environment.md
  guide_troubleshooting.md
  requirements.txt
  requirements.yaml

Runbook Documents

• Main runbook: guide_cisco_ai_pods_runbook.md
• Environment preparation: guide_prepare_the_environment.md
• Troubleshooting: guide_troubleshooting.md
• Best-practice phases index: best_practices/README.md

Environment Preparation

Prepare tools and dependencies first:

1. Follow guide_prepare_the_environment.md.
2. Install Python dependencies from requirements.txt.
3. Install Ansible collections from requirements.yaml.

Quick Start Workflow

1. Prepare environment and credentials.
2. Run Intersight/UCS automation:

cd intersight
python3 deploy_intersight_ucs.py

3. Run Everpure workflows as needed:

cd everpure
ansible-playbook configure_everpure_arrays.yaml
ansible-playbook create_pure_json.yaml

4. Run OpenShift modules in order documented in openshift/README.md.

5. Deploy observability components if required via splunk-ai-pods/README.md.

Common Commands

Install Python requirements:

python3 -m pip install -r requirements.txt

Install Ansible collections:

ansible-galaxy collection install -r requirements.yaml

Run the Intersight deployment in check mode:

cd intersight
python3 deploy_intersight_ucs.py -c

Troubleshooting and Operations

• Use guide_troubleshooting.md for cross-component triage.
• For component-specific issues, start with the README in the corresponding top-level folder.
• Keep model files and runbook documentation synchronized as workflows evolve.