Skip to content
1 change: 1 addition & 0 deletions docs/astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ export default defineConfig({
{ label: "Troubleshooting", link: "/troubleshooting/" },
],
},
{ label: "Resources", link: "/resources/" },
],
lastUpdated: true,
pagination: true,
Expand Down
112 changes: 112 additions & 0 deletions docs/src/content/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">
Comment thread
devantler marked this conversation as resolved.
[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)
Comment thread
devantler marked this conversation as resolved.

</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)
Comment thread
devantler marked this conversation as resolved.

</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.
Comment thread
devantler marked this conversation as resolved.

[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
Binary file added resources-page-cloud-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources-page-hetzner-section.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources-page-with-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.