Disclaimer
This repository is provided "AS-IS" with no warranty or support given. This is not an official or supported product/use case.
Download the extension package from
https://github.com/ptc-iot-sharing/KubernetesThing/releases/download/v1.0.263/Kube.zip
Description
Kubernetes is an open-source container orchestration system for automating application deployment, scaling, and management. It was originally designed by Google.
This is a ThingWorx extension that implements part of the Kubernetes API and uses the Java client library to run commands on a Kubernetes master node.
Note that this is a proof-of -concept project, meant to demonstrate that ThingWorx can integrate with Kubernetes; it would not be advisable to use the extension as is in a production environment. Using this project as a starting point, a ThingWorx developer interested in adding such functionality to their project, can expand it to implement more API endpoints and implement secured access/authorization.
This extension uses the official Kubernetes Java client library to run commands on a Kubernetes Master.
-
listPods - Return a list of pods for a namespace
-
listServices - Return a list of services for a namespace
-
scaleDeployment - Scale a deployment up or down. Setting the scale to 0 will disable the deployment
-
getPodLogs - Get the logs for a specific pod
-
createDeployment – Create a deployment using the appsV1beta1Api.createNamespacedDeployment by passing in a AppsV1beta1Deployment YAML formatted file
At present the extension will look for a Kubernetes master instance on localhost, without SSL. In KubeThing.java the API client is instantiated as:
client = Config.fromUrl("http://127.0.0.1:8001", false);
This type of connection requires that you run:
kubectl proxy --port=8001
in a terminal with a user that is configured to use kubectl:
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
after you have successfully started the Kubernetes master node.
The configuration page of the Kubernetes Thing can be left unchanged as the fields are not usable. To change the default configuration for the target server, the extension must be rebuilt with the variables changed in the source code.
By downloading this software, the user acknowledges that it is unsupported, not reviewed for security purposes, and that the user assumes all risk for running it.
Users accept all risk whatsoever regarding the security of the code they download.
This software is not an official PTC product and is not officially supported by PTC.
PTC is not responsible for any maintenance for this software.
PTC will not accept technical support cases logged related to this Software.
This source code is offered freely and AS IS without any warranty.
The author of this code cannot be held accountable for the well-functioning of it.
The author shared the code that worked at a specific moment in time using specific versions of PTC products at that time, without the intention to make the code compliant with past, current or future versions of those PTC products.
The author has not committed to maintain this code and he may not be bound to maintain or fix it.
I accept the MIT License (https://opensource.org/licenses/MIT) and agree that any software downloaded/utilized will be in compliance with that Agreement. However, despite anything to the contrary in the License Agreement, I agree as follows:
I acknowledge that I am not entitled to support assistance with respect to the software, and PTC will have no obligation to maintain the software or provide bug fixes or security patches or new releases.
The software is provided “As Is” and with no warranty, indemnitees or guarantees whatsoever, and PTC will have no liability whatsoever with respect to the software, including with respect to any intellectual property infringement claims or security incidents or data loss.