kubeslice-controller

command module
v1.5.7-gamma Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 18, 2024 License: Apache-2.0 Imports: 19 Imported by: 0

README

kubeslice-controller

multicloud-opensource

kubeslice-controller uses Kubebuilder, a framework for building Kubernetes APIs using custom resource definitions (CRDs).

Get Started

The KubeSlice Controller orchestrates the creation and management of slices on worker clusters. It is strongly recommended that you use a released version. Follow the instructions provided in this document to install Kubeslice on cloud clusters.

Build and Deploy a KubeSlice Controller on a Kind Cluster

See our documentation on installing the KubeSlice Controller.

Prerequisites

Before you begin, make sure the following prerequisites are met:

  • Docker is installed and running on your local machine.
  • A running kind cluster.
  • kubectl is installed and configured.
  • You have prepared the environment for the installation of kubeslice-controller on the controller cluster and worker-operator on the worker cluster. For more information, see Prerequisites.
Set up Your Helm Repo

If you have not added Avesha's helm repo yet, add it.

helm repo add avesha https://kubeslice.github.io/charts/

Upgrade Avesha's helm repo.

helm repo update
Build Your Docker Image

To download the latest docker image for kubeslice-controller, click here.

  1. Clone the latest version of kubeslice-controller from the master branch.

    git clone https://github.com/kubeslice/kubeslice-controller.git
    cd kubeslice-controller
    
  2. Edit the image name variable IMG in the Makefile to change the docker tag to be built. The default image is set as IMG ?= aveshasystems/kubeslice-controller:latest. Modify this as required.

    make docker-build
    
Run Local Image on Kind Clusters
  1. Load the kubeslice-controller image into your kind cluster (kind). If needed, modify aveshasystems/kubeslice-controller with your locally built image name in the previous step.
  • Note: If you use a named cluster, you must specify the name of the cluster you wish to load the images into. See loading an image into your kind cluster.

    kind load docker-image aveshasystems/kubeslice-controller --name cluster-name
    

    Example

    kind load docker-image aveshasystems/kubeslice-controller --name kind
    
  1. Check the loaded image in the cluster. Modify the node name as required.
  • Note: kind-control-plane is the name of the Docker container. Modify the name if needed.
docker exec -it kind-control-plane critical images
Deploy the KubeSlice Controller on a Cluster
  1. Create a chart values file called yourvaluesfile.yaml. Refer to values.yaml to update the kubeslice-controller image to the local build image.

    From the sample:

    kubeslice:
    ---
    ---
       controller:
       ---
       ---
          image: aveshasystems/kubeslice-controller
          tag: 0.1.1
    

Change it to:

kubeslice:
---
---
   controller:
   ---
   ---
      image: <my-custom-image> 
      tag: <unique-tag>
  1. Deploy the updated chart.

    make chart-deploy VALUESFILE=yourvaluesfile.yaml
    
Verify the Installation

Verify the installation of the KubeSlice Controller by checking the pods belonging to the kubeslice-controller namespace using the following command:

kubectl get pods -n kubeslice-controller

Example Output

NAME                                            READY   STATUS    RESTARTS   AGE
kubeslice-controller-manager-5b548fb865-kzb7c   2/2     Running   0          102s
Uninstall the KubeSlice Controller

For more information, see uninstall KubeSlice.

make chart-undeploy

License

Apache License 2.0

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
apis
controller/v1alpha1
Package v1alpha1 contains API Schema definitions for the controller v1alpha1 API group +kubebuilder:object:generate=true +groupName=controller.kubeslice.io
Package v1alpha1 contains API Schema definitions for the controller v1alpha1 API group +kubebuilder:object:generate=true +groupName=controller.kubeslice.io
worker/v1alpha1
Package v1alpha1 contains API Schema definitions for the worker v1alpha1 API group +kubebuilder:object:generate=true +groupName=worker.kubeslice.io
Package v1alpha1 contains API Schema definitions for the worker v1alpha1 API group +kubebuilder:object:generate=true +groupName=worker.kubeslice.io
controllers
hack

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL