{"id":30137745,"url":"https://github.com/pacphi/bootstrap-coder-on-scaleway","last_synced_at":"2025-08-11T00:55:12.190Z","repository":{"id":305955536,"uuid":"1024445977","full_name":"pacphi/bootstrap-coder-on-scaleway","owner":"pacphi","description":"Production-ready automation for deploying enterprise-grade Coder development environments on Scaleway Kubernetes, featuring 20+ workspace templates, comprehensive CI/CD workflows, and AI-enhanced development with Claude Code Flow integration.","archived":false,"fork":false,"pushed_at":"2025-07-30T16:00:32.000Z","size":618,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-30T16:04:04.155Z","etag":null,"topics":["coder","kubernetes","terraform"],"latest_commit_sha":null,"homepage":"","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pacphi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-22T17:56:05.000Z","updated_at":"2025-07-30T16:00:36.000Z","dependencies_parsed_at":"2025-07-22T22:22:42.820Z","dependency_job_id":null,"html_url":"https://github.com/pacphi/bootstrap-coder-on-scaleway","commit_stats":null,"previous_names":["pacphi/bootstrap-coder-on-scaleway"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pacphi/bootstrap-coder-on-scaleway","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pacphi%2Fbootstrap-coder-on-scaleway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pacphi%2Fbootstrap-coder-on-scaleway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pacphi%2Fbootstrap-coder-on-scaleway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pacphi%2Fbootstrap-coder-on-scaleway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pacphi","download_url":"https://codeload.github.com/pacphi/bootstrap-coder-on-scaleway/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pacphi%2Fbootstrap-coder-on-scaleway/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269814273,"owners_count":24479360,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coder","kubernetes","terraform"],"created_at":"2025-08-11T00:55:08.113Z","updated_at":"2025-08-11T00:55:12.173Z","avatar_url":"https://github.com/pacphi.png","language":"HCL","readme":"# Bootstrap Coder on Scaleway\n\nProduction-ready automation for deploying enterprise-grade Coder development environments on Scaleway Kubernetes, featuring 20+ workspace templates, comprehensive CI/CD workflows, and AI-enhanced development with Claude Code Flow integration.\n\n## 📋 Prerequisites\n\nBefore deploying Coder on Scaleway, ensure you have the following:\n\n### 1. Scaleway Account\n- **Create an account** at [scaleway.com](https://www.scaleway.com)\n- **Generate API keys** in the [Scaleway Console](https://console.scaleway.com/iam/api-keys)\n- **Note your Project and Organization IDs** from the\n  - [Project Dashboard](https://console.scaleway.com/project/settings)\n  - [Organization Dashboard](https://console.scaleway.com/organization)\n\n### 2. Required Tools\nInstall the following tools on your local machine:\n\n#### macOS (using Homebrew)\n```bash\n# Install all required tools\nbrew install terraform kubectl helm jq curl\n\n# Alternative: Install specific versions\nbrew install terraform@1.12\nbrew install kubernetes-cli@1.32\nbrew install helm@3.12\n```\n\n#### Ubuntu/Debian\n```bash\n# Update package index\nsudo apt-get update\n\n# Install basic tools\nsudo apt-get install -y curl jq git\n\n# Install Terraform\nwget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg\necho \"deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main\" | sudo tee /etc/apt/sources.list.d/hashicorp.list\nsudo apt update \u0026\u0026 sudo apt install terraform\n\n# Install kubectl\ncurl -LO \"https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl\"\nsudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl\n\n# Install Helm\ncurl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash\n```\n\n#### RHEL/CentOS/Fedora\n```bash\n# Install basic tools\nsudo yum install -y curl jq git\n\n# Install Terraform\nsudo yum install -y yum-utils\nsudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo\nsudo yum -y install terraform\n\n# Install kubectl\ncurl -LO \"https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl\"\nsudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl\n\n# Install Helm\ncurl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash\n```\n\n#### Windows (using Chocolatey or Scoop)\n```powershell\n# Using Chocolatey\nchoco install terraform kubernetes-cli kubernetes-helm jq curl git\n\n# Using Scoop\nscoop install terraform kubectl helm jq curl git\n```\n\n#### Verify Installation\n```bash\n# Check all tools are installed with correct versions\nterraform version   # Must be \u003e= 1.12.0\nkubectl version --client   # Must be \u003e= 1.32.0\nhelm version        # Must be \u003e= 3.12.0\njq --version        # Any recent version\ncurl --version      # Any recent version\ngit --version       # Any recent version\n```\n\n### 3. Environment Variables\nSet up your Scaleway credentials:\n\n```bash\n# Required credentials\nexport SCW_ACCESS_KEY=\"your-scaleway-access-key\"\nexport SCW_SECRET_KEY=\"your-scaleway-secret-key\"\nexport SCW_DEFAULT_PROJECT_ID=\"your-project-id\"\nexport SCW_DEFAULT_ORGANIZATION_ID=\"your-organization-id\"\n\n# Optional: Set default region (defaults to fr-par)\nexport SCW_DEFAULT_REGION=\"fr-par\"\nexport SCW_DEFAULT_ZONE=\"fr-par-1\"\n\n# Save to your shell profile for persistence\necho 'export SCW_ACCESS_KEY=\"your-scaleway-access-key\"' \u003e\u003e ~/.bashrc\necho 'export SCW_SECRET_KEY=\"your-scaleway-secret-key\"' \u003e\u003e ~/.bashrc\necho 'export SCW_DEFAULT_PROJECT_ID=\"your-project-id\"' \u003e\u003e ~/.bashrc\necho 'export SCW_DEFAULT_ORGANIZATION_ID=\"your-organization-id\"' \u003e\u003e ~/.bashrc\n```\n\n### 4. Optional Tools\n\n#### GitHub CLI (Required for GitHub Actions deployment)\nIf you plan to use GitHub Actions for deployment:\n\n```bash\n# macOS\nbrew install gh\n\n# Ubuntu/Debian\ncurl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg\nsudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg\necho \"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main\" | sudo tee /etc/apt/sources.list.d/github-cli.list \u003e /dev/null\nsudo apt update \u0026\u0026 sudo apt install gh\n\n# RHEL/CentOS/Fedora\nsudo dnf install 'dnf-command(config-manager)'\nsudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo\nsudo dnf install gh\n\n# Windows\nchoco install gh          # Chocolatey\nscoop install gh          # Scoop\n\n# Authenticate with GitHub\ngh auth login\n```\n\n### 5. Verify Prerequisites\nOnce everything is installed, verify your setup:\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-org/bootstrap-coder-on-scaleway.git\ncd bootstrap-coder-on-scaleway\n\n# Run prerequisite check\n./scripts/test-runner.sh --suite=prerequisites\n```\n\n### 6. GitHub Actions Configuration (Optional)\n\nFor automatic staging deployments via GitHub Actions:\n\n**Repository Secret Configuration**:\n```bash\n# In your GitHub repository settings, add this secret:\nENABLE_AUTO_STAGING_DEPLOY=true  # Enables automatic staging deployment on push/PR\n```\n\n**Note**: This is a feature flag that controls continuous deployment. Set to `true` only when you want automatic deployments enabled. When not set or set to any other value, automatic deployments are disabled while manual deployments continue to work.\n\n## ⚡ Quick Start\n\n\u003e **Important**: Ensure you've completed all [Prerequisites](#-prerequisites) before proceeding.\n\n### Two-Phase Deployment Architecture\n\nThis project uses a **two-phase deployment strategy** for better reliability and troubleshooting:\n\n- **Phase 1 (Infrastructure)**: Deploy Kubernetes cluster, database, networking, and security\n- **Phase 2 (Coder Application)**: Deploy the Coder platform with workspace templates\n\n**Benefits**: Infrastructure failures don't block cluster access, better separation of concerns, independent retry capability, and immediate kubeconfig access for troubleshooting.\n\n### Manual Deployment\nDeploy your first Coder environment in minutes:\n\n```bash\n# 1. Verify prerequisites are met\n./scripts/test-runner.sh --suite=prerequisites\n\n# 2. Deploy complete environment (both phases automatically)\n./scripts/lifecycle/setup.sh --env=dev --template=python-django-crewai\n\n# 🎉 Your Coder instance will be available at the provided URL\n# 💡 First deployment takes ~10-15 minutes\n```\n\n### GitHub Actions Deployment\nDeploy using GitHub Actions with automated two-phase workflow:\n\n```bash\n# Prerequisites: GitHub CLI (gh) must be installed\n# Fork the repository and configure secrets\ngh repo fork pacphi/bootstrap-coder-on-scaleway\ngh secret set SCW_ACCESS_KEY --body \"your-access-key\"\ngh secret set SCW_SECRET_KEY --body \"your-secret-key\"\ngh secret set SCW_DEFAULT_PROJECT_ID --body \"your-project-id\"\ngh secret set SCW_DEFAULT_ORGANIZATION_ID --body \"your-organziation-id\"\n\n# Deploy complete environment (both phases)\ngh workflow run deploy-environment.yml \\\n  -f environment=dev \\\n  -f template=python-django-crewai \\\n  -f enable_monitoring=true\n\n# Or deploy infrastructure only for troubleshooting\ngh workflow run deploy-infrastructure.yml \\\n  -f environment=dev\n\n# Monitor deployment progress\ngh run watch\n```\n\n### What Happens Next?\n\n**Phase 1 - Infrastructure Deployment (~10 min)**:\n- ✅ Kubernetes cluster creation with auto-scaling\n- ✅ Managed PostgreSQL database provisioning\n- ✅ VPC networking and security groups\n- ✅ Load balancer and SSL configuration\n- ✅ **Kubeconfig uploaded for immediate cluster access**\n\n**Phase 2 - Coder Application Deployment (~5 min)**:\n- ✅ Coder platform installation and configuration\n- ✅ OAuth integration and user management\n- ✅ Workspace template deployment (if specified)\n- ✅ Final health checks and validation\n\n\u003e **Key Advantage**: If Phase 2 fails, you still have full cluster access via kubeconfig to troubleshoot and retry Coder deployment independently.\n\n## 🏗️ Multi-Environment Architecture\n\n| Environment | Monthly Cost | Use Case | Resources |\n|-------------|--------------|----------|-----------|\n| **Development** | €53.70 | Personal dev, learning | 2×GP1-XS nodes, DB-DEV-S |\n| **Staging** | €97.85 | Team testing, CI/CD | 3×GP1-S nodes, DB-GP-S |\n| **Production** | €374.50 | Enterprise, high availability | 5×GP1-M nodes, DB-GP-M HA |\n\n## 🎯 Available Templates\n\n### **Backend** (7 templates)\nJava Spring, Python Django+CrewAI, Go Fiber, Ruby Rails, PHP Symfony, Rust Actix Web, .NET Core\n\n### **Frontend** (4 templates)\nReact+TypeScript, Angular, Vue+Nuxt, Svelte Kit\n\n### **AI-Enhanced** (2 templates)\nClaude Code Flow Base/Enterprise with 87 MCP tools, swarm/hive-mind modes\n\n### **DevOps** (3 templates)\nDocker Compose, Kubernetes+Helm, Terraform+Ansible\n\n### **Data/ML** (2 templates)\nJupyter+Python, R Studio\n\n### **Mobile** (3 templates)\nFlutter, React Native, Ionic\n\n## 📖 Documentation\n\n- **[📋 Usage Guide](docs/USAGE.md)** - Complete usage examples, GitHub Actions workflows, and troubleshooting\n- **[🎯 Feature Comparison](docs/FEATURES.md)** - Detailed feature matrix comparing shell scripts, Terraform/CLI, and GitHub Actions deployment methods\n- **[🏗️ Architecture Guide](docs/ARCHITECTURE.md)** - System design, components, CI/CD flows, and Mermaid diagrams\n- **[🎯 Templates Guide](docs/TEMPLATES.md)** - Comprehensive listing of all 21+ workspace templates with usage examples\n- **[🤖 AI Assistant Context](CLAUDE.md)** - Technical context for Claude Code integration and new capabilities\n- **[🔌 Integrations Guide](docs/INTEGRATIONS.md)** - External integrations setup (Slack, JIRA, monitoring, compliance)\n- **[🔧 Hooks Framework](scripts/hooks/README.md)** - Extensible automation and integration examples\n- **[🧪 Testing Guide](scripts/test-runner.sh)** - Comprehensive validation and testing procedures\n- **[📊 Cost Management](scripts/utils/cost-calculator.sh)** - Real-time cost tracking and optimization\n\n## 🤖 GitHub Actions CI/CD\n\n### Two-Phase Deployment Workflows\n\n**Complete Environment Deployment** (Recommended):\n```bash\n# Deploy both infrastructure and Coder application\ngh workflow run deploy-environment.yml \\\n  -f environment=staging \\\n  -f template=react-typescript \\\n  -f enable_monitoring=true\n```\n\n**Phase-Specific Deployments**:\n```bash\n# Deploy infrastructure only (Phase 1)\ngh workflow run deploy-infrastructure.yml \\\n  -f environment=dev \\\n  -f region=fr-par\n\n# Deploy Coder application only (Phase 2) - requires existing infrastructure\ngh workflow run deploy-coder.yml \\\n  -f environment=dev \\\n  -f template=python-django-crewai\n```\n\n### Teardown Environment\n```bash\n# Complete teardown (both phases)\ngh workflow run teardown-environment.yml \\\n  -f environment=dev \\\n  -f confirmation=\"I understand this will destroy the environment\" \\\n  -f create_backup=true\n\n# Selective teardown options\ngh workflow run teardown-environment.yml \\\n  -f environment=dev \\\n  -f teardown_mode=coder_only  # Keep infrastructure, remove Coder only\n```\n\n### Template Validation\n```bash\n# Validate all templates and infrastructure\ngh workflow run validate-templates.yml \\\n  -f validation_scope=comprehensive \\\n  -f test_deployments=true\n```\n\n## 🛠️ Management Scripts\n\n### Comprehensive Testing\n```bash\n# Run all validation tests\n./scripts/test-runner.sh --suite=all\n\n# Run specific test suites\n./scripts/test-runner.sh --suite=smoke,templates --format=json\n\n# Test external integrations\n./scripts/test-runner.sh --suite=integrations\n```\n\n### Environment Validation\n```bash\n# Quick health check\n./scripts/validate.sh --env=prod --quick\n\n# Comprehensive validation with detailed report\n./scripts/validate.sh --env=staging --comprehensive --format=json\n```\n\n### Dynamic Scaling\n```bash\n# Scale cluster with cost analysis\n./scripts/scale.sh --env=prod --nodes=8 --analyze-cost\n\n# Auto-scale based on workload\n./scripts/scale.sh --env=staging --auto --target-cpu=70\n```\n\n### Automated Backups\n```bash\n# Complete environment backup\n./scripts/lifecycle/backup.sh --env=prod --include-all\n\n# Pre-destroy backup with retention\n./scripts/lifecycle/backup.sh --env=staging --pre-destroy --retention-days=90\n```\n\n## 🔧 Hooks Framework\n\n### Custom Automation\n```bash\n# Customize deployment lifecycle\n./scripts/hooks/pre-setup.sh    # Before deployment starts\n./scripts/hooks/post-setup.sh   # After deployment completes\n./scripts/hooks/pre-teardown.sh # Before teardown starts\n./scripts/hooks/post-teardown.sh # After teardown completes\n```\n\n### Integration Examples\n- **Slack notifications** for deployment events\n- **JIRA ticket creation** for environment changes\n- **External monitoring** system registration\n- **Compliance checks** and audit logging\n- **User notifications** and workspace management\n\n📚 **[Complete Integration Setup Guide](docs/INTEGRATIONS.md)** - Detailed documentation for configuring all external integrations\n\n## 🚀 Key Features\n\n### 🏗️ Infrastructure \u0026 Deployment\n- **Multi-environment deployment** with cost optimization (dev/staging/prod)\n- **GitHub Actions CI/CD** with automated workflows and notifications\n- **Terraform automation** with state management and drift detection\n- **Kubernetes management** on Scaleway Kapsule with auto-scaling\n- **Extensible hooks framework** for custom deployment logic\n\n### 🎯 Templates \u0026 Development\n- **21+ production-ready templates** across all major frameworks\n- **AI-enhanced development** with Claude Code Flow integration (87 MCP tools)\n- **Dynamic template discovery** with automatic validation\n- **Multi-language support** (Java, Python, Go, Rust, JS/TS, C#, PHP, Ruby)\n- **Specialized templates** for data science, DevOps, and mobile development\n\n### 🔒 Security \u0026 Compliance\n- **Enterprise security** with Pod Security Standards and RBAC\n- **Network policies** and traffic isolation\n- **Encrypted secrets** management with Kubernetes\n- **Audit logging** and compliance tracking\n- **Environment-specific security policies** (dev/staging/prod)\n\n### 📊 Monitoring \u0026 Operations\n- **Cost management** with real-time tracking and budget alerts\n- **Comprehensive monitoring** with Prometheus/Grafana stacks\n- **Health checks** and automated validation\n- **Performance metrics** and resource optimization\n- **External system integration** (Slack, monitoring, etc.)\n\n### 💾 Backup \u0026 Recovery\n- **Automated backups** with configurable retention policies\n- **Disaster recovery** procedures with point-in-time restoration\n- **Pre-destroy backups** to prevent data loss\n- **Multi-format exports** (infrastructure, configs, data)\n- **Backup verification** and integrity checks\n\n### ⚡ Performance \u0026 Scaling\n- **Dynamic cluster scaling** with cost analysis\n- **Auto-scaling policies** based on CPU/memory metrics\n- **Resource quotas** and limit enforcement\n- **Load balancing** with SSL termination\n- **Performance optimization** recommendations\n\n## 🛡️ Enterprise Ready\n\n✅ **Security**: Pod Security Standards, Network Policies, RBAC, encrypted secrets\n✅ **Monitoring**: Prometheus metrics, Grafana dashboards, alerting\n✅ **Compliance**: Audit logging, cost tracking, resource quotas\n✅ **Scalability**: Auto-scaling nodes (3-15), high availability database\n✅ **Reliability**: Automated backups, disaster recovery, health checks\n\n## 🚀 Advanced Usage Examples\n\n### Complete Development Workflow\n```bash\n# 1. Deploy development environment with AI template (two-phase automatic)\n./scripts/lifecycle/setup.sh --env=dev --template=claude-flow-base\n\n# 2. Validate deployment\n./scripts/validate.sh --env=dev --quick\n\n# 3. Scale for team development\n./scripts/scale.sh --env=dev --nodes=4\n\n# 4. Create backup before major changes\n./scripts/lifecycle/backup.sh --env=dev --include-workspaces\n\n# 5. Run comprehensive tests\n./scripts/test-runner.sh --suite=integration --env=dev\n```\n\n### Production Deployment with Monitoring\n```bash\n# Deploy production with all enterprise features (two-phase automatic)\n./scripts/lifecycle/setup.sh \\\n  --env=prod \\\n  --template=java-spring \\\n  --enable-monitoring \\\n  --enable-ha \\\n  --cost-budget=400\n\n# Validate production readiness\n./scripts/validate.sh --env=prod --comprehensive\n\n# Set up automated scaling\n./scripts/scale.sh --env=prod --auto --min-nodes=5 --max-nodes=15\n```\n\n### Troubleshooting with Two-Phase Architecture\n```bash\n# If Coder deployment fails, infrastructure is still accessible:\n\n# 1. Use kubeconfig from Phase 1 to investigate\nexport KUBECONFIG=~/.kube/config-coder-dev\nkubectl get pods -n coder\nkubectl describe deployment coder -n coder\n\n# 2. Retry only Coder deployment (Phase 2)\ngh workflow run deploy-coder.yml -f environment=dev\n\n# 3. Or use manual deployment for Phase 2\ncd environments/dev/coder\nterraform init \u0026\u0026 terraform apply\n```\n\n### CI/CD Pipeline Integration\n```yaml\n# GitHub Actions example - Two-Phase Deployment\nname: Deploy Staging on PR\non:\n  pull_request:\n    types: [opened, synchronize]\n\njobs:\n  deploy-staging:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - name: Deploy complete environment (two-phase)\n        uses: ./.github/workflows/deploy-environment.yml\n        with:\n          environment: staging\n          template: react-typescript\n          enable_monitoring: true\n          auto_approve: true\n```\n\n### Environment Structure\n\nThe two-phase architecture organizes environments with separate configurations:\n\n```\nenvironments/\n├── dev/\n│   ├── infra/          # Phase 1: Infrastructure (cluster, database, networking)\n│   │   ├── main.tf\n│   │   ├── providers.tf\n│   │   └── outputs.tf\n│   └── coder/          # Phase 2: Coder application deployment\n│       ├── main.tf\n│       ├── providers.tf\n│       └── outputs.tf\n├── staging/\n│   ├── infra/\n│   └── coder/\n└── prod/\n    ├── infra/\n    └── coder/\n```\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n**Prerequisites Missing**\n```bash\n# Check system requirements\n./scripts/test-runner.sh --suite=prerequisites\n```\n\n**Template Deployment Fails**\n```bash\n# Validate templates\n./scripts/test-runner.sh --suite=templates\n\n# Check template syntax\ngh workflow run validate-templates.yml -f validation_scope=syntax\n```\n\n**Two-Phase Deployment Issues**\n```bash\n# Infrastructure deployment failed (Phase 1)\n# Check Scaleway console and workflow logs\ngh run list --workflow=deploy-infrastructure.yml\n\n# Coder deployment failed (Phase 2) - Infrastructure still accessible\n# Use kubeconfig to troubleshoot\nexport KUBECONFIG=~/.kube/config-coder-\u003cenv\u003e\nkubectl get storageclass  # Check if scw-bssd storage class exists\nkubectl get pvc -n coder  # Check persistent volume claims\n\n# Retry only Coder deployment\ngh workflow run deploy-coder.yml -f environment=\u003cenv\u003e\n```\n\n**Cost Overruns**\n```bash\n# Analyze current costs\n./scripts/utils/cost-calculator.sh --env=all --detailed\n\n# Set budget alerts\n./scripts/utils/cost-calculator.sh --env=prod --set-budget=300 --alert-threshold=80\n```\n\n**Scaling Issues**\n```bash\n# Check cluster capacity\n./scripts/validate.sh --env=prod --focus=resources\n\n# Analyze scaling recommendations\n./scripts/scale.sh --env=prod --analyze-only\n```\n\n### Support Channels\n- **[Usage Guide](docs/USAGE.md)** - Comprehensive documentation\n- **[GitHub Issues](../../issues)** - Bug reports and feature requests\n- **[Architecture Guide](docs/ARCHITECTURE.md)** - System design and troubleshooting\n- **[Hooks Examples](scripts/hooks/README.md)** - Custom integration patterns\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](.github/CONTRIBUTING.md) and check out [open issues](../../issues).\n\n### Development Setup\n```bash\n# Fork and clone the repository\ngh repo fork your-org/bootstrap-coder-on-scaleway\ncd bootstrap-coder-on-scaleway\n\n# Run comprehensive tests\n./scripts/test-runner.sh --suite=all\n\n# Deploy test environment\n./scripts/lifecycle/setup.sh --env=dev --template=python-django-crewai\n```\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n**🚀 Ready to get started?** Check our [Feature Comparison](docs/FEATURES.md) to choose your deployment method:\n- **Shell Scripts**: `./scripts/lifecycle/setup.sh --env=dev --template=react-typescript`\n- **GitHub Actions**: `gh workflow run deploy-environment.yml`\n- **Terraform/CLI**: See the [Usage Guide](docs/USAGE.md)\n\n**Need help?** Check the [documentation](docs/) or [create an issue](../../issues) 📞","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpacphi%2Fbootstrap-coder-on-scaleway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpacphi%2Fbootstrap-coder-on-scaleway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpacphi%2Fbootstrap-coder-on-scaleway/lists"}