Deck, a CLI that creates reproducible Kubernetes environments for development and testing
Project description
Getdeck
A CLI that creates reproducible Kubernetes environments for development and testing!
Explore the docs »
Getting started
·
Report Bug
·
Request Feature
Table of Contents
About the project
Getdeck is like docker-compose for Kubernetes: Find a Deckfile that is describing your setup,
run deck get ...
and you are ready to work. No Kubernetes knowledge required.
Simple to use
Just install the binary executable deck
and you are good to go.
All dependencies managed
Helm, kustomize, k3d, kubectl? Getdeck manages all dependencies for your setup so you don't have to.
Built with
Getdeck builds on top of the following popular open-source technologies:
Docker
Docker is currently used to run all the required tooling from the Kubernetes ecosystem, so you don't have to install everything yourself.
k3d
k3d is supported to run local Kubernetes cluster.
kind
kind is supported to run local Kubernetes cluster.
Getting Started
You can easily try Getdeck yourself following this small example.
Prerequisites
- Follow the installation for your preferred platform.
Running Getdeck
We provide a sophisticated demo project you can deploy locally using Getdeck
:
deck get https://github.com/gefyrahq/gefyra-demos.git
This might take a few minutes. When it's done, open your browser at
http://dashboard.127.0.0.1.nip.io:8080/#/workloads?namespace=oauth2-demo.
You should see a kubernetes dashboard with some information about the namespace we just deployed using deck
!
Cleaning up
To clean it up (i.e. remove the cluster), just run the following command:
deck remove --cluster https://github.com/gefyrahq/gefyra-demos.git
Now go and write your own Deckfile!
Usage
The following actions are available in Getdeck's CLI:
get
: setup local development infrastructure, install a deckremove
: remove Getdeck's development infrastructure and/or just the decklist
: list the available decks of a Deckfileversion
: print the current version and exit
For more examples, please refer to the CLI documentation
License
Distributed under the Apache License 2.0. See LICENSE
for more information.
Reporting Bugs
If you encounter issues, please create a new issue on GitHub or talk to us on the Unikube Slack channel. When reporting a bug please include the following information:
Getdeck version or Git commit that you're running (deck version
),
description of the bug and logs from the relevant deck
command (if applicable),
steps to reproduce the issue, expected behavior.
If you're reporting a security vulnerability, please follow the process for reporting security issues.
Acknowledgments
Getdeck is sponsored by the Blueshoe GmbH.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.