Files
proxmox/docs/archive/00-meta-pruned/FRAMEWORK_MIGRATION_GUIDES.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

3.6 KiB

Framework Migration Guides

Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation


Date: 2026-01-22
Purpose: Guide migration from individual scripts to unified frameworks


Overview

Five unified frameworks have been created to consolidate 378+ scripts:

  • verify-all.sh - Consolidates 124 verify/check/validate scripts
  • list.sh - Consolidates 18 list/show/get scripts
  • fix-all.sh - Consolidates 93 fix-*.sh scripts
  • configure.sh - Consolidates 41 configure/config scripts
  • deploy.sh - Consolidates 102 deploy/setup/install scripts

1. verify-all.sh Migration Guide

Old Way

./scripts/check-container-services.sh 5000
./scripts/verify-blockscout-port-4000.sh
./scripts/validate-deployment-ml110.sh

New Way

./scripts/verify-all.sh container 5000
./scripts/verify-all.sh blockscout health
./scripts/verify-all.sh all status

Migration Mapping

  • check-*.shverify-all.sh [component] status
  • verify-*.shverify-all.sh [component] [type]
  • validate-*.shverify-all.sh [component] config

2. list.sh Migration Guide

Old Way

./scripts/list-all-vmids-complete.sh
./scripts/list-r630-01-vms.sh
./scripts/show-container-status.sh

New Way

./scripts/list.sh containers
./scripts/list.sh vms r630-01
./scripts/list.sh containers running

Migration Mapping

  • list-*.shlist.sh [type] [filter]
  • show-*.shlist.sh [type] [filter]
  • get-*.shlist.sh [type] [filter]

3. fix-all.sh Migration Guide

Old Way

./scripts/fix-all-blockscout-issues.sh
./scripts/fix-redis-and-start.sh
./scripts/fix-nginx-blockscout-config.sh

New Way

./scripts/fix-all.sh blockscout all
./scripts/fix-all.sh service redis 10120
./scripts/fix-all.sh nginx blockscout --dry-run

Migration Mapping

  • fix-*-service.shfix-all.sh service [service-name]
  • fix-*-network.shfix-all.sh network [vmid]
  • fix-*-config.shfix-all.sh config [file]

4. configure.sh Migration Guide

Old Way

./scripts/configure-container-networks.sh
./scripts/configure-nginx-jwt-auth-simple.sh
./scripts/configure-service-dependencies.sh

New Way

./scripts/configure.sh network setup
./scripts/configure.sh nginx setup
./scripts/configure.sh service dependencies setup

Migration Mapping

  • configure-*.shconfigure.sh [component] [action]
  • config-*.shconfigure.sh [component] [action]

5. deploy.sh Migration Guide

Old Way

./scripts/deploy-to-proxmox-host.sh
./scripts/setup-thirdweb-rpc-nodes.sh
./scripts/install-services-via-enter.sh

New Way

./scripts/deploy.sh infrastructure all
./scripts/deploy.sh rpc thirdweb
./scripts/deploy.sh service postgresql

Migration Mapping

  • deploy-*.shdeploy.sh [component] [options]
  • setup-*.shdeploy.sh [component] setup
  • install-*.shdeploy.sh [component] install

Migration Process

  1. Identify Script Type - Determine which framework it belongs to
  2. Map Parameters - Map old script parameters to framework parameters
  3. Test Framework - Test framework with equivalent parameters
  4. Archive Original - Move original script to archive/consolidated/
  5. Update References - Update any documentation or automation

Automated Migration

Use the migration script:

# Dry run
./scripts/migrate-to-frameworks.sh all --dry-run

# Execute migration
./scripts/migrate-to-frameworks.sh all --execute

Status: Migration guides created, ready for script migration