Page Comparison

...

Code Block

language	bash
title	Configure k8s cluster

docker exec -it <k8s-pod container id> sh

mkdir  ~/.kube ( create a file “config” with cluster config data)

chmod 600 ~/.kube/config

Note: Planning to automate this manual step using HTTP participant in Jakarta and even in Istanbul as a fix if we have time.

Verification:

Now the helm cli in the k8s-participant should be pointing to the configured cluster.

Ex: helm ls → Gives the deployment details from the configured cluster.

Note: The ip of the external cluster is expected to be properly configured on the config.

The k8s-participant can now be used in CLAMP CL workflow to deploy any microservices like PMSH in to the configured cluster.

Commission Control loop to CL Runtime:

Commission Control loop TOSCA definitions to Runtime.

The CL definitions are commissioned to CL runtime which populates the CL runtime database. The following sample TOSCA template which contains PMSH CL definitions under node template, will be passed on to this endpoint as request body. (Please refer node template section). Helm chart properties along with override parameters are supplied under the node template of CL element.

Code Block

language	text
title	Commissioning Endpoint

https://<CL Runtime IP> : <Port> /onap/controlloop/v2/commission

Request body:

Code Block

language	yml
title	Commissioning

tosca_definitions_version: tosca_simple_yaml_1_3
data_types:
  onap.datatypes.ToscaConceptIdentifier:
    derived_from: tosca.datatypes.Root
    properties:
      name:
        type: string
        required: true
      version:
        type: string
        required: true
node_types:
  org.onap.policy.clamp.controlloop.Participant:
    version: 1.0.1
    derived_from: tosca.nodetypes.Root
    properties:
      provider:
        type: string
        requred: false
  org.onap.policy.clamp.controlloop.ControlLoopElement:
    version: 1.0.1
    derived_from: tosca.nodetypes.Root
    properties:
      provider:
        type: string
        required: false
      participant_id:
        type: onap.datatypes.ToscaConceptIdentifier
        requred: true
  org.onap.policy.clamp.controlloop.ControlLoop:
    version: 1.0.1
    derived_from: tosca.nodetypes.Root
    properties:
      provider:
        type: string
        required: false
      elements:
        type: list
        required: true
        entry_schema:
          type: onap.datatypes.ToscaConceptIdentifier
  org.onap.policy.clamp.controlloop.K8SMicroserviceControlLoopElement:
    version: 1.0.1
    derived_from: org.onap.policy.clamp.controlloop.ControlLoopElement
    properties:
      chart:
        type: string
        required: true
      configs:
        type: list
        required: false
      requirements:
        type: string
        required: false
      templates:
        type: list
        required: false
        entry_schema:
      values:
        type: string
        required: true
topology_template:
  node_templates:
    org.onap.k8s.controlloop.K8SControlLoopParticipant:
      version: 2.3.4
      type: org.onap.policy.clamp.controlloop.Participant
      type_version: 1.0.1
      description: Participant for K8S
      properties:
        provider: ONAP   
    org.onap.domain.database.PMSH_K8SMicroserviceControlLoopElement:   
      version: 1.2.3
      type: org.onap.policy.clamp.controlloop.K8SMicroserviceControlLoopElement
      type_version: 1.0.0
      description: Control loop element for the K8S microservice PMSH
      properties:
        provider: ONAP
        participant_id:
          name: org.onap.k8s.controlloop.K8SControlLoopParticipant
          version: 2.3.4
        chart:          
          chartId: 
            name: dcae-pmsh         
            version: 8.0.0
          namespace: onap 
          releaseName: pmshms
          overrideParams:
            global.masterPassword: test    
          repository:
             repoName: chartmuseum
             address: 172.125.16.1
             port: 8080
             protocol: http
             username: onapinitializer
             password: demo123456!                               
    org.onap.domain.sample.GenericK8s_ControlLoopDefinition:
      version: 1.2.3
      type: org.onap.policy.clamp.controlloop.ControlLoop
      type_version: 1.0.0
      description: Control loop for Hello World
      properties:
        provider: ONAP
        elements:      
        - name: org.onap.domain.database.PMSH_K8SMicroserviceControlLoopElement
          version: 1.2.3

Instantiate Control loop:

Instantiation dialogues are used to create, set parameters on, instantiate, update, and remove Control Loop instances. Assume a suitable Control Loop Definition exists in the Commissioned Control Loop Inventory. To get a Control Loop instance running instantiate and update the Control loop state. The following sample json represents the request body for instantiating the CL elements under the control loop to UNINITIALISED state.

Code Block

language	text
title	Instantiation Endpoint

https://<CL Runtime IP> : <Port> /onap/controlloop/v2/instantiation

Request body:

Elite soft json viewer

{
"controlLoopList": [
{
"name": "K8SInstance0",
"version": "1.0.1",
"definition": {
"name": "org.onap.domain.sample.GenericK8s_ControlLoopDefinition",
"version": "1.2.3"
},
"state": "UNINITIALISED",
"orderedState": "UNINITIALISED",
"description": "K8s control loop instance 0",
"elements": { 
"709c62b3-8918-41b9-a747-d21eb79c6c21": {
"id": "709c62b3-8918-41b9-a747-d21eb79c6c21",
"definition": {
"name": "org.onap.domain.database.PMSH_K8SMicroserviceControlLoopElement",
"version": "1.2.3"
},
"participantId" :{
"name": "org.onap.k8s.controlloop.K8SControlLoopParticipant",
"version": "2.3.4"
},
"participantType": {
"name": "org.onap.k8s.controlloop.K8SControlLoopParticipant",
"version": "2.3.4"
},
"state": "UNINITIALISED",
"orderedState": "UNINITIALISED",
"description": "K8s Control Loop Element for the PMSH instance 0 control loop"
} 
}
}
]
}

Update Control loop to PASSIVE state:

When the Control loop is updated with state “PASSIVE”, the Kubernetes participant fetches the node template for all control loop elements and deploys the helm chart of each CL element in to the cluster. The following sample json input is passed on the request body.

Code Block

language	text
title	Control loop Update

https://<CL Runtime IP> : <Port> /onap/controlloop/v2/command

Request body:

Elite soft json viewer
{ "orderedState": "PASSIVE", "controlLoopIdentifierList": [ { "name": "K8SInstance0", "version": "1.0.1" } ] }

Control loops can be "UNINTIALISED" after deployment:

Under the UNINITIALISED state, all the helm deployments under a control loop will be uninstalled from the cluster.

Code Block

language	text
title	Control loop Update

https://<CL Runtime IP> : <Port> /onap/controlloop/v2/command

Request body:

Elite soft json viewer
{ "orderedState": "UNINITIALISED", "controlLoopIdentifierList": [ { "name": "K8SInstance0", "version": "1.0.1" } ] }

K8s-particpant as a standalone application:

The participant can be deployed as a standalone application in docker by configuring the kubernetes cluster manually as mentioned in the first step.

It supports various REST end points for onboarding, installing, uninstalling and retrieval of helm charts from local chart repository. The following REST endpoints are exposed for the various helm operations. The participant maintains the helm charts in its local chart repository with the provision to add/delete charts.

Image Added

POST: Onboard a chart to the k8s-participant’s local file system:

Helm charts can be onboarded along with its overrides yaml file to the participant’s local chart repository. Accepts the .tgz files in form-data for helm chart and overrides.yaml files, we are also expected to pass the json input describing the chart info. Sample input below:

Code Block

language	text
title	Onboard a chart

https://<K8s-participant ip> : <port> /onap/k8sparticipant/helm/onboard/chart

Request body:

Elite soft json viewer
{ "chartId" : { "name": "dcae-pmsh", "version": 8.0 }, "namespace" : "onap", "releaseName" : "dcae-pmsh-svc" }

POST: Install a pre onboarded chart from local chart repository:

The onboarded helm charts can be installed to the Kubernetes cluster. It accepts a json input specifying the chart name and version that needs to be installed. The deployment information will be gathered from the chart info that was provided while onboarding. Sample json input:

Code Block

language	text
title	Install chart

https://<K8s-participant ip> : <port> /onap/k8sparticipant/helm/install

Request body:

Elite soft json viewer
{ "name": "dcae-pmsh", "version": "8.0" }

GET: Retrieve all the available local charts :

This API helps to retrieve all the charts along with the version from the local chart repository.

Code Block

language	text
title	Retrieve charts

https://<K8s-participant ip> : <port> /onap/k8sparticipant/helm/charts

DELETE: Delete a helm chart from local repository:

Deletes a helm chart from the local chart repository of Kubernetes participant.

Code Block

language	text
title	Delete a chart

https://<K8s-participant ip> : <port> /onap/k8sparticipant/helm/chart/{name}/{version}

DELETE: Uninstall a helm chart from Kubernetes cluster:

Any installed helm chart can be uninstalled from the cluster.

Code Block

language	text
title	Uninstall a chart

https://<K8s-participant ip> : <port> /onap/k8sparticipant/helm/uninstall/{name}/{version}

Add a remote repository to the k8s-participant:

Remote helm repositories can be added via both TOSCA/ REST API. Once the remote helm repository is configured on the participant, any helm charts from the repository can be installed by k8s-particpant. Sample json body for adding a remote repository:

Code Block

language	text
title	Add a repository

https://<K8s-participant ip> : <port> /onap/k8sparticipant/helm/repo

Request body:

Elite soft json viewer
{ "repoName": "chartmuseum", "address": "172.125.16.20", "protocol": "http", "port": "8080", "username": "onapinitializer", "password": "demo123456!" }

Versions Compared

Old Version 2

New Version Current

Key

Verification:

Commission Control loop to CL Runtime:

Instantiate Control loop:

Update Control loop to PASSIVE state:

Control loops can be "UNINTIALISED" after deployment:

K8s-particpant as a standalone application:

POST: Onboard a chart to the k8s-participant’s local file system:

POST: Install a pre onboarded chart from local chart repository:

GET: Retrieve all the available local charts :

DELETE: Delete a helm chart from local repository:

DELETE: Uninstall a helm chart from Kubernetes cluster:

Add a remote repository to the k8s-participant: