Add wg-easy applicaiton example with helmfile and taskfile flow (#39)

* Add wg-easy application example with helmfile and taskfile flow

* Update port configuration and expose utility tasks

- Change web/HTTPS ports from 80/443 to 30080/30443
- Configure explicit nodePort values for Traefik
- Make utility tasks public by removing internal flags
- Fix helmfile command execution with eval
- Enable web route configuration in wg-easy values

* Parameterize application name with default value of wg-easy

* Update kubeconfig file naming convention

* Try splitting sdk into it's own chart and deploying

* Roll back sdk in helmfile will need a seperate path through replicated release for that

* Using environments to enable local vs SaaS release testing, but I don't like it

* First pass at docs

* docs(wg-easy): Add prerequisites section to development workflow

* Refactor Taskfile to improve k3s traefik removal workflow

* Update documentation to reference setup-kubeconfig instead of get-kubeconfig

* refactor: Enhance GCP VM creation and SSH connection with robust retry and timeout logic

* add verify kubeconfig

* add list cluster and use dotenv to update chart release version

* update taskfile to fix promote fail and add release lint inspect

* add example env

* add development md

* remove delelopment md

* Use REPLICATED_APP for app name

we already have to have this set to work with the
replicated CLI

* Consistent naming for release tasks

* task dep

* update docs

* add design md to use AI for choosing right tools and start to create a development workflow

* Remove unrelated change and update doc

* rollback unrelated change

* remove unrelated change

* update doc

* more <noun>-<verb> naming

* scrape namespaces from helmChart resources

* remove additionalNamespaces from global appliation manifest

* Add script to automatically set helmChart versions from Chart.yaml

* Inline version script

---------

Co-authored-by: Dexter Yan <[email protected]>
Co-authored-by: hedge-sparrow <[email protected]>
Co-authored-by: Ash <[email protected]>

Author: 3 people

.gitignore

@@ -30,3 +30,10 @@ Thumbs.db
 *.pyo
 *.pyd
 __pycache__/
+
+# wg-easy specific
+*.kubeconfig
+applications/wg-easy/release/
+applications/wg-easy/*/charts/
+applications/wg-easy/*/Chart.lock
+.aider*

applications/wg-easy/README.md

@@ -0,0 +1,91 @@
+# WG-Easy Helm Chart Development Pattern
+
+This repository demonstrates a structured approach to developing and deploying Helm charts with Replicated integration. It focuses on a progressive development workflow that builds complexity incrementally, allowing developers to get fast feedback at each stage.
+
+## Core Principles
+
+The WG-Easy Helm Chart pattern is built on five fundamental principles:
+
+### 1. Progressive Complexity
+
+Start simple with individual chart validation and progressively move to more complex environments. This allows issues to be caught early when they are easier to fix.
+
+- Begin with local chart validation
+- Move to single chart deployments
+- Progress to multi-chart integration
+- Finally test in production-like environments
+
+### 2. Fast Feedback Loops
+
+Get immediate feedback at each development stage by automating testing and validation. This shortens the overall development cycle.
+
+- Automated chart validation
+- Quick cluster creation and deployment
+- Standardized testing at each stage
+- Fast iteration between changes
+
+### 3. Reproducible Steps
+
+Ensure consistent environments and processes across all stages of development, eliminating "works on my machine" issues.
+
+- Consistent chart configurations
+- Automated environment setup
+- Deterministic dependency management
+- Standardized deployment procedures
+
+### 4. Modular Configuration
+
+Allow different components to own their configuration independently, which can be merged at release time.
+
+- Per-chart configuration files
+- Automatic configuration merging
+- Clear ownership boundaries
+- Simplified collaborative development
+
+### 5. Automation First
+
+Use tools to automate repetitive tasks, reducing human error and increasing development velocity.
+
+- Task-based workflow automation
+- Helmfile for orchestration
+- Automated validation and testing
+- Streamlined release process
+
+## Repository Structure
+
+```
+applications/wg-easy/
+├── charts/templates/           # Common templates shared across charts
+├── cert-manager/               # Wrapped cert-manager chart
+├── cert-manager-issuers/       # Chart for cert-manager issuers
+├── replicated/                 # Root Replicated configuration
+├── replicated-sdk/             # Replicated SDK chart
+├── taskfiles/                  # Task utility functions
+├── traefik/                    # Wrapped Traefik chart
+├── wg-easy/                    # Main application chart
+├── helmfile.yaml               # Defines chart installation order
+└── Taskfile.yaml               # Main task definitions
+```
+
+## Architecture Overview
+
+![Architecture Diagram](docs/architecture.png)
+
+Key components:
+- **Taskfile**: Orchestrates the workflow with automated tasks
+- **Helmfile**: Manages chart dependencies and installation order
+- **Wrapped Charts**: Encapsulate upstream charts for consistency
+- **Shared Templates**: Provide reusable components across charts
+- **Replicated Integration**: Enables enterprise distribution
+
+## Learn More
+
+- [Chart Structure Guide](docs/chart-structure.md)
+- [Development Workflow](docs/development-workflow.md)
+- [Task Reference](docs/task-reference.md)
+- [Replicated Integration](docs/replicated-integration.md)
+- [Example Patterns](docs/examples.md)
+
+---
+
+This pattern is designed to be adaptable to different applications and requirements. Feel free to modify it to suit your specific needs.