@trieungoctam/vibekit 1.0.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.
- package/LICENSE +21 -0
- package/README.md +85 -0
- package/agents/debugger.md +158 -0
- package/agents/docs-manager.md +220 -0
- package/agents/planner.md +129 -0
- package/agents/researcher.md +58 -0
- package/agents/reviewer.md +152 -0
- package/agents/tester.md +126 -0
- package/bin/vibekit.js +18 -0
- package/hooks/lib/ck-config-utils.cjs +831 -0
- package/hooks/lib/colors.cjs +95 -0
- package/hooks/lib/config-counter.cjs +103 -0
- package/hooks/lib/context-builder.cjs +616 -0
- package/hooks/lib/git-info-cache.cjs +143 -0
- package/hooks/lib/hook-logger.cjs +92 -0
- package/hooks/lib/privacy-checker.cjs +297 -0
- package/hooks/lib/project-detector.cjs +474 -0
- package/hooks/lib/scout-checker.cjs +263 -0
- package/hooks/lib/transcript-parser.cjs +181 -0
- package/hooks/post-edit-simplify-reminder.cjs +156 -0
- package/hooks/privacy-block.cjs +166 -0
- package/hooks/scout-block.cjs +147 -0
- package/hooks/session-init.cjs +360 -0
- package/package.json +41 -0
- package/rules/development-rules.md +52 -0
- package/rules/documentation-management.md +121 -0
- package/rules/orchestration-protocol.md +43 -0
- package/rules/primary-workflow.md +57 -0
- package/rules/team-coordination-rules.md +90 -0
- package/skills/ai/agent-browser/SKILL.md +294 -0
- package/skills/ai/agent-browser/references/.gitkeep +0 -0
- package/skills/ai/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
- package/skills/ai/agent-browser/references/browserbase-cloud-setup.md +161 -0
- package/skills/ai/ai-artist/SKILL.md +122 -0
- package/skills/ai/ai-artist/data/awesome-prompts.csv +3592 -0
- package/skills/ai/ai-artist/data/lighting.csv +19 -0
- package/skills/ai/ai-artist/data/nano-banana-templates.csv +17 -0
- package/skills/ai/ai-artist/data/platforms.csv +11 -0
- package/skills/ai/ai-artist/data/styles.csv +26 -0
- package/skills/ai/ai-artist/data/techniques.csv +19 -0
- package/skills/ai/ai-artist/data/use-cases.csv +16 -0
- package/skills/ai/ai-artist/references/advanced-techniques.md +184 -0
- package/skills/ai/ai-artist/references/awesome-nano-banana-pro-prompts.md +8575 -0
- package/skills/ai/ai-artist/references/domain-code.md +66 -0
- package/skills/ai/ai-artist/references/domain-data.md +72 -0
- package/skills/ai/ai-artist/references/domain-marketing.md +66 -0
- package/skills/ai/ai-artist/references/domain-patterns.md +33 -0
- package/skills/ai/ai-artist/references/domain-writing.md +68 -0
- package/skills/ai/ai-artist/references/image-prompting.md +141 -0
- package/skills/ai/ai-artist/references/llm-prompting.md +165 -0
- package/skills/ai/ai-artist/references/nano-banana.md +136 -0
- package/skills/ai/ai-artist/references/reasoning-techniques.md +201 -0
- package/skills/ai/ai-artist/references/validation-workflow.md +117 -0
- package/skills/ai/ai-artist/scripts/core.py +197 -0
- package/skills/ai/ai-artist/scripts/extract_prompts.py +102 -0
- package/skills/ai/ai-artist/scripts/generate.py +370 -0
- package/skills/ai/ai-artist/scripts/search.py +147 -0
- package/skills/ai/ai-multimodal/.env.example +204 -0
- package/skills/ai/ai-multimodal/SKILL.md +110 -0
- package/skills/ai/ai-multimodal/references/audio-processing.md +387 -0
- package/skills/ai/ai-multimodal/references/image-generation.md +939 -0
- package/skills/ai/ai-multimodal/references/music-generation.md +311 -0
- package/skills/ai/ai-multimodal/references/video-analysis.md +515 -0
- package/skills/ai/ai-multimodal/references/video-generation.md +457 -0
- package/skills/ai/ai-multimodal/references/vision-understanding.md +492 -0
- package/skills/ai/ai-multimodal/scripts/.coverage +0 -0
- package/skills/ai/ai-multimodal/scripts/check_setup.py +315 -0
- package/skills/ai/ai-multimodal/scripts/document_converter.py +395 -0
- package/skills/ai/ai-multimodal/scripts/gemini_batch_process.py +1185 -0
- package/skills/ai/ai-multimodal/scripts/media_optimizer.py +506 -0
- package/skills/ai/ai-multimodal/scripts/requirements.txt +26 -0
- package/skills/ai/ai-multimodal/scripts/tests/.coverage +0 -0
- package/skills/ai/ai-multimodal/scripts/tests/requirements.txt +20 -0
- package/skills/ai/ai-multimodal/scripts/tests/test_document_converter.py +74 -0
- package/skills/ai/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -0
- package/skills/ai/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -0
- package/skills/ai/mcp-management/README.md +219 -0
- package/skills/ai/mcp-management/SKILL.md +210 -0
- package/skills/ai/mcp-management/assets/tools.json +3146 -0
- package/skills/ai/mcp-management/references/configuration.md +114 -0
- package/skills/ai/mcp-management/references/gemini-cli-integration.md +221 -0
- package/skills/ai/mcp-management/references/mcp-protocol.md +116 -0
- package/skills/ai/mcp-management/scripts/.env.example +10 -0
- package/skills/ai/mcp-management/scripts/cli.ts +195 -0
- package/skills/ai/mcp-management/scripts/dist/analyze-tools.js +70 -0
- package/skills/ai/mcp-management/scripts/dist/cli.js +160 -0
- package/skills/ai/mcp-management/scripts/dist/mcp-client.js +183 -0
- package/skills/ai/mcp-management/scripts/mcp-client.ts +230 -0
- package/skills/ai/mcp-management/scripts/package.json +20 -0
- package/skills/ai/mcp-management/scripts/tsconfig.json +15 -0
- package/skills/core/brainstorm/SKILL.md +164 -0
- package/skills/core/brainstorm/scripts/frame-template.html +214 -0
- package/skills/core/brainstorm/scripts/helper.js +88 -0
- package/skills/core/brainstorm/scripts/server.cjs +338 -0
- package/skills/core/brainstorm/scripts/start-server.sh +153 -0
- package/skills/core/brainstorm/scripts/stop-server.sh +55 -0
- package/skills/core/brainstorm/spec-document-reviewer-prompt.md +49 -0
- package/skills/core/brainstorm/visual-companion.md +286 -0
- package/skills/core/code-review/SKILL.md +147 -0
- package/skills/core/code-review/references/code-review-reception.md +113 -0
- package/skills/core/code-review/references/codebase-scan-workflow.md +29 -0
- package/skills/core/code-review/references/edge-case-scouting.md +119 -0
- package/skills/core/code-review/references/parallel-review-workflow.md +69 -0
- package/skills/core/code-review/references/requesting-code-review.md +116 -0
- package/skills/core/code-review/references/task-management-reviews.md +140 -0
- package/skills/core/code-review/references/verification-before-completion.md +139 -0
- package/skills/core/cook/README.md +86 -0
- package/skills/core/cook/SKILL.md +113 -0
- package/skills/core/cook/references/intent-detection.md +101 -0
- package/skills/core/cook/references/review-cycle.md +75 -0
- package/skills/core/cook/references/subagent-patterns.md +75 -0
- package/skills/core/cook/references/workflow-steps.md +172 -0
- package/skills/core/debug/SKILL.md +121 -0
- package/skills/core/debug/references/defense-in-depth.md +124 -0
- package/skills/core/debug/references/frontend-verification.md +103 -0
- package/skills/core/debug/references/investigation-methodology.md +101 -0
- package/skills/core/debug/references/log-and-ci-analysis.md +97 -0
- package/skills/core/debug/references/performance-diagnostics.md +113 -0
- package/skills/core/debug/references/reporting-standards.md +122 -0
- package/skills/core/debug/references/root-cause-tracing.md +122 -0
- package/skills/core/debug/references/systematic-debugging.md +102 -0
- package/skills/core/debug/references/task-management-debugging.md +155 -0
- package/skills/core/debug/references/verification.md +123 -0
- package/skills/core/debug/scripts/find-polluter.sh +63 -0
- package/skills/core/debug/scripts/find-polluter.test.md +102 -0
- package/skills/core/execute/SKILL.md +70 -0
- package/skills/core/fix/SKILL.md +111 -0
- package/skills/core/fix/references/complexity-assessment.md +72 -0
- package/skills/core/fix/references/mode-selection.md +46 -0
- package/skills/core/fix/references/parallel-exploration.md +100 -0
- package/skills/core/fix/references/review-cycle.md +77 -0
- package/skills/core/fix/references/skill-activation-matrix.md +78 -0
- package/skills/core/fix/references/task-orchestration.md +103 -0
- package/skills/core/fix/references/workflow-ci.md +28 -0
- package/skills/core/fix/references/workflow-deep.md +122 -0
- package/skills/core/fix/references/workflow-logs.md +72 -0
- package/skills/core/fix/references/workflow-quick.md +59 -0
- package/skills/core/fix/references/workflow-standard.md +111 -0
- package/skills/core/fix/references/workflow-test.md +75 -0
- package/skills/core/fix/references/workflow-types.md +33 -0
- package/skills/core/fix/references/workflow-ui.md +75 -0
- package/skills/core/plan/SKILL.md +145 -0
- package/skills/core/plan/plan-document-reviewer-prompt.md +49 -0
- package/skills/core/subagent-dev/SKILL.md +277 -0
- package/skills/core/subagent-dev/code-quality-reviewer-prompt.md +26 -0
- package/skills/core/subagent-dev/implementer-prompt.md +113 -0
- package/skills/core/subagent-dev/spec-reviewer-prompt.md +61 -0
- package/skills/core/tdd/SKILL.md +371 -0
- package/skills/core/tdd/testing-anti-patterns.md +299 -0
- package/skills/core/test/SKILL.md +109 -0
- package/skills/core/test/references/report-format.md +58 -0
- package/skills/core/test/references/test-execution-workflow.md +103 -0
- package/skills/core/test/references/ui-testing-workflow.md +65 -0
- package/skills/core/verify/SKILL.md +139 -0
- package/skills/dev/backend-dev/SKILL.md +96 -0
- package/skills/dev/backend-dev/references/backend-api-design.md +495 -0
- package/skills/dev/backend-dev/references/backend-architecture.md +454 -0
- package/skills/dev/backend-dev/references/backend-authentication.md +338 -0
- package/skills/dev/backend-dev/references/backend-code-quality.md +659 -0
- package/skills/dev/backend-dev/references/backend-debugging.md +904 -0
- package/skills/dev/backend-dev/references/backend-devops.md +494 -0
- package/skills/dev/backend-dev/references/backend-mindset.md +387 -0
- package/skills/dev/backend-dev/references/backend-performance.md +397 -0
- package/skills/dev/backend-dev/references/backend-security.md +290 -0
- package/skills/dev/backend-dev/references/backend-technologies.md +256 -0
- package/skills/dev/backend-dev/references/backend-testing.md +429 -0
- package/skills/dev/context-engineering/SKILL.md +108 -0
- package/skills/dev/context-engineering/references/context-compression.md +84 -0
- package/skills/dev/context-engineering/references/context-degradation.md +93 -0
- package/skills/dev/context-engineering/references/context-fundamentals.md +75 -0
- package/skills/dev/context-engineering/references/context-optimization.md +82 -0
- package/skills/dev/context-engineering/references/evaluation.md +89 -0
- package/skills/dev/context-engineering/references/memory-systems.md +88 -0
- package/skills/dev/context-engineering/references/multi-agent-patterns.md +90 -0
- package/skills/dev/context-engineering/references/project-development.md +97 -0
- package/skills/dev/context-engineering/references/runtime-awareness.md +202 -0
- package/skills/dev/context-engineering/references/tool-design.md +86 -0
- package/skills/dev/context-engineering/scripts/compression_evaluator.py +349 -0
- package/skills/dev/context-engineering/scripts/context_analyzer.py +317 -0
- package/skills/dev/context-engineering/scripts/tests/test_edge_cases.py +246 -0
- package/skills/dev/databases/SKILL.md +84 -0
- package/skills/dev/databases/analytics.md +198 -0
- package/skills/dev/databases/db-design.md +188 -0
- package/skills/dev/databases/incremental-etl.md +213 -0
- package/skills/dev/databases/references/mongodb-aggregation.md +447 -0
- package/skills/dev/databases/references/mongodb-atlas.md +465 -0
- package/skills/dev/databases/references/mongodb-crud.md +408 -0
- package/skills/dev/databases/references/mongodb-indexing.md +442 -0
- package/skills/dev/databases/references/postgresql-administration.md +594 -0
- package/skills/dev/databases/references/postgresql-performance.md +527 -0
- package/skills/dev/databases/references/postgresql-psql-cli.md +467 -0
- package/skills/dev/databases/references/postgresql-queries.md +475 -0
- package/skills/dev/databases/scripts/.coverage +0 -0
- package/skills/dev/databases/scripts/db_backup.py +502 -0
- package/skills/dev/databases/scripts/db_migrate.py +426 -0
- package/skills/dev/databases/scripts/db_performance_check.py +457 -0
- package/skills/dev/databases/scripts/requirements.txt +20 -0
- package/skills/dev/databases/scripts/tests/coverage-db.json +1 -0
- package/skills/dev/databases/scripts/tests/requirements.txt +4 -0
- package/skills/dev/databases/scripts/tests/test_db_backup.py +340 -0
- package/skills/dev/databases/scripts/tests/test_db_migrate.py +277 -0
- package/skills/dev/databases/scripts/tests/test_db_performance_check.py +370 -0
- package/skills/dev/databases/stacks/bigquery.md +231 -0
- package/skills/dev/databases/stacks/d1_cloudflare.md +137 -0
- package/skills/dev/databases/stacks/mysql.md +216 -0
- package/skills/dev/databases/stacks/postgres.md +235 -0
- package/skills/dev/databases/stacks/sqlite.md +244 -0
- package/skills/dev/databases/transactional.md +176 -0
- package/skills/dev/devops/.env.example +76 -0
- package/skills/dev/devops/SKILL.md +97 -0
- package/skills/dev/devops/references/browser-rendering.md +305 -0
- package/skills/dev/devops/references/cloudflare-d1-kv.md +123 -0
- package/skills/dev/devops/references/cloudflare-platform.md +271 -0
- package/skills/dev/devops/references/cloudflare-r2-storage.md +280 -0
- package/skills/dev/devops/references/cloudflare-workers-advanced.md +312 -0
- package/skills/dev/devops/references/cloudflare-workers-apis.md +309 -0
- package/skills/dev/devops/references/cloudflare-workers-basics.md +418 -0
- package/skills/dev/devops/references/docker-basics.md +297 -0
- package/skills/dev/devops/references/docker-compose.md +292 -0
- package/skills/dev/devops/references/gcloud-platform.md +297 -0
- package/skills/dev/devops/references/gcloud-services.md +304 -0
- package/skills/dev/devops/references/kubernetes-basics.md +99 -0
- package/skills/dev/devops/references/kubernetes-helm-advanced.md +75 -0
- package/skills/dev/devops/references/kubernetes-helm.md +81 -0
- package/skills/dev/devops/references/kubernetes-kubectl.md +74 -0
- package/skills/dev/devops/references/kubernetes-security-advanced.md +98 -0
- package/skills/dev/devops/references/kubernetes-security.md +95 -0
- package/skills/dev/devops/references/kubernetes-troubleshooting-advanced.md +74 -0
- package/skills/dev/devops/references/kubernetes-troubleshooting.md +49 -0
- package/skills/dev/devops/references/kubernetes-workflows-advanced.md +75 -0
- package/skills/dev/devops/references/kubernetes-workflows.md +78 -0
- package/skills/dev/devops/scripts/cloudflare_deploy.py +269 -0
- package/skills/dev/devops/scripts/docker_optimize.py +332 -0
- package/skills/dev/devops/scripts/requirements.txt +20 -0
- package/skills/dev/devops/scripts/tests/requirements.txt +3 -0
- package/skills/dev/devops/scripts/tests/test_cloudflare_deploy.py +285 -0
- package/skills/dev/devops/scripts/tests/test_docker_optimize.py +436 -0
- package/skills/dev/frontend-design/SKILL.md +78 -0
- package/skills/dev/frontend-design/references/ai-multimodal-overview.md +165 -0
- package/skills/dev/frontend-design/references/analysis-best-practices.md +80 -0
- package/skills/dev/frontend-design/references/analysis-prompts.md +141 -0
- package/skills/dev/frontend-design/references/analysis-techniques.md +118 -0
- package/skills/dev/frontend-design/references/animejs.md +396 -0
- package/skills/dev/frontend-design/references/asset-generation.md +337 -0
- package/skills/dev/frontend-design/references/design-extraction-overview.md +71 -0
- package/skills/dev/frontend-design/references/extraction-best-practices.md +141 -0
- package/skills/dev/frontend-design/references/extraction-output-templates.md +162 -0
- package/skills/dev/frontend-design/references/extraction-prompts.md +127 -0
- package/skills/dev/frontend-design/references/technical-accessibility.md +119 -0
- package/skills/dev/frontend-design/references/technical-best-practices.md +97 -0
- package/skills/dev/frontend-design/references/technical-optimization.md +44 -0
- package/skills/dev/frontend-design/references/technical-overview.md +90 -0
- package/skills/dev/frontend-design/references/technical-workflows.md +150 -0
- package/skills/dev/frontend-design/references/visual-analysis-overview.md +95 -0
- package/skills/dev/frontend-design/references/workflow-3d.md +102 -0
- package/skills/dev/frontend-design/references/workflow-describe.md +87 -0
- package/skills/dev/frontend-design/references/workflow-immersive.md +87 -0
- package/skills/dev/frontend-design/references/workflow-quick.md +57 -0
- package/skills/dev/frontend-design/references/workflow-screenshot.md +63 -0
- package/skills/dev/frontend-design/references/workflow-video.md +74 -0
- package/skills/dev/frontend-dev/SKILL.md +400 -0
- package/skills/dev/frontend-dev/resources/common-patterns.md +331 -0
- package/skills/dev/frontend-dev/resources/complete-examples.md +872 -0
- package/skills/dev/frontend-dev/resources/component-patterns.md +502 -0
- package/skills/dev/frontend-dev/resources/data-fetching.md +767 -0
- package/skills/dev/frontend-dev/resources/file-organization.md +502 -0
- package/skills/dev/frontend-dev/resources/loading-and-error-states.md +501 -0
- package/skills/dev/frontend-dev/resources/performance.md +406 -0
- package/skills/dev/frontend-dev/resources/routing-guide.md +364 -0
- package/skills/dev/frontend-dev/resources/styling-guide.md +428 -0
- package/skills/dev/frontend-dev/resources/typescript-standards.md +418 -0
- package/skills/dev/git/SKILL.md +114 -0
- package/skills/dev/git/references/branch-management.md +88 -0
- package/skills/dev/git/references/commit-standards.md +46 -0
- package/skills/dev/git/references/gh-cli-guide.md +109 -0
- package/skills/dev/git/references/safety-protocols.md +69 -0
- package/skills/dev/git/references/workflow-commit.md +58 -0
- package/skills/dev/git/references/workflow-merge.md +48 -0
- package/skills/dev/git/references/workflow-pr.md +58 -0
- package/skills/dev/git/references/workflow-push.md +52 -0
- package/skills/dev/git-worktree/SKILL.md +218 -0
- package/skills/utils/ask/SKILL.md +58 -0
- package/skills/utils/bootstrap/SKILL.md +101 -0
- package/skills/utils/bootstrap/references/shared-phases.md +59 -0
- package/skills/utils/bootstrap/references/workflow-auto.md +52 -0
- package/skills/utils/bootstrap/references/workflow-fast.md +50 -0
- package/skills/utils/bootstrap/references/workflow-full.md +60 -0
- package/skills/utils/bootstrap/references/workflow-parallel.md +59 -0
- package/skills/utils/ck-help/SKILL.md +102 -0
- package/skills/utils/ck-help/scripts/ck-help.py +1321 -0
- package/skills/utils/ck-help/scripts/commands_data.yaml +3 -0
- package/skills/utils/ck-help/scripts/skills_data.yaml +593 -0
- package/skills/utils/copywriting/SKILL.md +94 -0
- package/skills/utils/copywriting/references/copy-formulas.md +150 -0
- package/skills/utils/copywriting/references/cta-patterns.md +168 -0
- package/skills/utils/copywriting/references/email-copy.md +193 -0
- package/skills/utils/copywriting/references/headline-templates.md +140 -0
- package/skills/utils/copywriting/references/landing-page-copy.md +175 -0
- package/skills/utils/copywriting/references/power-words.md +189 -0
- package/skills/utils/copywriting/references/social-media-copy.md +222 -0
- package/skills/utils/copywriting/references/workflow-cro.md +83 -0
- package/skills/utils/copywriting/references/workflow-enhance.md +32 -0
- package/skills/utils/copywriting/references/workflow-fast.md +29 -0
- package/skills/utils/copywriting/references/workflow-good.md +39 -0
- package/skills/utils/copywriting/references/writing-styles.md +247 -0
- package/skills/utils/copywriting/scripts/extract-writing-styles.py +308 -0
- package/skills/utils/copywriting/templates/copy-brief.md +49 -0
- package/skills/utils/docs/SKILL.md +55 -0
- package/skills/utils/docs/references/init-workflow.md +32 -0
- package/skills/utils/docs/references/summarize-workflow.md +18 -0
- package/skills/utils/docs/references/update-workflow.md +59 -0
- package/skills/utils/journal/SKILL.md +11 -0
- package/skills/utils/kanban/SKILL.md +99 -0
- package/skills/utils/preview/SKILL.md +75 -0
- package/skills/utils/preview/references/generation-modes.md +95 -0
- package/skills/utils/preview/references/view-mode.md +42 -0
- package/skills/utils/repomix/SKILL.md +248 -0
- package/skills/utils/repomix/references/configuration.md +211 -0
- package/skills/utils/repomix/references/usage-patterns.md +232 -0
- package/skills/utils/repomix/scripts/.coverage +0 -0
- package/skills/utils/repomix/scripts/README.md +179 -0
- package/skills/utils/repomix/scripts/repomix_batch.py +455 -0
- package/skills/utils/repomix/scripts/repos.example.json +15 -0
- package/skills/utils/repomix/scripts/requirements.txt +15 -0
- package/skills/utils/repomix/scripts/tests/test_repomix_batch.py +531 -0
- package/skills/utils/research/SKILL.md +171 -0
- package/skills/utils/scout/SKILL.md +89 -0
- package/skills/utils/scout/references/external-scouting.md +140 -0
- package/skills/utils/scout/references/internal-scouting.md +119 -0
- package/skills/utils/scout/references/task-management-scouting.md +125 -0
- package/skills/utils/sequential-thinking/.env.example +8 -0
- package/skills/utils/sequential-thinking/README.md +183 -0
- package/skills/utils/sequential-thinking/SKILL.md +95 -0
- package/skills/utils/sequential-thinking/package.json +31 -0
- package/skills/utils/sequential-thinking/references/advanced-strategies.md +79 -0
- package/skills/utils/sequential-thinking/references/advanced-techniques.md +76 -0
- package/skills/utils/sequential-thinking/references/core-patterns.md +95 -0
- package/skills/utils/sequential-thinking/references/examples-api.md +88 -0
- package/skills/utils/sequential-thinking/references/examples-architecture.md +94 -0
- package/skills/utils/sequential-thinking/references/examples-debug.md +90 -0
- package/skills/utils/sequential-thinking/scripts/format-thought.js +159 -0
- package/skills/utils/sequential-thinking/scripts/process-thought.js +236 -0
- package/skills/utils/sequential-thinking/tests/format-thought.test.js +133 -0
- package/skills/utils/sequential-thinking/tests/process-thought.test.js +215 -0
- package/skills/utils/write-skill/SKILL.md +655 -0
- package/skills/utils/write-skill/anthropic-best-practices.md +1150 -0
- package/skills/utils/write-skill/examples/CLAUDE_MD_TESTING.md +189 -0
- package/skills/utils/write-skill/graphviz-conventions.dot +172 -0
- package/skills/utils/write-skill/persuasion-principles.md +187 -0
- package/skills/utils/write-skill/render-graphs.js +168 -0
- package/skills/utils/write-skill/testing-skills-with-subagents.md +384 -0
- package/src/commands/init.js +238 -0
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# Helm Advanced - Templates & Hooks
|
|
2
|
+
|
|
3
|
+
## Template Variables
|
|
4
|
+
```yaml
|
|
5
|
+
# templates/deployment.yaml
|
|
6
|
+
apiVersion: apps/v1
|
|
7
|
+
kind: Deployment
|
|
8
|
+
metadata:
|
|
9
|
+
name: {{ include "mychart.fullname" . }}
|
|
10
|
+
spec:
|
|
11
|
+
replicas: {{ .Values.replicaCount }}
|
|
12
|
+
template:
|
|
13
|
+
spec:
|
|
14
|
+
containers:
|
|
15
|
+
- name: {{ .Chart.Name }}
|
|
16
|
+
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
|
|
17
|
+
{{- if .Values.resources }}
|
|
18
|
+
resources:
|
|
19
|
+
{{- toYaml .Values.resources | nindent 10 }}
|
|
20
|
+
{{- end }}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Helper Templates
|
|
24
|
+
```yaml
|
|
25
|
+
# templates/_helpers.tpl
|
|
26
|
+
{{- define "mychart.fullname" -}}
|
|
27
|
+
{{- printf "%s-%s" .Release.Name .Chart.Name | trunc 63 | trimSuffix "-" }}
|
|
28
|
+
{{- end }}
|
|
29
|
+
|
|
30
|
+
{{- define "mychart.labels" -}}
|
|
31
|
+
app.kubernetes.io/name: {{ .Chart.Name }}
|
|
32
|
+
app.kubernetes.io/instance: {{ .Release.Name }}
|
|
33
|
+
{{- end }}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Hooks
|
|
37
|
+
```yaml
|
|
38
|
+
apiVersion: batch/v1
|
|
39
|
+
kind: Job
|
|
40
|
+
metadata:
|
|
41
|
+
name: "{{ .Release.Name }}-post-install"
|
|
42
|
+
annotations:
|
|
43
|
+
"helm.sh/hook": post-install
|
|
44
|
+
"helm.sh/hook-delete-policy": hook-succeeded
|
|
45
|
+
spec:
|
|
46
|
+
template:
|
|
47
|
+
spec:
|
|
48
|
+
containers:
|
|
49
|
+
- name: post-install
|
|
50
|
+
command: ["/bin/sh", "-c", "echo 'Done'"]
|
|
51
|
+
restartPolicy: Never
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Hook types: `pre-install`, `post-install`, `pre-upgrade`, `post-upgrade`
|
|
55
|
+
|
|
56
|
+
## Packaging
|
|
57
|
+
```bash
|
|
58
|
+
helm package mychart
|
|
59
|
+
helm repo index . --url https://charts.example.com
|
|
60
|
+
helm push mychart-1.0.0.tgz oci://registry.example.com/helm
|
|
61
|
+
helm repo add myrepo https://charts.example.com
|
|
62
|
+
helm install myapp myrepo/mychart
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Commands
|
|
66
|
+
|
|
67
|
+
| Command | Purpose |
|
|
68
|
+
|---------|---------|
|
|
69
|
+
| `helm create` | Create |
|
|
70
|
+
| `helm lint` | Validate |
|
|
71
|
+
| `helm template` | Render |
|
|
72
|
+
| `helm install` | Deploy |
|
|
73
|
+
| `helm upgrade` | Update |
|
|
74
|
+
| `helm rollback` | Revert |
|
|
75
|
+
| `helm uninstall` | Remove |
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Helm Package Management
|
|
2
|
+
|
|
3
|
+
## Core Concepts
|
|
4
|
+
|
|
5
|
+
- **Chart:** Helm package with K8s resource definitions
|
|
6
|
+
- **Repository:** Collection of charts
|
|
7
|
+
- **Release:** Deployed instance of a chart
|
|
8
|
+
- **Values:** Configuration that parameterizes charts
|
|
9
|
+
|
|
10
|
+
## Chart Structure
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
mychart/
|
|
14
|
+
├── Chart.yaml # Metadata
|
|
15
|
+
├── values.yaml # Default values
|
|
16
|
+
├── charts/ # Dependencies
|
|
17
|
+
├── templates/
|
|
18
|
+
│ ├── deployment.yaml
|
|
19
|
+
│ ├── service.yaml
|
|
20
|
+
│ ├── _helpers.tpl # Template helpers
|
|
21
|
+
│ └── NOTES.txt
|
|
22
|
+
└── values.schema.json # Validation (optional)
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Essential Commands
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
helm create mychart # Create chart
|
|
29
|
+
helm lint mychart # Validate
|
|
30
|
+
helm template myrelease ./mychart # Render locally
|
|
31
|
+
helm install myrelease ./mychart --dry-run --debug # Preview
|
|
32
|
+
|
|
33
|
+
helm install myrelease ./mychart
|
|
34
|
+
helm install myrelease ./mychart -f values-prod.yaml
|
|
35
|
+
helm install myrelease ./mychart --set replicaCount=3
|
|
36
|
+
|
|
37
|
+
helm upgrade myrelease ./mychart
|
|
38
|
+
helm rollback myrelease 1
|
|
39
|
+
helm list
|
|
40
|
+
helm uninstall myrelease
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Multi-Environment
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
# Files: values.yaml, values-dev.yaml, values-prod.yaml
|
|
47
|
+
helm install myapp ./mychart -f values.yaml -f values-prod.yaml
|
|
48
|
+
helm install myapp ./mychart --set replicaCount=3 --set image.tag=v1.2.3
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## values.yaml Example
|
|
52
|
+
|
|
53
|
+
```yaml
|
|
54
|
+
replicaCount: 2
|
|
55
|
+
image:
|
|
56
|
+
repository: myapp
|
|
57
|
+
tag: "1.0.0"
|
|
58
|
+
pullPolicy: IfNotPresent
|
|
59
|
+
service:
|
|
60
|
+
type: ClusterIP
|
|
61
|
+
port: 8080
|
|
62
|
+
resources:
|
|
63
|
+
limits: { cpu: 500m, memory: 512Mi }
|
|
64
|
+
requests: { cpu: 250m, memory: 256Mi }
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Dependencies
|
|
68
|
+
|
|
69
|
+
```yaml
|
|
70
|
+
# Chart.yaml
|
|
71
|
+
dependencies:
|
|
72
|
+
- name: postgresql
|
|
73
|
+
version: "12.1.0"
|
|
74
|
+
repository: "https://charts.bitnami.com/bitnami"
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
helm dependency update mychart
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
See `kubernetes-helm-advanced.md` for templates, hooks, and packaging.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# kubectl Essential Commands
|
|
2
|
+
|
|
3
|
+
## Cluster & Node
|
|
4
|
+
```bash
|
|
5
|
+
kubectl cluster-info
|
|
6
|
+
kubectl get nodes
|
|
7
|
+
kubectl describe node <node-name>
|
|
8
|
+
kubectl top nodes
|
|
9
|
+
kubectl drain <node-name> --ignore-daemonsets
|
|
10
|
+
kubectl uncordon <node-name>
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Pod Operations
|
|
14
|
+
```bash
|
|
15
|
+
kubectl get pods -A # All namespaces
|
|
16
|
+
kubectl get pods -o wide # Extended info
|
|
17
|
+
kubectl describe pod <pod-name>
|
|
18
|
+
kubectl logs <pod-name>
|
|
19
|
+
kubectl logs -f <pod-name> # Follow
|
|
20
|
+
kubectl logs --previous <pod-name> # Previous crash
|
|
21
|
+
kubectl exec -it <pod-name> -- /bin/bash
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Deployment
|
|
25
|
+
```bash
|
|
26
|
+
kubectl apply -f manifest.yaml
|
|
27
|
+
kubectl apply -f ./manifests/
|
|
28
|
+
kubectl apply -f manifest.yaml --dry-run=client -o yaml # Preview
|
|
29
|
+
kubectl set image deployment/myapp app=myapp:v2
|
|
30
|
+
kubectl delete -f manifest.yaml
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Service & Network
|
|
34
|
+
```bash
|
|
35
|
+
kubectl port-forward service/myapp 8080:8080
|
|
36
|
+
kubectl get svc
|
|
37
|
+
kubectl exec -it <pod-name> -- curl http://service:8080
|
|
38
|
+
kubectl exec -it <pod-name> -- nslookup kubernetes.default
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Debugging (Get → Describe → Logs)
|
|
42
|
+
```bash
|
|
43
|
+
kubectl get pods -o wide
|
|
44
|
+
kubectl get events -n <ns> --sort-by='.lastTimestamp'
|
|
45
|
+
kubectl describe pod <pod-name>
|
|
46
|
+
kubectl logs <pod-name> -c <container>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Output & Filtering
|
|
50
|
+
```bash
|
|
51
|
+
kubectl get pods -o json
|
|
52
|
+
kubectl get pods -o yaml
|
|
53
|
+
kubectl get pods -l app=myapp,tier=frontend
|
|
54
|
+
kubectl get pods --field-selector=status.phase=Running
|
|
55
|
+
kubectl get pods -w # Watch
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Flags
|
|
59
|
+
|
|
60
|
+
| Flag | Purpose |
|
|
61
|
+
|------|---------|
|
|
62
|
+
| `-n` | Namespace |
|
|
63
|
+
| `-A` | All namespaces |
|
|
64
|
+
| `-o` | Output format |
|
|
65
|
+
| `-l` | Label selector |
|
|
66
|
+
| `-w` | Watch |
|
|
67
|
+
|
|
68
|
+
## Aliases
|
|
69
|
+
```bash
|
|
70
|
+
alias k='kubectl'
|
|
71
|
+
alias kgp='kubectl get pods'
|
|
72
|
+
alias kd='kubectl describe'
|
|
73
|
+
alias kl='kubectl logs'
|
|
74
|
+
```
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# Kubernetes Security Advanced
|
|
2
|
+
|
|
3
|
+
## ClusterRole (cluster-wide)
|
|
4
|
+
|
|
5
|
+
```yaml
|
|
6
|
+
apiVersion: rbac.authorization.k8s.io/v1
|
|
7
|
+
kind: ClusterRole
|
|
8
|
+
metadata:
|
|
9
|
+
name: secret-reader
|
|
10
|
+
rules:
|
|
11
|
+
- apiGroups: [""]
|
|
12
|
+
resources: ["secrets"]
|
|
13
|
+
verbs: ["get"]
|
|
14
|
+
resourceNames: ["app-credentials"] # Restrict to specific
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
apiVersion: rbac.authorization.k8s.io/v1
|
|
18
|
+
kind: ClusterRoleBinding
|
|
19
|
+
metadata:
|
|
20
|
+
name: admin-binding
|
|
21
|
+
subjects:
|
|
22
|
+
- kind: User
|
|
23
|
+
name: admin@example.com
|
|
24
|
+
apiGroup: rbac.authorization.k8s.io
|
|
25
|
+
roleRef:
|
|
26
|
+
kind: ClusterRole
|
|
27
|
+
name: cluster-admin
|
|
28
|
+
apiGroup: rbac.authorization.k8s.io
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Secrets Management
|
|
32
|
+
|
|
33
|
+
```yaml
|
|
34
|
+
apiVersion: v1
|
|
35
|
+
kind: Secret
|
|
36
|
+
metadata:
|
|
37
|
+
name: db-credentials
|
|
38
|
+
type: Opaque
|
|
39
|
+
stringData:
|
|
40
|
+
username: admin
|
|
41
|
+
password: secretpassword
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
### Mount as env
|
|
45
|
+
```yaml
|
|
46
|
+
env:
|
|
47
|
+
- name: DB_PASSWORD
|
|
48
|
+
valueFrom:
|
|
49
|
+
secretKeyRef:
|
|
50
|
+
name: db-credentials
|
|
51
|
+
key: password
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Mount as volume
|
|
55
|
+
```yaml
|
|
56
|
+
volumeMounts:
|
|
57
|
+
- name: secret-volume
|
|
58
|
+
mountPath: /etc/secrets
|
|
59
|
+
readOnly: true
|
|
60
|
+
volumes:
|
|
61
|
+
- name: secret-volume
|
|
62
|
+
secret:
|
|
63
|
+
secretName: db-credentials
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## Allow DNS (Required for most apps)
|
|
67
|
+
|
|
68
|
+
```yaml
|
|
69
|
+
apiVersion: networking.k8s.io/v1
|
|
70
|
+
kind: NetworkPolicy
|
|
71
|
+
metadata:
|
|
72
|
+
name: allow-dns
|
|
73
|
+
spec:
|
|
74
|
+
podSelector: {}
|
|
75
|
+
policyTypes: [Egress]
|
|
76
|
+
egress:
|
|
77
|
+
- to:
|
|
78
|
+
- namespaceSelector:
|
|
79
|
+
matchLabels:
|
|
80
|
+
name: kube-system
|
|
81
|
+
ports:
|
|
82
|
+
- { protocol: UDP, port: 53 }
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## Security Checklist
|
|
86
|
+
|
|
87
|
+
- [ ] RBAC with least-privilege roles
|
|
88
|
+
- [ ] Pod Security Standards (restricted)
|
|
89
|
+
- [ ] Network policies (default-deny + explicit allow)
|
|
90
|
+
- [ ] Run containers as non-root
|
|
91
|
+
- [ ] Read-only root filesystem
|
|
92
|
+
- [ ] Drop all capabilities
|
|
93
|
+
- [ ] Secrets for sensitive data
|
|
94
|
+
- [ ] Image scanning enabled
|
|
95
|
+
- [ ] Private container registry
|
|
96
|
+
- [ ] Resource quotas and limits
|
|
97
|
+
- [ ] Audit logging enabled
|
|
98
|
+
- [ ] Regular credential rotation
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Kubernetes Security
|
|
2
|
+
|
|
3
|
+
## RBAC (Role-Based Access Control)
|
|
4
|
+
|
|
5
|
+
### Role (namespace-scoped)
|
|
6
|
+
```yaml
|
|
7
|
+
apiVersion: rbac.authorization.k8s.io/v1
|
|
8
|
+
kind: Role
|
|
9
|
+
metadata:
|
|
10
|
+
namespace: default
|
|
11
|
+
name: pod-reader
|
|
12
|
+
rules:
|
|
13
|
+
- apiGroups: [""]
|
|
14
|
+
resources: ["pods", "pods/log"]
|
|
15
|
+
verbs: ["get", "list", "watch"]
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
### RoleBinding
|
|
19
|
+
```yaml
|
|
20
|
+
apiVersion: rbac.authorization.k8s.io/v1
|
|
21
|
+
kind: RoleBinding
|
|
22
|
+
metadata:
|
|
23
|
+
name: read-pods
|
|
24
|
+
namespace: default
|
|
25
|
+
subjects:
|
|
26
|
+
- kind: ServiceAccount
|
|
27
|
+
name: my-app-sa
|
|
28
|
+
namespace: default
|
|
29
|
+
roleRef:
|
|
30
|
+
kind: Role
|
|
31
|
+
name: pod-reader
|
|
32
|
+
apiGroup: rbac.authorization.k8s.io
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
### Verify Permissions
|
|
36
|
+
```bash
|
|
37
|
+
kubectl auth can-i get pods --as=system:serviceaccount:default:my-sa
|
|
38
|
+
kubectl get roles,rolebindings -n default
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Pod Security (Restricted)
|
|
42
|
+
|
|
43
|
+
```yaml
|
|
44
|
+
spec:
|
|
45
|
+
securityContext:
|
|
46
|
+
runAsNonRoot: true
|
|
47
|
+
runAsUser: 1000
|
|
48
|
+
seccompProfile:
|
|
49
|
+
type: RuntimeDefault
|
|
50
|
+
containers:
|
|
51
|
+
- name: app
|
|
52
|
+
securityContext:
|
|
53
|
+
allowPrivilegeEscalation: false
|
|
54
|
+
readOnlyRootFilesystem: true
|
|
55
|
+
capabilities:
|
|
56
|
+
drop: ["ALL"]
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Enable on namespace:
|
|
60
|
+
```bash
|
|
61
|
+
kubectl label namespace default \
|
|
62
|
+
pod-security.kubernetes.io/enforce=restricted
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Network Policies
|
|
66
|
+
|
|
67
|
+
### Default Deny
|
|
68
|
+
```yaml
|
|
69
|
+
apiVersion: networking.k8s.io/v1
|
|
70
|
+
kind: NetworkPolicy
|
|
71
|
+
metadata:
|
|
72
|
+
name: default-deny-all
|
|
73
|
+
spec:
|
|
74
|
+
podSelector: {}
|
|
75
|
+
policyTypes: [Ingress, Egress]
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Allow Specific
|
|
79
|
+
```yaml
|
|
80
|
+
apiVersion: networking.k8s.io/v1
|
|
81
|
+
kind: NetworkPolicy
|
|
82
|
+
metadata:
|
|
83
|
+
name: allow-frontend-to-backend
|
|
84
|
+
spec:
|
|
85
|
+
podSelector:
|
|
86
|
+
matchLabels: { app: backend }
|
|
87
|
+
ingress:
|
|
88
|
+
- from:
|
|
89
|
+
- podSelector:
|
|
90
|
+
matchLabels: { app: frontend }
|
|
91
|
+
ports:
|
|
92
|
+
- { protocol: TCP, port: 8080 }
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
See `kubernetes-security-advanced.md` for secrets, ClusterRoles, and checklist.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Kubernetes Troubleshooting Advanced
|
|
2
|
+
|
|
3
|
+
## Node Issues
|
|
4
|
+
```bash
|
|
5
|
+
kubectl describe node <node-name> | grep -A 5 "Conditions:"
|
|
6
|
+
kubectl top node <node-name>
|
|
7
|
+
kubectl top pods -A --sort-by=memory
|
|
8
|
+
kubectl drain <node-name> --ignore-daemonsets
|
|
9
|
+
kubectl uncordon <node-name>
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## CrashLoopBackOff
|
|
13
|
+
```bash
|
|
14
|
+
kubectl logs <pod-name> --previous
|
|
15
|
+
kubectl describe pod <pod-name>
|
|
16
|
+
kubectl get pod <pod-name> -o yaml | grep -A 5 resources:
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## HPA
|
|
20
|
+
```yaml
|
|
21
|
+
apiVersion: autoscaling/v2
|
|
22
|
+
kind: HorizontalPodAutoscaler
|
|
23
|
+
spec:
|
|
24
|
+
scaleTargetRef:
|
|
25
|
+
apiVersion: apps/v1
|
|
26
|
+
kind: Deployment
|
|
27
|
+
name: myapp
|
|
28
|
+
minReplicas: 2
|
|
29
|
+
maxReplicas: 10
|
|
30
|
+
metrics:
|
|
31
|
+
- type: Resource
|
|
32
|
+
resource:
|
|
33
|
+
name: cpu
|
|
34
|
+
target:
|
|
35
|
+
type: Utilization
|
|
36
|
+
averageUtilization: 70
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Anti-Patterns
|
|
40
|
+
|
|
41
|
+
**Using `latest` tag:**
|
|
42
|
+
```yaml
|
|
43
|
+
# ❌ image: myapp:latest
|
|
44
|
+
# ✅ image: myapp:v1.2.3
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
**Missing resources:**
|
|
48
|
+
```yaml
|
|
49
|
+
# ✅ Always set
|
|
50
|
+
resources:
|
|
51
|
+
requests: { memory: "256Mi", cpu: "250m" }
|
|
52
|
+
limits: { memory: "512Mi", cpu: "500m" }
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**Missing health checks:**
|
|
56
|
+
```yaml
|
|
57
|
+
livenessProbe:
|
|
58
|
+
httpGet: { path: /health, port: 8080 }
|
|
59
|
+
readinessProbe:
|
|
60
|
+
httpGet: { path: /ready, port: 8080 }
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**Running as root:**
|
|
64
|
+
```yaml
|
|
65
|
+
securityContext:
|
|
66
|
+
runAsNonRoot: true
|
|
67
|
+
runAsUser: 1000
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Monitoring
|
|
71
|
+
```bash
|
|
72
|
+
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
|
|
73
|
+
helm install prometheus prometheus-community/kube-prometheus-stack -n monitoring
|
|
74
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Kubernetes Troubleshooting
|
|
2
|
+
|
|
3
|
+
## Debugging Workflow
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
# 1. Overview
|
|
7
|
+
kubectl get pods -o wide
|
|
8
|
+
kubectl get events -n <namespace> --sort-by='.lastTimestamp'
|
|
9
|
+
|
|
10
|
+
# 2. Details
|
|
11
|
+
kubectl describe pod <pod-name>
|
|
12
|
+
|
|
13
|
+
# 3. Logs
|
|
14
|
+
kubectl logs <pod-name>
|
|
15
|
+
kubectl logs <pod-name> --previous # Crashed instance
|
|
16
|
+
kubectl logs <pod-name> -c <container>
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Common Pod States
|
|
20
|
+
|
|
21
|
+
| State | Cause | Solution |
|
|
22
|
+
|-------|-------|----------|
|
|
23
|
+
| Pending | No node resources | Check node capacity |
|
|
24
|
+
| ContainerCreating | Image pulling | Check image URI |
|
|
25
|
+
| CrashLoopBackOff | Container exits | Check logs, health checks |
|
|
26
|
+
| ImagePullBackOff | Failed image pull | Verify credentials |
|
|
27
|
+
| OOMKilled (137) | Out of memory | Increase memory limit |
|
|
28
|
+
|
|
29
|
+
## Service & Network
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
kubectl exec -it <pod-name> -- nslookup kubernetes.default
|
|
33
|
+
kubectl exec -it <pod-name> -- curl http://myservice:8080
|
|
34
|
+
kubectl get endpoints <service-name>
|
|
35
|
+
kubectl port-forward service/myservice 8080:8080
|
|
36
|
+
kubectl get networkpolicies -A
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Quick Fixes
|
|
40
|
+
|
|
41
|
+
| Problem | Command |
|
|
42
|
+
|---------|---------|
|
|
43
|
+
| Pod stuck | `kubectl delete pod <name> --grace-period=0 --force` |
|
|
44
|
+
| High CPU | `kubectl top pods -A --sort-by=cpu` |
|
|
45
|
+
| High memory | `kubectl top pods -A --sort-by=memory` |
|
|
46
|
+
| Restart | `kubectl rollout restart deployment/<name>` |
|
|
47
|
+
| Rollback | `kubectl rollout undo deployment/<name>` |
|
|
48
|
+
|
|
49
|
+
See `kubernetes-troubleshooting-advanced.md` for node issues, HPA, anti-patterns.
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# Kubernetes Workflows Advanced
|
|
2
|
+
|
|
3
|
+
## CI/CD Pipeline
|
|
4
|
+
```yaml
|
|
5
|
+
# GitHub Actions
|
|
6
|
+
name: Build and Deploy
|
|
7
|
+
on:
|
|
8
|
+
push:
|
|
9
|
+
branches: [main]
|
|
10
|
+
|
|
11
|
+
jobs:
|
|
12
|
+
build:
|
|
13
|
+
runs-on: ubuntu-latest
|
|
14
|
+
steps:
|
|
15
|
+
- uses: actions/checkout@v3
|
|
16
|
+
- run: docker build . -t $REGISTRY/$IMAGE:${{ github.sha }}
|
|
17
|
+
- run: docker push $REGISTRY/$IMAGE:${{ github.sha }}
|
|
18
|
+
|
|
19
|
+
deploy:
|
|
20
|
+
needs: build
|
|
21
|
+
steps:
|
|
22
|
+
- uses: actions/checkout@v3
|
|
23
|
+
with:
|
|
24
|
+
repository: myorg/gitops-repo
|
|
25
|
+
token: ${{ secrets.GITOPS_TOKEN }}
|
|
26
|
+
- run: |
|
|
27
|
+
sed -i 's|image:.*|image: $REGISTRY/$IMAGE:${{ github.sha }}|' k8s/deployment.yaml
|
|
28
|
+
git commit -am "Update image" && git push
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Kustomize
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
kustomize/
|
|
35
|
+
├── base/
|
|
36
|
+
│ ├── kustomization.yaml
|
|
37
|
+
│ └── deployment.yaml
|
|
38
|
+
└── overlays/
|
|
39
|
+
└── prod/
|
|
40
|
+
└── kustomization.yaml
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### Base
|
|
44
|
+
```yaml
|
|
45
|
+
apiVersion: kustomize.config.k8s.io/v1beta1
|
|
46
|
+
kind: Kustomization
|
|
47
|
+
resources:
|
|
48
|
+
- deployment.yaml
|
|
49
|
+
commonLabels:
|
|
50
|
+
app: myapp
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### Prod Overlay
|
|
54
|
+
```yaml
|
|
55
|
+
apiVersion: kustomize.config.k8s.io/v1beta1
|
|
56
|
+
kind: Kustomization
|
|
57
|
+
bases:
|
|
58
|
+
- ../../base
|
|
59
|
+
replicas:
|
|
60
|
+
- name: myapp
|
|
61
|
+
count: 5
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
kubectl apply -k overlays/prod/
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Flux CD
|
|
69
|
+
```bash
|
|
70
|
+
flux bootstrap github \
|
|
71
|
+
--owner=myorg \
|
|
72
|
+
--repository=fleet-infra \
|
|
73
|
+
--branch=main \
|
|
74
|
+
--path=clusters/my-cluster
|
|
75
|
+
```
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# Kubernetes Workflows
|
|
2
|
+
|
|
3
|
+
## GitOps Architecture
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
Git Repository (desired state)
|
|
7
|
+
│ Watches
|
|
8
|
+
▼
|
|
9
|
+
GitOps Agent (Argo CD / Flux)
|
|
10
|
+
│ Syncs
|
|
11
|
+
▼
|
|
12
|
+
Kubernetes Cluster (actual state)
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
**Benefits:** Single source of truth, auditable, automated, easy rollback
|
|
16
|
+
|
|
17
|
+
## Argo CD Setup
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
kubectl create namespace argocd
|
|
21
|
+
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
|
|
22
|
+
kubectl port-forward svc/argocd-server -n argocd 8080:443
|
|
23
|
+
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### Application Manifest
|
|
27
|
+
```yaml
|
|
28
|
+
apiVersion: argoproj.io/v1alpha1
|
|
29
|
+
kind: Application
|
|
30
|
+
metadata:
|
|
31
|
+
name: myapp
|
|
32
|
+
namespace: argocd
|
|
33
|
+
spec:
|
|
34
|
+
project: default
|
|
35
|
+
source:
|
|
36
|
+
repoURL: https://github.com/myorg/myapp
|
|
37
|
+
targetRevision: HEAD
|
|
38
|
+
path: k8s/manifests
|
|
39
|
+
destination:
|
|
40
|
+
server: https://kubernetes.default.svc
|
|
41
|
+
namespace: default
|
|
42
|
+
syncPolicy:
|
|
43
|
+
automated:
|
|
44
|
+
prune: true
|
|
45
|
+
selfHeal: true
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## Deployment Patterns
|
|
49
|
+
|
|
50
|
+
### Rolling Update
|
|
51
|
+
```yaml
|
|
52
|
+
spec:
|
|
53
|
+
strategy:
|
|
54
|
+
type: RollingUpdate
|
|
55
|
+
rollingUpdate:
|
|
56
|
+
maxSurge: 1
|
|
57
|
+
maxUnavailable: 0
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Blue-Green
|
|
61
|
+
```yaml
|
|
62
|
+
# Two deployments: myapp-blue, myapp-green
|
|
63
|
+
# Service selector switches between versions
|
|
64
|
+
selector:
|
|
65
|
+
app: myapp
|
|
66
|
+
version: blue # Change to 'green' to switch
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Canary (with Istio)
|
|
70
|
+
```yaml
|
|
71
|
+
route:
|
|
72
|
+
- destination: { host: myapp, subset: v1 }
|
|
73
|
+
weight: 90
|
|
74
|
+
- destination: { host: myapp, subset: v2 }
|
|
75
|
+
weight: 10 # 10% canary
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
See `kubernetes-workflows-advanced.md` for CI/CD, Kustomize patterns.
|