worker-operator

command module
v1.5.5 Latest Latest
Warning

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

Go to latest
Published: Apr 15, 2024 License: Apache-2.0 Imports: 42 Imported by: 0

README

Kubeslice Worker Operator

The Kubeslice Worker Operator, also known as Slice Operator manages the lifecycle of KubeSlice worker cluster-related custom resource definitions (CRDs). The kubeslice-worker operator uses Kubebuilder, a framework for building Kubernetes APIs using CRDS.

Get Started

It is strongly recommended that you use a released version.

Please refer to our documentation on:

Install kubeslice-worker on a Kind Cluster

Prerequisites

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

Build and Deploy a Worker Operator on a Kind Cluster

To download the latest Worker Operator docker image, click here.

docker pull aveshasystems/worker-operator:latest
Setting up Your Helm Repo

If you have not added avesha helm repo yet, add it.

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

Upgrade the avesha helm repo.

helm repo update
Get Secrets from the Controller Cluster (if it's not already done)

The following command will get the relevant secrets from the controller cluster and copy them to the secrets folder. Additionally, it will return the secrets so that we can use them to populate the helm chart values.

deploy/controller_secret.sh [controller_cluster_context] [project_namespace] [worker_cluster_name]

Example

deploy/controller_secret.sh gke_avesha-dev_us-east1-c_xxxx kubeslice-cisco my-awesome-cluster
Build Docker Images
  1. Clone the latest version of worker-operator from the master branch.

    git clone https://github.com/kubeslice/worker-operator.git
    cd worker-operator
    
  2. Edit the VERSION variable in the Makefile to change the docker tag to be built. The image is set as docker.io/aveshasystems/worker-operator:$(VERSION) in the Makefile. Modify this if required.

    make docker-build
    
Run the Local Image on a Kind Cluster
  1. You can load the Worker Operator on your kind cluster using the following command:

    kind load docker-image <my-custom-image>:<unique-tag> --name <cluster-name>
    

    Example:

    kind load docker-image aveshasystems/worker-operator:1.2.1 --name kind
    
  2. Check the loaded image in the cluster. Modify the node name if required.

    docker exec -it <node-name> crictl images
    

    Example:

    docker exec -it kind-control-plane crictl images
    
Deploy the Worker Operator on a Cluster

Create a chart values file called yourvaluesfile.yaml. Refer to values.yaml to create yourvaluesfile.yaml and update the operator image subsection to use the local image.

From the sample:

operator:
  image: docker.io/aveshasystems/worker-operator
  tag: 0.2.3

Change it to:

operator:
  image: <my-custom-image> 
  tag: <unique-tag>

Deploy the Updated Chart

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

Verify the installation by checking the status of pods belonging to the kubeslice-system namespace.

kubectl get pods -n kubeslice-system

Example output

NAME                                     READY   STATUS    RESTARTS   AGE
jaeger-65c6b7f5dd-frxtx                  1/1     Running   0          49s
kubeslice-netop-g4hqd                    1/1     Running   0          49s
kubeslice-operator-6844b47cf8-c8lv2      2/2     Running   0          48s
mesh-dns-65fd8585ff-nlp5h                1/1     Running   0          48s
nsm-admission-webhook-7b848ffc4b-dhn96   1/1     Running   0          48s
nsm-kernel-forwarder-fd74h               1/1     Running   0          49s
nsm-kernel-forwarder-vvrp6               1/1     Running   0          49s
nsmgr-62kdk                              3/3     Running   0          48s
nsmgr-7dh2w                              3/3     Running   0          48s
prefix-service-76bd89c44f-2p6dw          1/1     Running   0          48s
Uninstall the Worker Operator

For more information, see deregister the worker cluster.

helm uninstall kubeslice-worker -n kubeslice-system

License

Apache License 2.0

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
api
v1beta1
Package v1beta1 contains API Schema definitions for the mesh v1beta1 API group +kubebuilder:object:generate=true +groupName=networking.kubeslice.io
Package v1beta1 contains API Schema definitions for the mesh v1beta1 API group +kubebuilder:object:generate=true +groupName=networking.kubeslice.io
slice
* Copyright (c) 2022 Avesha, Inc.
* Copyright (c) 2022 Avesha, Inc.
hack
pkg
namespace/controllers
* Copyright (c) 2022 Avesha, Inc.
* Copyright (c) 2022 Avesha, Inc.
networkpolicy
* Copyright (c) 2022 Avesha, Inc.
* Copyright (c) 2022 Avesha, Inc.
tests

Jump to

Keyboard shortcuts

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