-
-
Notifications
You must be signed in to change notification settings - Fork 9
docs: Add Resources page to documentation #2104
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
5050e0b
docs: Add Resources page to documentation
github-actions[bot] 959008b
Merge branch 'main' into docs/add-resources-page-6af38c984bec1ebe
devantler 7af46ab
Update docs/src/content/docs/resources.mdx
devantler e1e2c52
Update docs/src/content/docs/resources.mdx
devantler b01a0c4
Merge branch 'main' into docs/add-resources-page-6af38c984bec1ebe
devantler ff24c0a
Merge branch 'main' into docs/add-resources-page-6af38c984bec1ebe
devantler 2bc135c
Fix invalid seti:cloud icon in Resources page (#2141)
Copilot eb4c650
Merge branch 'main' into docs/add-resources-page-6af38c984bec1ebe
devantler 440d6d0
fix(docs): Remove unnecessary whitespace in resources page
devantler File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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) | ||
|
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) | ||
|
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. | ||
|
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 | ||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.