This guides describes how to configure and deploy a Greenhouse plugin.
apiVersion: greenhouse.sap/v1alpha1
kind: Plugin
metadata:
name: kube-monitoring-martin
namespace: <organization namespace> # same namespace in remote cluster for resources
spec:
clusterName: <name of the remote cluster >
disabled: false
displayName: <any human readable name>
pluginDefinition: <pluginDefinition name>
releaseNamespace: <namespace> # namespace in remote cluster where the plugin is deployed
releaseName: <helm release name> # name of the helm release that will be created
optionValues:
- name: <from the plugin options>
value: <from the plugin options>
- ...
Plugins deploying Helm Charts into remote clusters support exposed services.
By adding the following label to a service in helm chart it will become accessible from the central greenhouse system via a service proxy:
greenhouse.sap/expose: "true"
Create the Plugin resource via the command:
kubectl --namespace=<organization name> create -f plugin.yaml
Check with kubectl --namespace=<organization name> get plugin
has been properly created. When all components of the plugin are successfully created, the plugin should show the state configured.
Check in the remote cluster that all plugin resources are created in the organization namespace.
After deploying the plugin to a remote cluster, ExposedServices section in Plugin’s status provides an overview of the Plugins services that are centrally exposed. It maps the exposed URL to the service found in the manifest.
$https://$cluster--$hash.$organisation.$basedomain
. The $hash
is computed from service--$namespace
.