blockmine 1.24.0 → 1.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (476) hide show
  1. package/CHANGELOG.md +76 -1
  2. package/README.en.md +427 -0
  3. package/README.md +40 -0
  4. package/backend/package.json +2 -2
  5. package/backend/prisma/migrations/20260328173000_add_plugin_source_ref/migration.sql +2 -0
  6. package/backend/prisma/migrations/migration_lock.toml +2 -2
  7. package/backend/prisma/schema.prisma +2 -0
  8. package/backend/src/ai/plugin-assistant-system-prompt.md +664 -5
  9. package/backend/src/api/routes/apiKeys.js +8 -0
  10. package/backend/src/api/routes/bots.js +271 -9
  11. package/backend/src/api/routes/eventGraphs.js +151 -1
  12. package/backend/src/api/routes/health.js +38 -0
  13. package/backend/src/api/routes/nodeRegistry.js +63 -0
  14. package/backend/src/api/routes/plugins.js +254 -29
  15. package/backend/src/api/routes/servers.js +14 -2
  16. package/backend/src/container.js +11 -8
  17. package/backend/src/core/BotCommandLoader.js +161 -0
  18. package/backend/src/core/BotConnection.js +125 -0
  19. package/backend/src/core/BotEventHandlers.js +234 -0
  20. package/backend/src/core/BotIPCHandler.js +445 -0
  21. package/backend/src/core/BotManager.js +15 -7
  22. package/backend/src/core/BotProcess.js +169 -140
  23. package/backend/src/core/EventGraphManager.js +7 -3
  24. package/backend/src/core/GraphDebugHandler.js +229 -0
  25. package/backend/src/core/GraphDebugIPC.js +117 -0
  26. package/backend/src/core/GraphExecutionEngine.js +545 -978
  27. package/backend/src/core/GraphTraversal.js +80 -0
  28. package/backend/src/core/GraphValidation.js +73 -0
  29. package/backend/src/core/NodeDefinition.js +138 -0
  30. package/backend/src/core/NodeRegistry.js +153 -141
  31. package/backend/src/core/PluginLoader.js +83 -3
  32. package/backend/src/core/PluginManager.js +346 -35
  33. package/backend/src/core/RewindSignal.js +9 -0
  34. package/backend/src/core/config/ConfigValidator.js +72 -0
  35. package/backend/src/core/config/FeatureFlags.js +52 -0
  36. package/backend/src/core/config/__tests__/ConfigValidator.test.js +232 -0
  37. package/backend/src/core/domain/entities/Bot.js +39 -0
  38. package/backend/src/core/domain/entities/Command.js +41 -0
  39. package/backend/src/core/domain/entities/EventGraph.js +39 -0
  40. package/backend/src/core/domain/entities/Plugin.js +45 -0
  41. package/backend/src/core/domain/entities/User.js +40 -0
  42. package/backend/src/core/domain/services/DependencyResolver.js +168 -0
  43. package/backend/src/core/domain/services/GraphValidator.js +117 -0
  44. package/backend/src/core/domain/services/PermissionChecker.js +34 -0
  45. package/backend/src/core/domain/services/__tests__/DependencyResolver.test.js +126 -0
  46. package/backend/src/core/domain/valueObjects/BotConfig.js +27 -0
  47. package/backend/src/core/domain/valueObjects/DependencyGraph.js +86 -0
  48. package/backend/src/core/domain/valueObjects/PluginManifest.js +36 -0
  49. package/backend/src/core/errors/BaseError.js +29 -0
  50. package/backend/src/core/errors/ErrorHandler.js +81 -0
  51. package/backend/src/core/errors/__tests__/ErrorHandler.test.js +188 -0
  52. package/backend/src/core/errors/index.js +68 -0
  53. package/backend/src/core/infrastructure/BatchingUtility.js +66 -0
  54. package/backend/src/core/infrastructure/CircuitBreaker.js +103 -0
  55. package/backend/src/core/infrastructure/ConnectionPool.js +81 -0
  56. package/backend/src/core/infrastructure/RateLimiter.js +64 -0
  57. package/backend/src/core/infrastructure/__tests__/BatchingUtility.test.js +86 -0
  58. package/backend/src/core/infrastructure/__tests__/CircuitBreaker.test.js +156 -0
  59. package/backend/src/core/infrastructure/__tests__/ConnectionPool.test.js +146 -0
  60. package/backend/src/core/infrastructure/__tests__/RateLimiter.test.js +171 -0
  61. package/backend/src/core/ipc/botApiFactory.js +72 -0
  62. package/backend/src/core/ipc/ipcMessageTypes.js +115 -0
  63. package/backend/src/core/logging/AuditLogger.js +61 -0
  64. package/backend/src/core/logging/StructuredLogger.js +80 -0
  65. package/backend/src/core/logging/__tests__/StructuredLogger.test.js +213 -0
  66. package/backend/src/core/logging/index.js +7 -0
  67. package/backend/src/core/metrics/MetricsCollector.js +104 -0
  68. package/backend/src/core/metrics/__tests__/MetricsCollector.test.js +131 -0
  69. package/backend/src/core/node-registries/actionsNodes.js +191 -0
  70. package/backend/src/core/node-registries/arraysNodes.js +152 -0
  71. package/backend/src/core/node-registries/botNodes.js +48 -0
  72. package/backend/src/core/node-registries/containerNodes.js +141 -0
  73. package/backend/src/core/node-registries/dataNodes.js +284 -0
  74. package/backend/src/core/node-registries/debugNodes.js +23 -0
  75. package/backend/src/core/node-registries/eventsNodes.js +223 -0
  76. package/backend/src/core/node-registries/flowNodes.js +151 -0
  77. package/backend/src/core/node-registries/furnaceNodes.js +123 -0
  78. package/backend/src/core/node-registries/index.js +108 -0
  79. package/backend/src/core/node-registries/inventory.js +102 -106
  80. package/backend/src/core/node-registries/logicNodes.js +54 -0
  81. package/backend/src/core/node-registries/mathNodes.js +38 -0
  82. package/backend/src/core/node-registries/navigationNodes.js +109 -0
  83. package/backend/src/core/node-registries/objectsNodes.js +90 -0
  84. package/backend/src/core/node-registries/stringsNodes.js +165 -0
  85. package/backend/src/core/node-registries/timeNodes.js +105 -0
  86. package/backend/src/core/node-registries/typeNodes.js +22 -0
  87. package/backend/src/core/node-registries/usersNodes.js +126 -0
  88. package/backend/src/core/nodes/arrays/shuffle.js +14 -0
  89. package/backend/src/core/nodes/bot/get_name.js +8 -0
  90. package/backend/src/core/nodes/bot/stop_bot.js +5 -0
  91. package/backend/src/core/nodes/container/open.js +101 -111
  92. package/backend/src/core/nodes/data/store_read.js +26 -0
  93. package/backend/src/core/nodes/data/store_write.js +23 -0
  94. package/backend/src/core/nodes/event/call_event.js +31 -0
  95. package/backend/src/core/nodes/event/custom_event.js +8 -0
  96. package/backend/src/core/nodes/flow/timer.js +35 -0
  97. package/backend/src/core/nodes/inventory/drop.js +73 -65
  98. package/backend/src/core/nodes/inventory/equip.js +54 -45
  99. package/backend/src/core/nodes/inventory/select_slot.js +48 -46
  100. package/backend/src/core/nodes/navigation/follow.js +54 -51
  101. package/backend/src/core/nodes/navigation/go_to.js +41 -53
  102. package/backend/src/core/nodes/navigation/go_to_entity.js +65 -69
  103. package/backend/src/core/nodes/navigation/go_to_player.js +65 -70
  104. package/backend/src/core/nodes/navigation/stop.js +17 -26
  105. package/backend/src/core/nodes/users/add_to_group.js +24 -0
  106. package/backend/src/core/nodes/users/check_permission.js +26 -0
  107. package/backend/src/core/nodes/users/remove_from_group.js +24 -0
  108. package/backend/src/core/services/BotIPCMessageRouter.js +337 -0
  109. package/backend/src/core/services/BotLifecycleService.js +43 -450
  110. package/backend/src/core/services/CacheManager.js +83 -23
  111. package/backend/src/core/services/CrashRestartManager.js +42 -0
  112. package/backend/src/core/services/DebugSessionManager.js +114 -12
  113. package/backend/src/core/services/EventGraphService.js +69 -0
  114. package/backend/src/core/services/MinecraftBotManager.js +9 -1
  115. package/backend/src/core/services/PluginManagementService.js +84 -0
  116. package/backend/src/core/services/TestModeContext.js +65 -0
  117. package/backend/src/core/services/__tests__/CacheManager.test.js +168 -0
  118. package/backend/src/core/services.js +1 -11
  119. package/backend/src/core/validation/InputValidator.js +167 -0
  120. package/backend/src/core/validation/__tests__/InputValidator.test.js +296 -0
  121. package/backend/src/real-time/botApi/index.js +1 -1
  122. package/backend/src/real-time/socketHandler.js +26 -0
  123. package/backend/src/server.js +21 -6
  124. package/frontend/dist/assets/browser-ponyfill-D8y0Ty7C.js +2 -0
  125. package/frontend/dist/assets/index-CFJLS0dk.css +32 -0
  126. package/frontend/dist/assets/index-D91UGNMG.js +11260 -0
  127. package/frontend/dist/flags/en.svg +32 -0
  128. package/frontend/dist/flags/ru.svg +5 -0
  129. package/frontend/dist/index.html +2 -2
  130. package/frontend/dist/locales/en/admin.json +100 -0
  131. package/frontend/dist/locales/en/api-keys.json +58 -0
  132. package/frontend/dist/locales/en/bots.json +113 -0
  133. package/frontend/dist/locales/en/common.json +53 -0
  134. package/frontend/dist/locales/en/configuration.json +22 -0
  135. package/frontend/dist/locales/en/console.json +10 -0
  136. package/frontend/dist/locales/en/dashboard.json +85 -0
  137. package/frontend/dist/locales/en/dialogs.json +70 -0
  138. package/frontend/dist/locales/en/event-graphs.json +50 -0
  139. package/frontend/dist/locales/en/graph-store.json +70 -0
  140. package/frontend/dist/locales/en/login.json +36 -0
  141. package/frontend/dist/locales/en/management.json +192 -0
  142. package/frontend/dist/locales/en/minecraft-viewer.json +27 -0
  143. package/frontend/dist/locales/en/nodes.json +1132 -0
  144. package/frontend/dist/locales/en/permissions.json +50 -0
  145. package/frontend/dist/locales/en/plugin-detail.json +69 -0
  146. package/frontend/dist/locales/en/plugins.json +329 -0
  147. package/frontend/dist/locales/en/proxies.json +81 -0
  148. package/frontend/dist/locales/en/servers.json +39 -0
  149. package/frontend/dist/locales/en/setup.json +19 -0
  150. package/frontend/dist/locales/en/sidebar.json +195 -0
  151. package/frontend/dist/locales/en/tasks.json +62 -0
  152. package/frontend/dist/locales/en/visual-editor.json +418 -0
  153. package/frontend/dist/locales/en/websocket.json +86 -0
  154. package/frontend/dist/locales/ru/admin.json +100 -0
  155. package/frontend/dist/locales/ru/api-keys.json +58 -0
  156. package/frontend/dist/locales/ru/bots.json +113 -0
  157. package/frontend/dist/locales/ru/common.json +49 -0
  158. package/frontend/dist/locales/ru/configuration.json +22 -0
  159. package/frontend/dist/locales/ru/console.json +10 -0
  160. package/frontend/dist/locales/ru/dashboard.json +85 -0
  161. package/frontend/dist/locales/ru/dialogs.json +70 -0
  162. package/frontend/dist/locales/ru/event-graphs.json +50 -0
  163. package/frontend/dist/locales/ru/graph-store.json +70 -0
  164. package/frontend/dist/locales/ru/login.json +36 -0
  165. package/frontend/dist/locales/ru/management.json +192 -0
  166. package/frontend/dist/locales/ru/minecraft-viewer.json +30 -0
  167. package/frontend/dist/locales/ru/nodes.json +1131 -0
  168. package/frontend/dist/locales/ru/permissions.json +50 -0
  169. package/frontend/dist/locales/ru/plugin-detail.json +49 -0
  170. package/frontend/dist/locales/ru/plugins.json +209 -0
  171. package/frontend/dist/locales/ru/proxies.json +81 -0
  172. package/frontend/dist/locales/ru/servers.json +39 -0
  173. package/frontend/dist/locales/ru/setup.json +19 -0
  174. package/frontend/dist/locales/ru/sidebar.json +195 -0
  175. package/frontend/dist/locales/ru/tasks.json +62 -0
  176. package/frontend/dist/locales/ru/visual-editor.json +420 -0
  177. package/frontend/dist/locales/ru/websocket.json +86 -0
  178. package/frontend/dist/monacoeditorwork/css.worker.bundle.js +7 -7
  179. package/frontend/dist/monacoeditorwork/html.worker.bundle.js +7 -7
  180. package/frontend/dist/monacoeditorwork/json.worker.bundle.js +7 -7
  181. package/frontend/dist/monacoeditorwork/ts.worker.bundle.js +3 -3
  182. package/frontend/package.json +6 -0
  183. package/nul +12 -0
  184. package/package.json +3 -3
  185. package/screen/3dviewer.png +0 -0
  186. package/screen/console.png +0 -0
  187. package/screen/dashboard.png +0 -0
  188. package/screen/graph_collabe.png +0 -0
  189. package/screen/graph_live_debug.png +0 -0
  190. package/screen/language_selector.png +0 -0
  191. package/screen/management_command.png +0 -0
  192. package/screen/node_debug_trace.png +0 -0
  193. package/screen/plugin_/320/276/320/261/320/267/320/276/321/200.png +0 -0
  194. package/screen/websocket.png +0 -0
  195. package/screen//320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270_/320/276/321/202/320/264/320/265/320/273/321/214/320/275/321/213/321/205_/320/272/320/276/320/274/320/260/320/275/320/264_/320/272/320/260/320/266/320/264/321/203_/320/272/320/276/320/274/320/260/320/275/320/273/320/264/321/203_/320/274/320/276/320/266/320/275/320/276_/320/275/320/260/321/201/321/202/321/200/320/260/320/270/320/262/320/260/321/202/321/214.png +0 -0
  196. package/screen//320/277/320/273/320/260/320/275/320/270/321/200/320/276/320/262/321/211/320/270/320/272_/320/274/320/276/320/266/320/275/320/276_/320/267/320/260/320/264/320/260/320/262/320/260/321/202/321/214_/320/264/320/265/320/271/321/201/321/202/320/262/320/270/321/217_/320/277/320/276_/320/262/321/200/320/265/320/274/320/265/320/275/320/270.png +0 -0
  197. package/.claude/agents/README.md +0 -469
  198. package/.claude/agents/auth-route-debugger.md +0 -118
  199. package/.claude/agents/auth-route-tester.md +0 -93
  200. package/.claude/agents/auto-error-resolver.md +0 -97
  201. package/.claude/agents/build-optimizer.md +0 -236
  202. package/.claude/agents/code-architect.md +0 -34
  203. package/.claude/agents/code-architecture-reviewer.md +0 -83
  204. package/.claude/agents/code-explorer.md +0 -51
  205. package/.claude/agents/code-refactor-master.md +0 -94
  206. package/.claude/agents/code-reviewer.md +0 -46
  207. package/.claude/agents/cost-optimizer.md +0 -134
  208. package/.claude/agents/deployment-orchestrator.md +0 -113
  209. package/.claude/agents/documentation-architect.md +0 -82
  210. package/.claude/agents/frontend-error-fixer.md +0 -77
  211. package/.claude/agents/iac-code-generator.md +0 -71
  212. package/.claude/agents/incident-responder.md +0 -346
  213. package/.claude/agents/infrastructure-architect.md +0 -31
  214. package/.claude/agents/kubernetes-specialist.md +0 -56
  215. package/.claude/agents/migration-planner.md +0 -181
  216. package/.claude/agents/network-architect.md +0 -196
  217. package/.claude/agents/plan-reviewer.md +0 -52
  218. package/.claude/agents/refactor-planner.md +0 -63
  219. package/.claude/agents/security-scanner.md +0 -102
  220. package/.claude/agents/web-research-specialist.md +0 -78
  221. package/.claude/commands/cost-analysis.md +0 -315
  222. package/.claude/commands/dev-docs-update.md +0 -55
  223. package/.claude/commands/dev-docs.md +0 -51
  224. package/.claude/commands/feature-dev.md +0 -125
  225. package/.claude/commands/incident-debug.md +0 -247
  226. package/.claude/commands/infra-plan.md +0 -81
  227. package/.claude/commands/migration-plan.md +0 -478
  228. package/.claude/commands/route-research-for-testing.md +0 -37
  229. package/.claude/commands/security-review.md +0 -66
  230. package/.claude/hooks/CONFIG.md +0 -448
  231. package/.claude/hooks/README.md +0 -163
  232. package/.claude/hooks/SKILL_ACTIVATION_COMPLETE.md +0 -226
  233. package/.claude/hooks/WINDOWS_HOOKS_README.md +0 -151
  234. package/.claude/hooks/add-skill-activation-banners.ts +0 -132
  235. package/.claude/hooks/comprehensive-skill-test.ts +0 -1315
  236. package/.claude/hooks/error-handling-reminder.sh +0 -12
  237. package/.claude/hooks/error-handling-reminder.ts +0 -222
  238. package/.claude/hooks/k8s-manifest-validator.sh +0 -56
  239. package/.claude/hooks/package-lock.json +0 -556
  240. package/.claude/hooks/package.json +0 -16
  241. package/.claude/hooks/post-tool-use-tracker.ps1 +0 -174
  242. package/.claude/hooks/post-tool-use-tracker.sh +0 -183
  243. package/.claude/hooks/security-policy-check.sh +0 -247
  244. package/.claude/hooks/skill-activation-prompt.ps1 +0 -10
  245. package/.claude/hooks/skill-activation-prompt.sh +0 -10
  246. package/.claude/hooks/skill-activation-prompt.ts +0 -141
  247. package/.claude/hooks/stop-build-check-enhanced.sh +0 -130
  248. package/.claude/hooks/terraform-validator.sh +0 -53
  249. package/.claude/hooks/test-input.json +0 -7
  250. package/.claude/hooks/test-skill-activation.ts +0 -427
  251. package/.claude/hooks/trigger-build-resolver.sh +0 -79
  252. package/.claude/hooks/tsc-check.sh +0 -173
  253. package/.claude/hooks/tsconfig.json +0 -19
  254. package/.claude/settings.json +0 -59
  255. package/.claude/settings.local.json +0 -67
  256. package/.claude/skills/README.md +0 -507
  257. package/.claude/skills/api-engineering/SKILL.md +0 -63
  258. package/.claude/skills/api-engineering/resources/api-versioning.md +0 -88
  259. package/.claude/skills/api-engineering/resources/graphql-patterns.md +0 -106
  260. package/.claude/skills/api-engineering/resources/rate-limiting.md +0 -118
  261. package/.claude/skills/api-engineering/resources/rest-api-design.md +0 -105
  262. package/.claude/skills/backend-dev-guidelines/SKILL.md +0 -306
  263. package/.claude/skills/backend-dev-guidelines/resources/architecture-overview.md +0 -451
  264. package/.claude/skills/backend-dev-guidelines/resources/async-and-errors.md +0 -307
  265. package/.claude/skills/backend-dev-guidelines/resources/complete-examples.md +0 -638
  266. package/.claude/skills/backend-dev-guidelines/resources/configuration.md +0 -275
  267. package/.claude/skills/backend-dev-guidelines/resources/database-patterns.md +0 -224
  268. package/.claude/skills/backend-dev-guidelines/resources/middleware-guide.md +0 -213
  269. package/.claude/skills/backend-dev-guidelines/resources/routing-and-controllers.md +0 -756
  270. package/.claude/skills/backend-dev-guidelines/resources/sentry-and-monitoring.md +0 -336
  271. package/.claude/skills/backend-dev-guidelines/resources/services-and-repositories.md +0 -789
  272. package/.claude/skills/backend-dev-guidelines/resources/testing-guide.md +0 -235
  273. package/.claude/skills/backend-dev-guidelines/resources/validation-patterns.md +0 -754
  274. package/.claude/skills/budget-and-cost-management/SKILL.md +0 -850
  275. package/.claude/skills/build-engineering/SKILL.md +0 -431
  276. package/.claude/skills/build-engineering/resources/artifact-repositories.md +0 -72
  277. package/.claude/skills/build-engineering/resources/build-caching.md +0 -96
  278. package/.claude/skills/build-engineering/resources/build-pipelines.md +0 -105
  279. package/.claude/skills/build-engineering/resources/build-security.md +0 -95
  280. package/.claude/skills/build-engineering/resources/build-systems.md +0 -389
  281. package/.claude/skills/build-engineering/resources/compilation-optimization.md +0 -201
  282. package/.claude/skills/build-engineering/resources/dependency-management.md +0 -73
  283. package/.claude/skills/build-engineering/resources/monorepo-builds.md +0 -110
  284. package/.claude/skills/build-engineering/resources/performance-optimization.md +0 -113
  285. package/.claude/skills/build-engineering/resources/reproducible-builds.md +0 -82
  286. package/.claude/skills/cloud-engineering/SKILL.md +0 -675
  287. package/.claude/skills/cloud-engineering/resources/aws-patterns.md +0 -742
  288. package/.claude/skills/cloud-engineering/resources/azure-patterns.md +0 -714
  289. package/.claude/skills/cloud-engineering/resources/cleared-cloud-environments.md +0 -987
  290. package/.claude/skills/cloud-engineering/resources/cloud-cost-optimization.md +0 -757
  291. package/.claude/skills/cloud-engineering/resources/cloud-networking.md +0 -1058
  292. package/.claude/skills/cloud-engineering/resources/cloud-security-tools.md +0 -1530
  293. package/.claude/skills/cloud-engineering/resources/cloud-security.md +0 -990
  294. package/.claude/skills/cloud-engineering/resources/gcp-patterns.md +0 -758
  295. package/.claude/skills/cloud-engineering/resources/migration-strategies.md +0 -820
  296. package/.claude/skills/cloud-engineering/resources/multi-cloud-strategies.md +0 -670
  297. package/.claude/skills/cloud-engineering/resources/oci-patterns.md +0 -1198
  298. package/.claude/skills/cloud-engineering/resources/serverless-patterns.md +0 -795
  299. package/.claude/skills/cloud-engineering/resources/well-architected-frameworks.md +0 -966
  300. package/.claude/skills/cybersecurity/SKILL.md +0 -409
  301. package/.claude/skills/cybersecurity/resources/security-architecture.md +0 -266
  302. package/.claude/skills/database-engineering/SKILL.md +0 -61
  303. package/.claude/skills/database-engineering/resources/backup-and-recovery.md +0 -72
  304. package/.claude/skills/database-engineering/resources/database-replication.md +0 -63
  305. package/.claude/skills/database-engineering/resources/postgresql-fundamentals.md +0 -70
  306. package/.claude/skills/database-engineering/resources/query-optimization.md +0 -68
  307. package/.claude/skills/devsecops/SKILL.md +0 -374
  308. package/.claude/skills/devsecops/resources/ci-cd-security.md +0 -204
  309. package/.claude/skills/devsecops/resources/compliance-automation.md +0 -530
  310. package/.claude/skills/devsecops/resources/compliance-frameworks.md +0 -2322
  311. package/.claude/skills/devsecops/resources/container-security.md +0 -915
  312. package/.claude/skills/devsecops/resources/cspm-integration.md +0 -1440
  313. package/.claude/skills/devsecops/resources/policy-enforcement.md +0 -619
  314. package/.claude/skills/devsecops/resources/secrets-management.md +0 -755
  315. package/.claude/skills/devsecops/resources/security-monitoring.md +0 -146
  316. package/.claude/skills/devsecops/resources/security-scanning.md +0 -887
  317. package/.claude/skills/devsecops/resources/security-testing.md +0 -203
  318. package/.claude/skills/devsecops/resources/supply-chain-security.md +0 -518
  319. package/.claude/skills/devsecops/resources/vulnerability-management.md +0 -481
  320. package/.claude/skills/devsecops/resources/zero-trust-architecture.md +0 -177
  321. package/.claude/skills/documentation-as-code/SKILL.md +0 -323
  322. package/.claude/skills/documentation-as-code/resources/api-documentation.md +0 -90
  323. package/.claude/skills/documentation-as-code/resources/changelog-management.md +0 -79
  324. package/.claude/skills/documentation-as-code/resources/diagram-generation.md +0 -44
  325. package/.claude/skills/documentation-as-code/resources/docs-as-code-workflow.md +0 -99
  326. package/.claude/skills/documentation-as-code/resources/documentation-automation.md +0 -68
  327. package/.claude/skills/documentation-as-code/resources/documentation-sites.md +0 -79
  328. package/.claude/skills/documentation-as-code/resources/markdown-best-practices.md +0 -162
  329. package/.claude/skills/documentation-as-code/resources/openapi-specification.md +0 -77
  330. package/.claude/skills/documentation-as-code/resources/readme-engineering.md +0 -60
  331. package/.claude/skills/documentation-as-code/resources/technical-writing-guide.md +0 -202
  332. package/.claude/skills/engineering-management/SKILL.md +0 -356
  333. package/.claude/skills/engineering-management/resources/career-ladders.md +0 -609
  334. package/.claude/skills/engineering-management/resources/hiring-and-assessment.md +0 -555
  335. package/.claude/skills/engineering-management/resources/one-on-one-guides.md +0 -609
  336. package/.claude/skills/engineering-management/resources/resource-planning.md +0 -557
  337. package/.claude/skills/engineering-management/resources/team-organization-patterns.md +0 -491
  338. package/.claude/skills/engineering-management/resources/technical-interviews.md +0 -474
  339. package/.claude/skills/engineering-operations-management/SKILL.md +0 -817
  340. package/.claude/skills/error-tracking/SKILL.md +0 -379
  341. package/.claude/skills/frontend-design/SKILL.md +0 -42
  342. package/.claude/skills/frontend-dev-guidelines/SKILL.md +0 -403
  343. package/.claude/skills/frontend-dev-guidelines/resources/common-patterns.md +0 -331
  344. package/.claude/skills/frontend-dev-guidelines/resources/complete-examples.md +0 -872
  345. package/.claude/skills/frontend-dev-guidelines/resources/component-patterns.md +0 -502
  346. package/.claude/skills/frontend-dev-guidelines/resources/data-fetching.md +0 -767
  347. package/.claude/skills/frontend-dev-guidelines/resources/file-organization.md +0 -502
  348. package/.claude/skills/frontend-dev-guidelines/resources/loading-and-error-states.md +0 -501
  349. package/.claude/skills/frontend-dev-guidelines/resources/performance.md +0 -406
  350. package/.claude/skills/frontend-dev-guidelines/resources/routing-guide.md +0 -364
  351. package/.claude/skills/frontend-dev-guidelines/resources/styling-guide.md +0 -428
  352. package/.claude/skills/frontend-dev-guidelines/resources/typescript-standards.md +0 -418
  353. package/.claude/skills/general-it-engineering/SKILL.md +0 -393
  354. package/.claude/skills/general-it-engineering/resources/asset-management.md +0 -712
  355. package/.claude/skills/general-it-engineering/resources/automation-orchestration.md +0 -817
  356. package/.claude/skills/general-it-engineering/resources/business-continuity.md +0 -786
  357. package/.claude/skills/general-it-engineering/resources/change-management.md +0 -715
  358. package/.claude/skills/general-it-engineering/resources/enterprise-monitoring.md +0 -729
  359. package/.claude/skills/general-it-engineering/resources/help-desk-operations.md +0 -738
  360. package/.claude/skills/general-it-engineering/resources/incident-service-management.md +0 -834
  361. package/.claude/skills/general-it-engineering/resources/it-governance.md +0 -753
  362. package/.claude/skills/general-it-engineering/resources/itil-framework.md +0 -503
  363. package/.claude/skills/general-it-engineering/resources/service-management.md +0 -669
  364. package/.claude/skills/infrastructure-architecture/SKILL.md +0 -328
  365. package/.claude/skills/infrastructure-architecture/resources/architecture-decision-records.md +0 -505
  366. package/.claude/skills/infrastructure-architecture/resources/architecture-patterns.md +0 -528
  367. package/.claude/skills/infrastructure-architecture/resources/capacity-planning.md +0 -453
  368. package/.claude/skills/infrastructure-architecture/resources/cleared-environment-architecture.md +0 -773
  369. package/.claude/skills/infrastructure-architecture/resources/cost-architecture.md +0 -499
  370. package/.claude/skills/infrastructure-architecture/resources/data-architecture.md +0 -501
  371. package/.claude/skills/infrastructure-architecture/resources/disaster-recovery.md +0 -535
  372. package/.claude/skills/infrastructure-architecture/resources/migration-architecture.md +0 -512
  373. package/.claude/skills/infrastructure-architecture/resources/multi-region-design.md +0 -608
  374. package/.claude/skills/infrastructure-architecture/resources/reference-architectures.md +0 -562
  375. package/.claude/skills/infrastructure-architecture/resources/security-architecture.md +0 -538
  376. package/.claude/skills/infrastructure-architecture/resources/system-design-principles.md +0 -489
  377. package/.claude/skills/infrastructure-architecture/resources/workload-classification.md +0 -1000
  378. package/.claude/skills/infrastructure-strategy/SKILL.md +0 -924
  379. package/.claude/skills/network-engineering/SKILL.md +0 -385
  380. package/.claude/skills/network-engineering/resources/dns-management.md +0 -738
  381. package/.claude/skills/network-engineering/resources/load-balancing.md +0 -820
  382. package/.claude/skills/network-engineering/resources/network-architecture.md +0 -546
  383. package/.claude/skills/network-engineering/resources/network-security.md +0 -921
  384. package/.claude/skills/network-engineering/resources/network-troubleshooting.md +0 -749
  385. package/.claude/skills/network-engineering/resources/routing-switching.md +0 -373
  386. package/.claude/skills/network-engineering/resources/sdn-networking.md +0 -695
  387. package/.claude/skills/network-engineering/resources/service-mesh-networking.md +0 -777
  388. package/.claude/skills/network-engineering/resources/tcp-ip-protocols.md +0 -444
  389. package/.claude/skills/network-engineering/resources/vpn-connectivity.md +0 -672
  390. package/.claude/skills/node-development/SKILL.md +0 -317
  391. package/.claude/skills/observability-engineering/SKILL.md +0 -101
  392. package/.claude/skills/observability-engineering/resources/apm-tools.md +0 -97
  393. package/.claude/skills/observability-engineering/resources/correlation-strategies.md +0 -87
  394. package/.claude/skills/observability-engineering/resources/distributed-tracing.md +0 -98
  395. package/.claude/skills/observability-engineering/resources/logs-aggregation.md +0 -118
  396. package/.claude/skills/observability-engineering/resources/observability-cost-optimization.md +0 -141
  397. package/.claude/skills/observability-engineering/resources/opentelemetry.md +0 -110
  398. package/.claude/skills/platform-engineering/SKILL.md +0 -555
  399. package/.claude/skills/platform-engineering/resources/architecture-overview.md +0 -600
  400. package/.claude/skills/platform-engineering/resources/container-orchestration.md +0 -916
  401. package/.claude/skills/platform-engineering/resources/cost-optimization.md +0 -634
  402. package/.claude/skills/platform-engineering/resources/developer-platforms.md +0 -670
  403. package/.claude/skills/platform-engineering/resources/gitops-automation.md +0 -650
  404. package/.claude/skills/platform-engineering/resources/infrastructure-as-code.md +0 -778
  405. package/.claude/skills/platform-engineering/resources/infrastructure-standards.md +0 -708
  406. package/.claude/skills/platform-engineering/resources/multi-tenancy.md +0 -602
  407. package/.claude/skills/platform-engineering/resources/platform-security.md +0 -711
  408. package/.claude/skills/platform-engineering/resources/resource-management.md +0 -592
  409. package/.claude/skills/platform-engineering/resources/service-mesh.md +0 -628
  410. package/.claude/skills/release-engineering/SKILL.md +0 -393
  411. package/.claude/skills/release-engineering/resources/artifact-management.md +0 -108
  412. package/.claude/skills/release-engineering/resources/build-optimization.md +0 -84
  413. package/.claude/skills/release-engineering/resources/ci-cd-pipelines.md +0 -411
  414. package/.claude/skills/release-engineering/resources/deployment-strategies.md +0 -197
  415. package/.claude/skills/release-engineering/resources/pipeline-security.md +0 -62
  416. package/.claude/skills/release-engineering/resources/progressive-delivery.md +0 -83
  417. package/.claude/skills/release-engineering/resources/release-automation.md +0 -68
  418. package/.claude/skills/release-engineering/resources/release-orchestration.md +0 -77
  419. package/.claude/skills/release-engineering/resources/rollback-strategies.md +0 -66
  420. package/.claude/skills/release-engineering/resources/versioning-strategies.md +0 -59
  421. package/.claude/skills/route-tester/SKILL.md +0 -392
  422. package/.claude/skills/skill-developer/ADVANCED.md +0 -197
  423. package/.claude/skills/skill-developer/HOOK_MECHANISMS.md +0 -306
  424. package/.claude/skills/skill-developer/PATTERNS_LIBRARY.md +0 -152
  425. package/.claude/skills/skill-developer/SKILL.md +0 -430
  426. package/.claude/skills/skill-developer/SKILL_RULES_REFERENCE.md +0 -315
  427. package/.claude/skills/skill-developer/TRIGGER_TYPES.md +0 -305
  428. package/.claude/skills/skill-developer/TROUBLESHOOTING.md +0 -514
  429. package/.claude/skills/skill-rules.json +0 -2989
  430. package/.claude/skills/sre/SKILL.md +0 -464
  431. package/.claude/skills/sre/resources/alerting-best-practices.md +0 -282
  432. package/.claude/skills/sre/resources/capacity-planning.md +0 -226
  433. package/.claude/skills/sre/resources/chaos-engineering.md +0 -193
  434. package/.claude/skills/sre/resources/disaster-recovery.md +0 -232
  435. package/.claude/skills/sre/resources/incident-management.md +0 -436
  436. package/.claude/skills/sre/resources/observability-stack.md +0 -240
  437. package/.claude/skills/sre/resources/on-call-runbooks.md +0 -167
  438. package/.claude/skills/sre/resources/performance-optimization.md +0 -108
  439. package/.claude/skills/sre/resources/reliability-patterns.md +0 -183
  440. package/.claude/skills/sre/resources/slo-sli-sla.md +0 -464
  441. package/.claude/skills/sre/resources/toil-reduction.md +0 -145
  442. package/.claude/skills/systems-engineering/SKILL.md +0 -648
  443. package/.claude/skills/systems-engineering/resources/automation-patterns.md +0 -771
  444. package/.claude/skills/systems-engineering/resources/configuration-management.md +0 -998
  445. package/.claude/skills/systems-engineering/resources/linux-administration.md +0 -672
  446. package/.claude/skills/systems-engineering/resources/networking-fundamentals.md +0 -982
  447. package/.claude/skills/systems-engineering/resources/performance-tuning.md +0 -871
  448. package/.claude/skills/systems-engineering/resources/powershell-scripting.md +0 -482
  449. package/.claude/skills/systems-engineering/resources/security-hardening.md +0 -739
  450. package/.claude/skills/systems-engineering/resources/shell-scripting.md +0 -915
  451. package/.claude/skills/systems-engineering/resources/storage-management.md +0 -628
  452. package/.claude/skills/systems-engineering/resources/system-monitoring.md +0 -787
  453. package/.claude/skills/systems-engineering/resources/troubleshooting-guide.md +0 -753
  454. package/.claude/skills/systems-engineering/resources/windows-administration.md +0 -738
  455. package/.claude/skills/technical-leadership/SKILL.md +0 -728
  456. package/backend/docs/SECRETS_DOCUMENTATION.md +0 -327
  457. package/backend/package-lock.json +0 -6801
  458. package/backend/src/core/node-registries/actions.js +0 -202
  459. package/backend/src/core/node-registries/arrays.js +0 -155
  460. package/backend/src/core/node-registries/bot.js +0 -23
  461. package/backend/src/core/node-registries/container.js +0 -162
  462. package/backend/src/core/node-registries/data.js +0 -290
  463. package/backend/src/core/node-registries/debug.js +0 -26
  464. package/backend/src/core/node-registries/events.js +0 -201
  465. package/backend/src/core/node-registries/flow.js +0 -139
  466. package/backend/src/core/node-registries/furnace.js +0 -143
  467. package/backend/src/core/node-registries/logic.js +0 -62
  468. package/backend/src/core/node-registries/math.js +0 -42
  469. package/backend/src/core/node-registries/navigation.js +0 -111
  470. package/backend/src/core/node-registries/objects.js +0 -98
  471. package/backend/src/core/node-registries/strings.js +0 -187
  472. package/backend/src/core/node-registries/time.js +0 -113
  473. package/backend/src/core/node-registries/type.js +0 -25
  474. package/backend/src/core/node-registries/users.js +0 -79
  475. package/frontend/dist/assets/index-BC-NbKXi.css +0 -32
  476. package/frontend/dist/assets/index-DqJXZMHY.js +0 -11266
@@ -1,757 +0,0 @@
1
- # Cloud Cost Optimization
2
-
3
- Comprehensive guide to optimizing cloud costs through FinOps practices, right-sizing, reserved capacity, spot instances, tagging strategies, and cost monitoring across AWS, Azure, and GCP.
4
-
5
- ## Table of Contents
6
-
7
- - [FinOps Principles](#finops-principles)
8
- - [Cost Visibility](#cost-visibility)
9
- - [Right-Sizing Resources](#right-sizing-resources)
10
- - [Reserved Capacity](#reserved-capacity)
11
- - [Spot and Preemptible Instances](#spot-and-preemptible-instances)
12
- - [Storage Optimization](#storage-optimization)
13
- - [Networking Costs](#networking-costs)
14
- - [Tagging Strategy](#tagging-strategy)
15
- - [Cost Monitoring and Alerts](#cost-monitoring-and-alerts)
16
- - [Best Practices](#best-practices)
17
-
18
- ## FinOps Principles
19
-
20
- ### Three Phases of FinOps
21
-
22
- **1. Inform:**
23
- - Visibility into cloud spending
24
- - Allocation and showback
25
- - Forecasting and budgeting
26
-
27
- **2. Optimize:**
28
- - Right-sizing resources
29
- - Reserved capacity planning
30
- - Waste elimination
31
-
32
- **3. Operate:**
33
- - Continuous optimization
34
- - Automation
35
- - Cultural adoption
36
-
37
- ### Cloud Cost Model
38
-
39
- ```
40
- Total Cloud Cost =
41
- Compute Costs
42
- + Storage Costs
43
- + Network Costs (egress)
44
- + Data Transfer Costs
45
- + Managed Services Costs
46
- + Support Costs
47
- + Licensing Costs
48
- ```
49
-
50
- ## Cost Visibility
51
-
52
- ### AWS Cost Explorer
53
-
54
- **Terraform: Enable Cost Allocation Tags:**
55
- ```hcl
56
- resource "aws_ce_cost_category" "environment" {
57
- name = "Environment"
58
- rule_version = "CostCategoryExpression.v1"
59
-
60
- rule {
61
- value = "Production"
62
- rule {
63
- tags {
64
- key = "Environment"
65
- values = ["production", "prod"]
66
- }
67
- }
68
- }
69
-
70
- rule {
71
- value = "Development"
72
- rule {
73
- tags {
74
- key = "Environment"
75
- values = ["development", "dev"]
76
- }
77
- }
78
- }
79
- }
80
-
81
- # Cost budget with alerts
82
- resource "aws_budgets_budget" "monthly" {
83
- name = "monthly-budget"
84
- budget_type = "COST"
85
- limit_amount = "10000"
86
- limit_unit = "USD"
87
- time_period_start = "2024-01-01_00:00"
88
- time_unit = "MONTHLY"
89
-
90
- cost_filter {
91
- name = "TagKeyValue"
92
- values = [
93
- "user:Environment$production",
94
- ]
95
- }
96
-
97
- notification {
98
- comparison_operator = "GREATER_THAN"
99
- threshold = 80
100
- threshold_type = "PERCENTAGE"
101
- notification_type = "ACTUAL"
102
- subscriber_email_addresses = ["finance@example.com"]
103
- }
104
-
105
- notification {
106
- comparison_operator = "GREATER_THAN"
107
- threshold = 100
108
- threshold_type = "PERCENTAGE"
109
- notification_type = "FORECASTED"
110
- subscriber_email_addresses = ["cto@example.com"]
111
- }
112
- }
113
- ```
114
-
115
- ### Azure Cost Management
116
-
117
- **Example: Budget and Alerts:**
118
- ```hcl
119
- resource "azurerm_consumption_budget_subscription" "monthly" {
120
- name = "monthly-budget"
121
- subscription_id = data.azurerm_subscription.current.id
122
-
123
- amount = 10000
124
- time_grain = "Monthly"
125
-
126
- time_period {
127
- start_date = "2024-01-01T00:00:00Z"
128
- }
129
-
130
- filter {
131
- tag {
132
- name = "Environment"
133
- values = [
134
- "Production",
135
- ]
136
- }
137
- }
138
-
139
- notification {
140
- enabled = true
141
- threshold = 80.0
142
- operator = "GreaterThan"
143
-
144
- contact_emails = [
145
- "finance@example.com",
146
- ]
147
- }
148
-
149
- notification {
150
- enabled = true
151
- threshold = 100.0
152
- operator = "GreaterThan"
153
-
154
- contact_emails = [
155
- "cto@example.com",
156
- ]
157
- }
158
- }
159
- ```
160
-
161
- ### GCP Billing Budgets
162
-
163
- **Example: Budget Alerts:**
164
- ```hcl
165
- resource "google_billing_budget" "monthly" {
166
- billing_account = var.billing_account
167
- display_name = "Monthly Budget"
168
-
169
- budget_filter {
170
- projects = ["projects/${var.project_id}"]
171
-
172
- labels = {
173
- environment = "production"
174
- }
175
- }
176
-
177
- amount {
178
- specified_amount {
179
- currency_code = "USD"
180
- units = "10000"
181
- }
182
- }
183
-
184
- threshold_rules {
185
- threshold_percent = 0.5 # 50%
186
- }
187
-
188
- threshold_rules {
189
- threshold_percent = 0.8 # 80%
190
- }
191
-
192
- threshold_rules {
193
- threshold_percent = 1.0 # 100%
194
- }
195
-
196
- all_updates_rule {
197
- monitoring_notification_channels = [
198
- google_monitoring_notification_channel.email.id,
199
- ]
200
- }
201
- }
202
- ```
203
-
204
- ## Right-Sizing Resources
205
-
206
- ### AWS Compute Optimizer
207
-
208
- **Example: Automated Right-Sizing Script:**
209
- ```python
210
- import boto3
211
- import json
212
-
213
- ce = boto3.client('ce')
214
- ec2 = boto3.client('ec2')
215
- compute_optimizer = boto3.client('compute-optimizer')
216
-
217
- def get_rightsizing_recommendations():
218
- """Get EC2 right-sizing recommendations"""
219
- response = compute_optimizer.get_ec2_instance_recommendations()
220
-
221
- recommendations = []
222
- for recommendation in response['instanceRecommendations']:
223
- instance_id = recommendation['instanceArn'].split('/')[-1]
224
-
225
- current = recommendation['currentInstanceType']
226
- options = recommendation['recommendationOptions']
227
-
228
- if options:
229
- best_option = options[0] # Lowest cost option
230
- estimated_savings = recommendation.get('utilizationMetrics', {})
231
-
232
- recommendations.append({
233
- 'instance_id': instance_id,
234
- 'current_type': current,
235
- 'recommended_type': best_option['instanceType'],
236
- 'monthly_savings': best_option.get('estimatedMonthlySavings', {}).get('value', 0),
237
- 'performance_risk': best_option.get('performanceRisk', 'Unknown')
238
- })
239
-
240
- return recommendations
241
-
242
- def analyze_rds_utilization():
243
- """Analyze RDS utilization for right-sizing"""
244
- cloudwatch = boto3.client('cloudwatch')
245
- rds = boto3.client('rds')
246
-
247
- instances = rds.describe_db_instances()
248
-
249
- for instance in instances['DBInstances']:
250
- db_id = instance['DBInstanceIdentifier']
251
-
252
- # Get CPU utilization
253
- cpu_response = cloudwatch.get_metric_statistics(
254
- Namespace='AWS/RDS',
255
- MetricName='CPUUtilization',
256
- Dimensions=[{'Name': 'DBInstanceIdentifier', 'Value': db_id}],
257
- StartTime=datetime.utcnow() - timedelta(days=30),
258
- EndTime=datetime.utcnow(),
259
- Period=3600,
260
- Statistics=['Average', 'Maximum']
261
- )
262
-
263
- avg_cpu = sum([d['Average'] for d in cpu_response['Datapoints']]) / len(cpu_response['Datapoints'])
264
-
265
- if avg_cpu < 20:
266
- print(f"RDS {db_id} is underutilized (avg CPU: {avg_cpu:.2f}%)")
267
- print(f" Current: {instance['DBInstanceClass']}")
268
- print(f" Consider downsizing")
269
-
270
- # Usage
271
- recommendations = get_rightsizing_recommendations()
272
- for rec in recommendations:
273
- print(f"Instance: {rec['instance_id']}")
274
- print(f" Current: {rec['current_type']}")
275
- print(f" Recommended: {rec['recommended_type']}")
276
- print(f" Monthly Savings: ${rec['monthly_savings']}")
277
- print()
278
- ```
279
-
280
- ## Reserved Capacity
281
-
282
- ### AWS Reserved Instances and Savings Plans
283
-
284
- **Example: Reserved Instance Analysis:**
285
- ```python
286
- import boto3
287
- from datetime import datetime, timedelta
288
-
289
- ce = boto3.client('ce')
290
-
291
- def analyze_ri_opportunities():
292
- """Analyze RI coverage and recommendations"""
293
-
294
- # Get RI coverage
295
- response = ce.get_reservation_coverage(
296
- TimePeriod={
297
- 'Start': (datetime.now() - timedelta(days=30)).strftime('%Y-%m-%d'),
298
- 'End': datetime.now().strftime('%Y-%m-%d')
299
- },
300
- Granularity='MONTHLY',
301
- GroupBy=[
302
- {'Type': 'DIMENSION', 'Key': 'INSTANCE_TYPE'},
303
- ]
304
- )
305
-
306
- print("RI Coverage Analysis:")
307
- for group in response['CoveragesByTime']:
308
- for coverage in group['Groups']:
309
- instance_type = coverage['Attributes']['INSTANCE_TYPE']
310
- coverage_hours = coverage['Coverage']['CoverageHours']
311
-
312
- on_demand_hours = float(coverage_hours['OnDemandHours'])
313
- reserved_hours = float(coverage_hours['ReservedHours'])
314
- total_hours = float(coverage_hours['TotalRunningHours'])
315
-
316
- coverage_pct = (reserved_hours / total_hours * 100) if total_hours > 0 else 0
317
-
318
- print(f"{instance_type}: {coverage_pct:.1f}% covered")
319
- if coverage_pct < 80:
320
- print(f" → Consider purchasing RIs (On-Demand: {on_demand_hours:.0f}h/month)")
321
-
322
- # Get RI purchase recommendations
323
- rec_response = ce.get_reservation_purchase_recommendation(
324
- Service='Amazon Elastic Compute Cloud - Compute',
325
- LookbackPeriodInDays='THIRTY_DAYS',
326
- TermInYears='ONE_YEAR',
327
- PaymentOption='PARTIAL_UPFRONT'
328
- )
329
-
330
- print("\nRI Purchase Recommendations:")
331
- for rec in rec_response['Recommendations']:
332
- details = rec['RecommendationDetails']
333
- print(f"Instance: {details['InstanceDetails']['EC2InstanceDetails']['InstanceType']}")
334
- print(f" Recommended Quantity: {rec['RecommendedNumberOfInstancesToPurchase']}")
335
- print(f" Estimated Monthly Savings: ${rec['EstimatedMonthlySavingsAmount']}")
336
- print(f" Estimated ROI: {rec['EstimatedBreakEvenInMonths']} months")
337
- ```
338
-
339
- **Terraform: Purchase RIs:**
340
- ```hcl
341
- # AWS Reserved Instance
342
- resource "aws_ec2_capacity_reservation" "database" {
343
- instance_type = "r5.2xlarge"
344
- instance_platform = "Linux/UNIX"
345
- availability_zone = "us-east-1a"
346
- instance_count = 2
347
-
348
- # Reserved for 1 year
349
- end_date_type = "limited"
350
- end_date = "2025-12-31T23:59:59Z"
351
-
352
- tags = {
353
- Name = "database-reserved-capacity"
354
- Environment = "production"
355
- }
356
- }
357
- ```
358
-
359
- ### Azure Reserved Instances
360
-
361
- ```hcl
362
- # Azure Reserved VM Instance
363
- resource "azurerm_reservation" "vm" {
364
- name = "production-vm-reservation"
365
- resource_group_name = azurerm_resource_group.main.name
366
-
367
- reservation_order_id = var.reservation_order_id
368
- reserved_resource_type = "VirtualMachines"
369
-
370
- sku_name = "Standard_D4s_v3"
371
- quantity = 10
372
- term = "P1Y" # 1 year
373
-
374
- billing_plan = "Upfront"
375
- scope = "Shared"
376
-
377
- tags = {
378
- Environment = "production"
379
- }
380
- }
381
- ```
382
-
383
- ## Spot and Preemptible Instances
384
-
385
- ### AWS Spot Instances
386
-
387
- **Example: Spot Fleet for Batch Processing:**
388
- ```hcl
389
- resource "aws_spot_fleet_request" "batch" {
390
- iam_fleet_role = aws_iam_role.spot_fleet.arn
391
- allocation_strategy = "lowestPrice"
392
- target_capacity = 10
393
- valid_until = "2025-12-31T23:59:59Z"
394
-
395
- # Multiple instance types for flexibility
396
- launch_specification {
397
- instance_type = "c5.large"
398
- ami = data.aws_ami.amazon_linux_2.id
399
- spot_price = "0.05"
400
- subnet_id = aws_subnet.private[0].id
401
- vpc_security_group_ids = [aws_security_group.batch.id]
402
- iam_instance_profile_arn = aws_iam_instance_profile.batch.arn
403
- user_data = filebase64("${path.module}/userdata.sh")
404
-
405
- tags = {
406
- Name = "batch-processor-spot"
407
- }
408
- }
409
-
410
- launch_specification {
411
- instance_type = "c5.xlarge"
412
- ami = data.aws_ami.amazon_linux_2.id
413
- spot_price = "0.10"
414
- subnet_id = aws_subnet.private[1].id
415
- vpc_security_group_ids = [aws_security_group.batch.id]
416
- iam_instance_profile_arn = aws_iam_instance_profile.batch.arn
417
- }
418
-
419
- launch_specification {
420
- instance_type = "c4.large"
421
- ami = data.aws_ami.amazon_linux_2.id
422
- spot_price = "0.04"
423
- subnet_id = aws_subnet.private[2].id
424
- vpc_security_group_ids = [aws_security_group.batch.id]
425
- iam_instance_profile_arn = aws_iam_instance_profile.batch.arn
426
- }
427
- }
428
- ```
429
-
430
- ### GCP Preemptible VMs
431
-
432
- **Example: Preemptible Instance Group:**
433
- ```hcl
434
- resource "google_compute_instance_template" "preemptible" {
435
- name_prefix = "batch-preemptible-"
436
- machine_type = "n1-standard-4"
437
-
438
- disk {
439
- source_image = "debian-cloud/debian-11"
440
- auto_delete = true
441
- boot = true
442
- }
443
-
444
- scheduling {
445
- preemptible = true
446
- automatic_restart = false
447
- }
448
-
449
- network_interface {
450
- network = google_compute_network.vpc.id
451
- }
452
-
453
- service_account {
454
- email = google_service_account.batch.email
455
- scopes = ["cloud-platform"]
456
- }
457
- }
458
-
459
- resource "google_compute_instance_group_manager" "preemptible" {
460
- name = "batch-preemptible-group"
461
- base_instance_name = "batch"
462
- zone = var.zone
463
- target_size = 10
464
-
465
- version {
466
- instance_template = google_compute_instance_template.preemptible.id
467
- }
468
-
469
- auto_healing_policies {
470
- health_check = google_compute_health_check.batch.id
471
- initial_delay_sec = 300
472
- }
473
- }
474
- ```
475
-
476
- ## Storage Optimization
477
-
478
- ### S3 Intelligent Tiering
479
-
480
- ```hcl
481
- resource "aws_s3_bucket_lifecycle_configuration" "intelligent" {
482
- bucket = aws_s3_bucket.data.id
483
-
484
- rule {
485
- id = "intelligent-tiering"
486
- status = "Enabled"
487
-
488
- transition {
489
- days = 0
490
- storage_class = "INTELLIGENT_TIERING"
491
- }
492
- }
493
-
494
- rule {
495
- id = "glacier-archive"
496
- status = "Enabled"
497
-
498
- filter {
499
- prefix = "archive/"
500
- }
501
-
502
- transition {
503
- days = 90
504
- storage_class = "GLACIER"
505
- }
506
-
507
- transition {
508
- days = 180
509
- storage_class = "DEEP_ARCHIVE"
510
- }
511
-
512
- expiration {
513
- days = 2555 # 7 years
514
- }
515
- }
516
- }
517
-
518
- # S3 Intelligent-Tiering configuration
519
- resource "aws_s3_bucket_intelligent_tiering_configuration" "data" {
520
- bucket = aws_s3_bucket.data.id
521
- name = "EntireDataBucket"
522
-
523
- tiering {
524
- access_tier = "DEEP_ARCHIVE_ACCESS"
525
- days = 180
526
- }
527
-
528
- tiering {
529
- access_tier = "ARCHIVE_ACCESS"
530
- days = 90
531
- }
532
- }
533
- ```
534
-
535
- ## Networking Costs
536
-
537
- ### Minimize Data Transfer
538
-
539
- **Pattern: Keep Data in Same Region:**
540
- ```hcl
541
- # Bad: Cross-region data transfer (expensive)
542
- resource "aws_s3_bucket" "data" {
543
- bucket = "app-data"
544
- region = "us-west-2"
545
- }
546
-
547
- resource "aws_instance" "app" {
548
- availability_zone = "us-east-1a" # Different region!
549
- }
550
-
551
- # Good: Same region
552
- resource "aws_s3_bucket" "data" {
553
- bucket = "app-data"
554
- region = "us-east-1"
555
- }
556
-
557
- resource "aws_instance" "app" {
558
- availability_zone = "us-east-1a" # Same region
559
- }
560
- ```
561
-
562
- ### VPC Endpoints for AWS Services
563
-
564
- ```hcl
565
- # Avoid NAT Gateway charges for S3/DynamoDB access
566
- resource "aws_vpc_endpoint" "s3" {
567
- vpc_id = aws_vpc.main.id
568
- service_name = "com.amazonaws.${var.region}.s3"
569
-
570
- route_table_ids = aws_route_table.private[*].id
571
-
572
- tags = {
573
- Name = "s3-endpoint"
574
- }
575
- }
576
-
577
- resource "aws_vpc_endpoint" "dynamodb" {
578
- vpc_id = aws_vpc.main.id
579
- service_name = "com.amazonaws.${var.region}.dynamodb"
580
-
581
- route_table_ids = aws_route_table.private[*].id
582
- }
583
-
584
- # Interface endpoint for other services
585
- resource "aws_vpc_endpoint" "ec2" {
586
- vpc_id = aws_vpc.main.id
587
- service_name = "com.amazonaws.${var.region}.ec2"
588
- vpc_endpoint_type = "Interface"
589
-
590
- subnet_ids = aws_subnet.private[*].id
591
- security_group_ids = [aws_security_group.vpc_endpoints.id]
592
-
593
- private_dns_enabled = true
594
- }
595
- ```
596
-
597
- ## Tagging Strategy
598
-
599
- ### Comprehensive Tagging Policy
600
-
601
- ```hcl
602
- # Enforce tagging policy
603
- locals {
604
- common_tags = {
605
- Environment = var.environment
606
- Project = var.project_name
607
- ManagedBy = "terraform"
608
- Owner = var.owner
609
- CostCenter = var.cost_center
610
- Application = var.application_name
611
- Compliance = var.compliance_level
612
- DataClass = var.data_classification
613
- }
614
- }
615
-
616
- # Apply to all resources
617
- resource "aws_instance" "app" {
618
- # ... configuration ...
619
-
620
- tags = merge(
621
- local.common_tags,
622
- {
623
- Name = "app-server-${var.environment}"
624
- Role = "application"
625
- }
626
- )
627
- }
628
-
629
- # AWS Organizations tag policy
630
- resource "aws_organizations_policy" "tagging" {
631
- name = "tagging-policy"
632
- description = "Required tags for all resources"
633
- type = "TAG_POLICY"
634
-
635
- content = jsonencode({
636
- tags = {
637
- Environment = {
638
- tag_key = {
639
- "@@assign" = "Environment"
640
- }
641
- tag_value = {
642
- "@@assign" = ["production", "staging", "development"]
643
- }
644
- enforced_for = {
645
- "@@assign" = ["ec2:instance", "rds:db", "s3:bucket"]
646
- }
647
- }
648
- CostCenter = {
649
- tag_key = {
650
- "@@assign" = "CostCenter"
651
- }
652
- enforced_for = {
653
- "@@assign" = ["*"]
654
- }
655
- }
656
- }
657
- })
658
- }
659
- ```
660
-
661
- ## Cost Monitoring and Alerts
662
-
663
- ### CloudWatch Billing Alarms
664
-
665
- ```hcl
666
- resource "aws_cloudwatch_metric_alarm" "billing" {
667
- alarm_name = "billing-alarm-${var.threshold}"
668
- comparison_operator = "GreaterThanThreshold"
669
- evaluation_periods = "1"
670
- metric_name = "EstimatedCharges"
671
- namespace = "AWS/Billing"
672
- period = "21600" # 6 hours
673
- statistic = "Maximum"
674
- threshold = var.threshold
675
- alarm_description = "Billing alarm for $${var.threshold}"
676
- alarm_actions = [aws_sns_topic.billing_alerts.arn]
677
-
678
- dimensions = {
679
- Currency = "USD"
680
- }
681
- }
682
-
683
- resource "aws_sns_topic" "billing_alerts" {
684
- name = "billing-alerts"
685
- }
686
-
687
- resource "aws_sns_topic_subscription" "billing_email" {
688
- topic_arn = aws_sns_topic.billing_alerts.arn
689
- protocol = "email"
690
- endpoint = var.billing_alert_email
691
- }
692
- ```
693
-
694
- ## Best Practices
695
-
696
- ### 1. Implement FinOps Culture
697
- - Make cost everyone's responsibility
698
- - Regular cost reviews with teams
699
- - Celebrate cost optimization wins
700
-
701
- ### 2. Tag Everything
702
- - Enforce tagging policies
703
- - Use cost allocation tags
704
- - Regular tag compliance audits
705
-
706
- ### 3. Right-Size Continuously
707
- - Monitor utilization metrics
708
- - Automated right-sizing recommendations
709
- - Regular review and adjustment
710
-
711
- ### 4. Use Reserved Capacity Wisely
712
- - Analyze usage patterns
713
- - Start with 1-year terms
714
- - Use Savings Plans for flexibility
715
-
716
- ### 5. Leverage Spot/Preemptible
717
- - Fault-tolerant workloads
718
- - Batch processing
719
- - Development environments
720
-
721
- ### 6. Optimize Storage
722
- - Lifecycle policies
723
- - Intelligent tiering
724
- - Delete unused data
725
-
726
- ### 7. Minimize Data Transfer
727
- - Keep data and compute together
728
- - Use CDN for content
729
- - VPC endpoints for AWS services
730
-
731
- ### 8. Monitor and Alert
732
- - Budget alerts
733
- - Anomaly detection
734
- - Regular cost reviews
735
-
736
- ### 9. Automation
737
- - Auto-start/stop development resources
738
- - Automated cleanup
739
- - Policy enforcement
740
-
741
- ### 10. Education
742
- - Train teams on cost awareness
743
- - Share cost dashboards
744
- - Regular cost optimization sessions
745
-
746
- ## Anti-Patterns
747
-
748
- ❌ **No tagging strategy** - Can't track or allocate costs
749
- ❌ **Always-on development environments** - Wasting money 24/7
750
- ❌ **Ignoring reserved capacity** - Paying on-demand premium
751
- ❌ **Over-provisioning** - "Better safe than sorry" mentality
752
- ❌ **No cost monitoring** - Surprise bills
753
- ❌ **Cross-region data transfer** - Expensive egress
754
- ❌ **Not using spot instances** - Missing 70-90% savings
755
- ❌ **Keeping old snapshots** - Storage costs add up
756
- ❌ **No lifecycle policies** - Data never expires
757
- ❌ **Manual cost optimization** - Not scalable