Skip to content

flussonic/watcher-operator

Repository files navigation

Watcher Operator

This Watcher Operator is an implementation of Kubernetes Operator that allows to launch Watcher VMS in k8s:

apiVersion: media.flussonic.com/v1alpha1
kind: Watcher
metadata:
  name: watcher
spec:
  central: "http://central.default.svc.cluster.local"
  database: "postgresql://test:test@postgres.default.svc.cluster.local:5432/test_c"
  image: "flussonic/watcher:v24.03-2"
  env:
    - name: LICENSE_KEY
      value: "your-license-key"
    - name: WATCHER_ADMIN_LOGIN
      value: "admin"
    - name: WATCHER_ADMIN_PASSWORD
      value: "initialpassword"
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: watcher-sample
spec:
  defaultBackend:
    service:
      name: watcher-sample-web
      port:
        number: 80

This Operator will create about 10 different resources and manage them.

Main feature here is maintaining database migrations

Usage

To test on your laptop with multipass VM management tool:

./mp-start.sh

On your k8s installation:

kubectl label nodes streamer flussonic.com/streamer=true
kubectl create secret generic flussonic-license \
    --from-literal=license_key="${LICENSE_KEY}" \
    --from-literal=edit_auth="root:password"


kubectl apply -f https://flussonic.github.io/watcher-operator/latest/operator.yaml
kubectl apply -f config/samples/media_v1alpha1_watcher.yaml

Then it will run on your server.

Development of watcher-operator

Prerequisites

  • go version v1.20.0+
  • docker version 17.03+.
  • kubectl version v1.11.3+.
  • Access to a Kubernetes v1.11.3+ cluster.

To Deploy on the cluster

Build and push your image to the location specified by IMG:

make docker-buildx
make operator.yaml
git add docs

NOTE: This image ought to be published in the public registry.

Develop locally

make all install run

Another tab:

kubectl apply -k config/samples/

Delete the APIs(CRDs) from the cluster:

make uninstall

UnDeploy the controller from the cluster:

make undeploy

Contributing

// TODO(user): Add detailed information on how you would like others to contribute to this project

NOTE: Run make help for more information on all potential make targets

More information can be found via the Kubebuilder Documentation

License

Copyright 2024.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.