Update README and add CHANGELOG with initial toolkits summary

This commit is contained in:
Mateusz Suski
2026-05-05 21:47:33 +00:00
parent 76e24796bb
commit 65c7c82f0f
2 changed files with 95 additions and 7 deletions
+39
View File
@@ -0,0 +1,39 @@
# Changelog
## [Initial Version]
### Added
- Repository structure:
- `infra-run`
- `platform-projects`
- `labs`
- Linux operations Bash toolkit:
- healthcheck
- disk usage checks
- service checks
- system reporting
- Disk full incident toolkit:
- disk analysis
- large files detection
- deleted open files detection
- safe cleanup suggestions
- Network troubleshooting script:
- interface, routing, DNS, connectivity checks
- Veritas storage toolkit:
- VxVM disk detection
- diskgroup extension
- volume/filesystem resize
- VCS freeze/unfreeze workflow
- GPFS storage toolkit:
- cluster validation
- NSD planning
- filesystem expansion
- rebalance
- Runbook-style structure and step-based execution.
### Notes
- All scripts default to dry-run where change actions are present.
- Designed for safety and readability.
- No destructive actions without explicit confirmation.
+56 -7
View File
@@ -1,10 +1,59 @@
# Portfolio
Personal infrastructure engineering portfolio focused on Linux operations, automation, monitoring and lab-based infrastructure projects.
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.
Main areas:
- Linux operations automation
- Infrastructure troubleshooting and runbooks
- Monitoring and observability
- Virtualization and clustering
- Kubernetes, Terraform and lab environments
## 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/](./infra-run/scripts/bash/)
General Linux operations scripts for host health checks, disk usage checks, service validation, and system reporting. 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/](./infra-run/scripts/bash/)
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.