[comment]: # Harvester does not officially come with a CLI tool, the user is supposed to interact with Harvester mostly through the UI [comment]: # Though it is theoretically possible to use kubectl to interact with Harvester, the manipulation of Kubevirt YAML objects is absolutely not user friendly. [comment]: # Inspired by tools like multipass from Canonical to easily and rapidly create one of multiple VMs, I began the development of Harvester CLI. Currently, it works but Harvester CLI needs some love to be up-to-date with Harvester v1.0.2 and needs some bug fixes and improvements as well.

Project Description

Harvester CLI is a command line interface tool written in Go, designed to simplify interfacing with a Harvester cluster as a user. It is especially useful for testing purposes as you can easily and rapidly create VMs in Harvester by providing a simple command such as: harvester vm create my-vm --count 5 to create 5 VMs named my-vm-01 to my-vm-05.

asciicast

Harvester CLI is functional but needs a number of improvements: up-to-date functionality with Harvester v1.0.2 (some minor issues right now), modifying the default behaviour to create an opensuse VM instead of an ubuntu VM, solve some bugs, etc.

Github Repo for Harvester CLI: https://github.com/belgaied2/harvester-cli

Goal for this Hackweek

The goal for this Hackweek is to bring Harvester CLI up-to-speed with latest Harvester version, and improve the code quality as well as implement some simple features and bug fixes. Some nice additions might be:

  • Create a Github actions pipeline to automatically integrate Harvester CLI to Homebrew repositories
  • Automatically package Harvester CLI for OpenSUSE / Redhat RPMs or DEBs
  • Implement some automated tests in Go
  • Improve the overall code quality
  • Test the program and create issues for it

Issue list is here: https://github.com/belgaied2/harvester-cli/issues

Resources

The project is written in Go, and using client-go the Kubernetes Go Client libraries to communicate with the Harvester API (which is Kubernetes in fact). Welcome contributions are:

  • Testing it and creating issues
  • Homebrew build scripts
  • RPM packaging
  • Documentation
  • Go code improvement

What you might learn

Harvester CLI might be interesting to you if you want to learn more about:

  • GitHub Actions
  • Harvester as a SUSE Product
  • Go programming language
  • Kubernetes API
  • Kubevirt API objects (Manipulating VMs and VM Configuration in Kubernetes using Kubevirt)

This project is part of:

Hack Week 21 Hack Week 22

Activity

  • 4 months ago: mrussell liked this project.
  • 4 months ago: rcase liked this project.
  • 4 months ago: roseswe joined this project.
  • 11 months ago: rebeccazhuo liked this project.
  • 11 months ago: dpock liked this project.
  • 11 months ago: mohamed.belgaied started this project.
  • 11 months ago: mohamed.belgaied liked this project.
  • 11 months ago: mohamed.belgaied added keyword "rancher" to this project.
  • 11 months ago: mohamed.belgaied added keyword "go" to this project.
  • 11 months ago: mohamed.belgaied added keyword "golang" to this project.
  • 11 months ago: mohamed.belgaied added keyword "homebrew" to this project.
  • 11 months ago: mohamed.belgaied added keyword "rpmbuild" to this project.
  • 11 months ago: mohamed.belgaied added keyword "rpm" to this project.
  • 11 months ago: mohamed.belgaied added keyword "cli" to this project.
  • 11 months ago: mohamed.belgaied added keyword "client-go" to this project.
  • 11 months ago: mohamed.belgaied added keyword "kubevirt" to this project.
  • 11 months ago: mohamed.belgaied added keyword "kvm" to this project.
  • 11 months ago: mohamed.belgaied added keyword "harvester" to this project.
  • 11 months ago: mohamed.belgaied added keyword "kubernetes" to this project.
  • 11 months ago: mohamed.belgaied originated this project.

  • Comments

    Be the first to comment!

    Similar Projects

    Learn about kubernetes by creating a k3s HA setup by rsimai

    This is mostly a learning activity for myself, ...


    Rancher Manager of Managers with KCP by rcase

    [comment]: # (Please use the project descriptio...


    Vai: a Kubernetes API accelerator/cache by moio

    ![Kubernetes API caching layer according to Sta...


    Real-time container runtime support by a_faerber

    [comment]: # (Please use the project descriptio...


    Containerized git server/client for playground and tutorials by mberti

    [comment]: # (Please use the project descriptio...


    Vai: a Kubernetes API accelerator/cache by moio

    ![Kubernetes API caching layer according to Sta...


    Real-time container runtime support by a_faerber

    [comment]: # (Please use the project descriptio...


    Rancher Token Revoker by mbolot

    [comment]: # (Please use the project descriptio...


    K3S Control Planes as a service by ademicev0

    [comment]: # (Please use the project descriptio...


    Generic Wrangler Controllers by kjoiner

    [comment]: # (Please use the project descriptio...


    Elemental Operator: support hosts without TPM by fgiudici

    [comment]: # (Please use the project descriptio...


    operator for s3gw by gbaccini

    Project Description

    Create a K8s CRD for ...


    Improve Docker registry listing tool by rbranco

    Project Description

    [regview](https://git...


    Vai: a Kubernetes API accelerator/cache by moio

    ![Kubernetes API caching layer according to Sta...


    Package libfyaml by tinita

    Project Description

    [libfyaml](https://g...


    Create tool for managing RPM package signing keys by dheidler

    [comment]: # (Please use the project descriptio...


    Switch software-o-o to parse repomd data by hennevogel

    Currently software.opensuse.org search is using...


    Modular kernel packaging by mwilck

    Project Description

    Create a PoC for a mo...


    Package libfyaml by tinita

    Project Description

    [libfyaml](https://g...


    Rewrite the D-Installer CLI by IGonzalezSosa

    Project Description

    Before the openSUSE 2...


    image-tools: simple tool for mirror/save/load container images & KDM and chart image list generator. by StarryWang

    [comment]: # (Please use the project descriptio...


    Rancher Manager of Managers with KCP by rcase

    [comment]: # (Please use the project descriptio...


    Rancher Token Revoker by mbolot

    [comment]: # (Please use the project descriptio...


    Humidity sensors with dashboard by joachimwerner

    Build a network of ("edge") humidity sensors...


    Deploy Uyuni proxy using Elemental and Fleet by cbosdonnat

    Project Description

    Now that Uyuni proxy ...