https://github.com/giantswarm/kubectl-gs

kubectl plugin helping with custom resources by Giant Swarm
https://github.com/giantswarm/kubectl-gs

kubectl kubectl-plugin kubectl-plugins

Last synced: 3 months ago
JSON representation

kubectl plugin helping with custom resources by Giant Swarm

• Host: GitHub
• URL: https://github.com/giantswarm/kubectl-gs
• Owner: giantswarm
• License: apache-2.0
• Created: 2020-03-23T13:14:01.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2026-03-24T10:04:00.000Z (3 months ago)
• Last Synced: 2026-03-24T10:29:21.741Z (3 months ago)
• Topics: kubectl, kubectl-plugin, kubectl-plugins
• Language: Go
• Homepage: https://docs.giantswarm.io/reference/kubectl-gs/
• Size: 78.8 MB
• Stars: 51
• Watchers: 9
• Forks: 8
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: CODEOWNERS
  • Security: SECURITY.md
  • Dco: DCO

Awesome Lists containing this project

README

          
![header image](https://user-images.githubusercontent.com/273727/136764760-3c28515d-eb65-4e27-9503-1375dcbf49f0.png)

# The official Giant Swarm kubectl plug-in

## Quick start

```nohighlight

kubectl krew install gs

kubectl gs

```

Check the [installation docs](https://docs.giantswarm.io/vintage/use-the-api/kubectl-gs/installation/) for details on installation with and without Krew.

## Features

- **Login via single sign-on**: Using the `login` command, you can quickly set up a `kubectl` context with OIDC authentication for a Giant Swarm management cluster, or a workload cluster with our [dex](https://github.com/giantswarm/dex-app) and [athena](https://github.com/giantswarm/athena) apps installed.

- **Custom resource templating**: using the `template` commands lets you create manifests for

  creating/updating custom resources for:

  - Clusters

  - Node pools

  - App catalogs

  - Apps

- **Gitops repository management**: The `gitops` command family allows to create and modify resources in your GitOps repo clone.

- **Resource display**: The `get` commands allow for retrieving a list of resources, or details for a single one.

## Documentation

Find the [kubectl gs reference](https://docs.giantswarm.io/vintage/use-the-api/kubectl-gs/) in our documentation site.

## Publishing a release

See [docs/Release.md](https://github.com/giantswarm/kubectl-gs/blob/master/docs/Release.md)