portfolio/README.md

# Portfolio

This repository demonstrates real-world Linux infrastructure and operations experience through sanitized scripts, runbooks, and project structure. It focuses on production operations, incident response, troubleshooting, automation, and enterprise infrastructure patterns.

## Repository Diagram

```mermaid
flowchart TD
  A["portfolio"] --> B["infra-run"]
  A --> C["platform-projects"]
  A --> D["labs"]
  B --> B1["ansible"]
  B --> B2["docs"]
  B --> B3["runbooks"]
  B --> B4["scripts"]
  B4 --> B41["bash"]
  B4 --> B42["python"]
  C --> C1["storage"]
  C --> C2["clustering"]
  C --> C3["monitoring-zabbix"]
  C --> C4["virtualization"]
  C --> C5["elk-log-analysis"]
  D --> D1["docker"]
  D --> D2["kubernetes"]
  D --> D3["terraform"]
  D --> D4["networking"]
  D --> D5["ci-cd"]
```

## Core Project

### infra-run

`infra-run` is the core operational project in this repository. It contains Linux operations automation, incident response tooling, Bash-based operational scripts, and runbook-style workflows for pre-checks, controlled changes, troubleshooting, and post-change validation.

## Toolkits

### Linux Operations Toolkit

[infra-run/scripts/bash/os-healthcheck/](./infra-run/scripts/bash/os-healthcheck/)

General Linux operations scripts for host health checks, disk usage checks, service validation, system reporting, and first-pass OS-level diagnostics. The toolkit is written for practical operations checks on RHEL, Oracle Linux, and Ubuntu-style systems.

### Disk Full Incident Toolkit

[infra-run/scripts/bash/disk-full/](./infra-run/scripts/bash/disk-full/)

Production-style disk full incident workflow covering filesystem usage, inode pressure, large file discovery, deleted open files, top directory analysis, log cleanup review, and safe cleanup suggestions. The scenario reflects common incidents involving logs, temporary files, deleted files held open by processes, and inode exhaustion.

### Network Troubleshooting

[infra-run/scripts/bash/os-healthcheck/](./infra-run/scripts/bash/os-healthcheck/)

OS-level network diagnostics for interfaces, routes, DNS resolution, gateway reachability, listening sockets, and optional remote connectivity checks. The script is designed for first-pass troubleshooting during Linux operations incidents.

### Veritas Storage Toolkit

[infra-run/scripts/bash/veritas/](./infra-run/scripts/bash/veritas/)

Veritas VxVM and VCS storage expansion workflow covering new LUN detection, VxVM disk initialization, diskgroup extension, volume and filesystem resize, and VCS service group freeze/unfreeze handling. The approach is cluster-safe, dry-run by default, and organized around pre-check, change, and post-check steps.

### GPFS Storage Toolkit

[infra-run/scripts/bash/gpfs/](./infra-run/scripts/bash/gpfs/)

GPFS / IBM Spectrum Scale filesystem expansion workflow covering cluster validation, candidate disk discovery, NSD stanza planning, NSD creation, filesystem expansion, optional rebalance, post-checks, and change reporting.

## Repository Structure

- `infra-run` - core operational automation, scripts, runbooks, and infrastructure operations examples.
- `platform-projects` - larger infrastructure topics including storage, clustering, monitoring, virtualization, and log analysis.
- `labs` - experimentation and lab work for Kubernetes, Terraform, Docker, networking, and CI/CD.

## Design Principles

- Safety first, with dry-run behavior by default.
- Pre-check, change, and post-check workflow.
- Real-world scenarios, not tutorials.
- Minimal but practical tooling.

## Notes

- Scripts are simplified and sanitized for portfolio use.
- Examples are based on real production operations patterns.