Skip to main content

Deck, a CLI that creates reproducible Kubernetes environments for development and testing

Project description

Contributors Forks Stargazers Issues MIT License Coverage Information


Getdeck components

Getdeck

A CLI that creates reproducible Kubernetes environments for development and testing!
Explore the docs »

Getting started · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. License
  4. Acknowledgments

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.

(back to top)

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.

(back to top)

Getting Started

You can easily try Getdeck yourself following this small example.

Prerequisites

  1. 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!

(back to top)

Usage

The following actions are available in Getdeck's CLI:

  • get: setup local development infrastructure, install a deck
  • remove: remove Getdeck's development infrastructure and/or just the deck
  • list: list the available decks of a Deckfile
  • version: print the current version and exit

For more examples, please refer to the CLI documentation

(back to top)

License

Distributed under the Apache License 2.0. See LICENSE for more information.

(back to top)

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

getdeck-0.11.1.tar.gz (35.3 kB view details)

Uploaded Source

Built Distribution

getdeck-0.11.1-py3-none-any.whl (49.2 kB view details)

Uploaded Python 3

File details

Details for the file getdeck-0.11.1.tar.gz.

File metadata

  • Download URL: getdeck-0.11.1.tar.gz
  • Upload date:
  • Size: 35.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.2 CPython/3.11.0 Linux/5.15.0-1022-azure

File hashes

Hashes for getdeck-0.11.1.tar.gz
Algorithm Hash digest
SHA256 625c607223b4fb6da87b3243666d878036cedd4871d9d10877d7c3a36529f660
MD5 892422305aed71b198b3e81c33fb5fa9
BLAKE2b-256 03dabdae2e726940a1a44d9c92fa3793bd424cdb56a2d505498900df0fa8fe27

See more details on using hashes here.

File details

Details for the file getdeck-0.11.1-py3-none-any.whl.

File metadata

  • Download URL: getdeck-0.11.1-py3-none-any.whl
  • Upload date:
  • Size: 49.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.2 CPython/3.11.0 Linux/5.15.0-1022-azure

File hashes

Hashes for getdeck-0.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 15939e6b1e1dae53b88bf4ac70aba67ffa7dc9a351b149648951b2e7d53cd8ff
MD5 744fe7b254d142546683cd106e940877
BLAKE2b-256 23921e213e724c8f012757a24a4eb97afb223b33b379ce896a40c3afcf0164ab

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page