deco/k8s
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

feature/m-refactor-docs-and-scripts #1

Open
deco wants to merge 9 commits from feature/m-refactor-docs-and-scripts into main
pull from: feature/m-refactor-docs-and-scripts
merge into: deco:main
Conversation 0 Commits 9 Files changed 179 +83340 -1437
deco commented 2025-10-20 05:07:21 +03:00
Owner
Copy link
No description provided. 
Created medium priority refactoring task to:
- Consolidate 11 documentation files into CLAUDE.md
- Organize 11 PowerShell scripts into logical subdirectories
- Clean up obsolete files and temporary reports
- Reorganize YAML configs into configs/ and forgejo/ directories

Created refactoring task index to track code/config organization tasks.

Task includes comprehensive context manifest covering:
- Complete file inventory (56+ files analyzed)
- Documentation redundancy analysis
- Script categorization (maintenance/diagnostics/archive)
- Migration impact and reference dependencies
- Implementation order and risk mitigation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update .gitignore to exclude session runtime files, logs, and backups
- Expand CLAUDE.md with detailed command examples and PowerShell script documentation
- Mark refactor-docs-and-scripts task as in-progress

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Major reorganization to improve maintainability and clarity:

**Directory Structure:**
- Created scripts/ directory with subdirectories:
  - scripts/maintenance/ - 6 primary maintenance scripts
  - scripts/diagnostics/ - 2 diagnostic utilities
  - scripts/archive/ - 3 legacy script versions
- Created configs/ directory for infrastructure YAML files (6 files)
- Created forgejo/ directory for CI/CD worker variants (6 files)
- Moved historical files to one-time/ directory

**Documentation Consolidation:**
- Expanded CLAUDE.md with comprehensive content from:
  - MAINTENANCE-README.md (script documentation)
  - PROJECT_INDEX.md (resource tables)
  - QUICK-START.md (workflow examples)
  - WORKFLOW-GUIDE.md (common scenarios)
  - FIX-SUMMARY.md (historical notes)
- Added sections: Maintenance Workflows, Troubleshooting, Resource Allocation, Security Considerations
- Deleted 7 redundant documentation files: FIX-SUMMARY.md, INDEX.md, MAINTENANCE-README.md, PROJECT_INDEX.md, QUICK-START.md, WORKFLOW-GUIDE.md, reboot-progress.json
- Kept specialized docs: LONGHORN-PDB-TROUBLESHOOTING.md, WORKFLOW-DIAGRAM.md

**Path References Updated:**
- CLAUDE.md: Updated all script and config references to new paths
- restore-services.ps1: Updated Forgejo YAML path to ../../forgejo/
- update-and-reboot-cluster.ps1: Updated help text for new script location

**Result:**
- Repository root cleaned from 56+ files to 4 essential markdown files + 8 directories
- All git history preserved via proper file moves
- Clear separation of concerns: scripts/, configs/, forgejo/, one-time/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Move maintenance scripts to scripts/maintenance/ (shutdown-cluster, startup-cluster, restart-all-media)
- Move diagnostic scripts to scripts/diagnostics/ (quick-status, check-service, test-nfs-connectivity, diagnose-cluster-connection)
- Archive Nov 17 migration scripts to one-time/2025-11-17-migration/ (24 scripts)
- Archive Oct 26 healthcheck scripts to one-time/2025-10-26-healthcheck/
- Delete redundant scripts (quick-restart, auto-fix-cluster, restart-service)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Update CLAUDE.md with post-migration info (TrueNAS IP, Traefik, new paths, node IPs)
- Move migration docs and YAMLs to one-time/2025-11-17-migration/
- Move backup YAMLs to migration-backups/
- Archive claudedocs/ (outdated references)
- Delete files.zip
- Root now has only 4 essential docs: CLAUDE.md, README.md, LONGHORN-PDB-TROUBLESHOOTING.md, WORKFLOW-DIAGRAM.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Archive radarr, sonarr, sabnzbd deployments (now on TrueNAS)
- Update CLAUDE.md to reflect active vs migrated services
- Update resource table and script docs for current services

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Reduced cluster from 5 nodes (3 masters + 2 workers) to 2 nodes (1 master + 1 worker)
- Removed pi-master-02, pi-master-03, pi-worker-02
- Replaced Longhorn distributed storage with k3s local-path provisioner
- Updated all deployment manifests to use local-path StorageClass
- Updated maintenance scripts for 2-node configuration
- Restored all media service data (prowlarr, overseerr, tautulli)
- Forgejo workers now running 2 instances (one per node)
- Simplified architecture: 60% fewer nodes, ~1GB+ RAM saved

Co-Authored-By: Warp <agent@warp.dev>
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feature/m-refactor-docs-and-scripts:feature/m-refactor-docs-and-scripts
git switch feature/m-refactor-docs-and-scripts

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff feature/m-refactor-docs-and-scripts
git switch feature/m-refactor-docs-and-scripts
git rebase main
git switch main
git merge --ff-only feature/m-refactor-docs-and-scripts
git switch feature/m-refactor-docs-and-scripts
git rebase main
git switch main
git merge --no-ff feature/m-refactor-docs-and-scripts
git switch main
git merge --squash feature/m-refactor-docs-and-scripts
git switch main
git merge --ff-only feature/m-refactor-docs-and-scripts
git switch main
git merge feature/m-refactor-docs-and-scripts
git push origin main
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
deco/k8s!1
No description provided.