Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions pkg/svc/chat/docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,14 +114,14 @@ You must manually delete the old cluster first with `ksail cluster delete`, then

### Which distributions support LoadBalancer services?

LoadBalancer support varies by distribution and provider:
LoadBalancer support is available across all distributions:

- **Vanilla (Kind)** - ✅ Supports LoadBalancer services
- **K3s (K3d)** - ✅ Includes ServiceLB load balancer by default
- **Talos on Docker** - ❌ LoadBalancer services are not currently supported. The `--load-balancer` flag is automatically set to `Disabled` for this combination
- **Vanilla (Kind) on Docker** - ✅ Uses cloud-provider-kind (external Docker container)
- **K3s on Docker** - ✅ Uses built-in ServiceLB (Klipper-LB)
- **Talos on Docker** - ✅ Uses MetalLB with default IP pool (172.18.255.200-172.18.255.250)
- **Talos on Hetzner** - ✅ Uses Hetzner Cloud Load Balancer

MetalLB support for Talos+Docker is planned for a future release. Until then, use `NodePort` or `ClusterIP` services with port-forwarding for Talos clusters on Docker.
All distributions now provide LoadBalancer service support. MetalLB was added for Talos on Docker in v5.31+.

### Can I add nodes to an existing cluster?

Expand Down
112 changes: 112 additions & 0 deletions pkg/svc/chat/docs/resources.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
---
title: Resources
description: Learning resources, presentations, blog posts, and community projects using KSail
---

import { Card, CardGrid } from "@astrojs/starlight/components";

This page provides curated resources to help you learn more about KSail, including presentations, tutorials, blog posts, and projects from the community.

## Presentations

### KSail - a Kubernetes SDK for local GitOps development and CI

A comprehensive presentation on KSail delivered at KCD 2024, covering the motivation behind KSail and its key features.

**Note**: This presentation showcases an early version of KSail built in .NET. The current version is built in Go with expanded features and improvements.

<Card title="Watch on YouTube" icon="youtube">
[KSail - a Kubernetes SDK for local GitOps development and CI](https://youtu.be/Q-Hfn_-B7p8?si=2Uec_kld--fNw3gm)
</Card>

## Blog Posts

The following blog posts provide in-depth tutorials and guides for using KSail with different distributions and providers.

### Distribution-Specific Guides

<CardGrid>
<Card title="KSail and Vanilla" icon="document">
Learn how to use KSail with the Vanilla distribution (implemented with Kind) for local development.

[Read the guide →](https://devantler.tech/blog/local-kubernetes-development-with-ksail-and-kind)

</Card>
<Card title="KSail and K3s" icon="document">
Discover how to leverage KSail with the K3s distribution (implemented with K3d) for lightweight clusters in Docker.

[Read the guide →](https://devantler.tech/blog/local-kubernetes-development-with-ksail-and-k3d)

</Card>
<Card title="KSail and Talos" icon="document">
Explore local development with KSail and Talos Linux for immutable infrastructure.

[Read the guide →](https://devantler.tech/blog/local-kubernetes-development-with-ksail-and-talos)

</Card>
</CardGrid>

### Cloud Provider Guides

<Card title="KSail on Hetzner Cloud" icon="cloud-download">
Learn how to deploy production-ready Talos clusters on Hetzner Cloud using KSail.

[Read the guide →](https://devantler.tech/blog/creating-development-kubernetes-clusters-on-hetzner-with-ksail-and-talos)

</Card>

### AI Integration

<Card title="Building an AI Assistant with GitHub Copilot SDK" icon="rocket">
Deep dive into building KSail's AI-first terminal UI using GitHub Copilot SDK and Bubbletea.

[Read the article →](https://devantler.tech/blog/building-an-ai-assistant-for-kubernetes-with-github-copilot-sdk)

</Card>

## Related Projects

KSail is used in various projects and environments. Here are some examples of how the community is leveraging KSail:

<CardGrid>
<Card title="devantler-tech/platform" icon="github">
**Type**: Personal Homelab Platform

A production homelab setup using KSail for infrastructure management and GitOps workflows.

[View on GitHub →](https://github.com/devantler-tech/platform)

</Card>
</CardGrid>

### Share Your Project

If you're using KSail in your project, we'd love to hear about it! Share your implementation by:

1. Opening a pull request to add your project to this page
2. Starting a discussion in the [GitHub Discussions](https://github.com/devantler-tech/ksail/discussions)

This helps others discover real-world usage patterns and learn from your experience.

## Community & Support

### Get Help

- **Questions?** Start a [discussion](https://github.com/devantler-tech/ksail/discussions) in the repository
- **Found a bug?** Open an [issue](https://github.com/devantler-tech/ksail/issues)
- **Documentation issues?** Submit a [documentation PR](https://github.com/devantler-tech/ksail/tree/main/docs)

### Stay Updated

- ⭐ Star the [GitHub repository](https://github.com/devantler-tech/ksail) to stay informed about new releases
- 📰 Follow the [blog](https://devantler.tech/blog) for new tutorials and guides
- 💬 Join discussions on [GitHub Discussions](https://github.com/devantler-tech/ksail/discussions)

## Contributing

Interested in contributing to KSail? Check out the [Contributing Guide](https://github.com/devantler-tech/ksail/blob/main/CONTRIBUTING.md) for:

- Development setup instructions
- Code style guidelines
- Testing procedures
- Pull request process
10 changes: 7 additions & 3 deletions pkg/svc/chat/docs/support-matrix.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,8 @@ KSail supports multiple Kubernetes distributions, providers, and components. Thi
| Local Path Provisioner | ✅ | Built-in | ✅ (Docker) |
| Hetzner CSI Driver | ❌ | ❌ | ✅ (Hetzner) |
| **LoadBalancer** |
| LoadBalancer Support | ✅ | Built-in | (Docker) |
| MetalLB (planned) | ✅ | | 🚧 (Docker) |
| LoadBalancer Support | ✅ | Built-in | (Docker) |
| MetalLB | ❌ | | (Docker) |
| **GitOps** |
| Flux | ✅ | ✅ | ✅ |
| ArgoCD | ✅ | ✅ | ✅ |
Expand All @@ -50,7 +50,11 @@ KSail supports multiple Kubernetes distributions, providers, and components. Thi
- "Built-in" means the distribution includes this component by default
- K3s includes local-path-provisioner, metrics-server, and ServiceLB (load balancer) out of the box
- Talos CSI support is provider-dependent: Local Path Provisioner for Docker, Hetzner CSI Driver for Hetzner Cloud
- **LoadBalancer limitations**: Talos on Docker does not currently support LoadBalancer services. The `--load-balancer` flag is forced to `Disabled` for this combination. MetalLB support for Talos+Docker is planned for a future release. Talos on Hetzner uses the cloud provider's load balancer.
- **LoadBalancer support by distribution**:
- **Vanilla (Kind) on Docker**: Uses cloud-provider-kind (runs as external Docker container)
- **K3s on Docker**: Uses built-in ServiceLB (Klipper-LB)
- **Talos on Docker**: Uses MetalLB with default IP pool (172.18.255.200-172.18.255.250)
- **Talos on Hetzner**: Uses Hetzner Cloud Load Balancer (cloud provider integration)

## Secret Management × Provider Matrix

Expand Down