core

Kubernetes service

• Usage
• Get k8s resource info
• Create resources
• Apply - create or patch resources
• Run - crete resource from template
• Expose resource
• Delete Resource
• Config Maps
• Secrets
• Forwarding ports
• Global contract parameters

This service is *k8s.io/client-go/kubernetes.Clientset proxy

It defines helper method to deal with basic operation in a friendly way.

To check all supported method run

     endly -s='kubernetes'

or to check service contract endly -s='kubernetes' -a=ACTION

     endly -s='kubernetes' -a=get

Usage

Get k8s resource info

endly kubernetes:get kind=pod

 endly kubernetes:get kind=pod labelSelector="run=load-balancer-example"

endly kubernetes:get kind=endpoints 

Create resources

Create resource(s) with create API method call.

1. Create with external resource:

   endly -run='kubernetes:create' URL=test/deployment.yaml
   

2. Create workflow

   • @create.yaml endly -r=create

   pipeline:
     createNginx:
       action: kubernetes:create
       apiVersion: apps/v1
       kind: Deployment
       metadata:
         labels:
           run: nginx
         name: nginx
       spec:
         replicas: 1
         selector:
           matchLabels:
             run: nginx
         template:
           metadata:
             labels:
               run: nginx
           spec:
             containers:
               - image: nginx
                 imagePullPolicy: Always
                 name: nginx
             restartPolicy: Always
   

Apply - create or patch resources

Create resource(s) with create API method call or apply patch.

1. Apply with external resource:

   endly -run='kubernetes:apply' URL=test/deployment.yaml
   

2. Apply workflow

   • @apply.yaml endly -r=apply

   pipeline:
     applyNginx:
       action: kubernetes:apply
       URL: someURL.yaml
   

Run - crete resource from template

1. Start a single instance (apps/v1.Deployment template)

• Start a single instance of nginx cli.

  endly -run='kubernetes:run' name=nginx image=nginx  port=80 
  

• Start a single instance of hazelcast, expose port 5701 and set environment variables "DNS_DOMAIN=cluster" and "POD_NAMESPACE=default" in the container.

  endly -run='kubernetes:run' name=hazelcast image=hazelcast port=5701 env.DNS_DOMAIN=cluster env.POD_NAMESPACE=default
  

• Start a single instance of hazelcast and set labels "app=hazelcast" and "env=prod" in the container.
  • @run_single.yaml endly -r=run_single

  pipeline:
    runHazelcast:
      action: kubernetes:run
      name: hazelcast
      image: hazelcast
      labels:
        app: hazelcast
        env: prod
  

1. Start a replicated instance (apps/v1.Deployment template)
   • @run_replicas.yaml endly -r=run_replicas

   pipeline:
     runNgix:
       action: kubernetes:run
       name: nginx
       image: nginx
       replicas: 5
   

2. Start single pod instance (v1.Pod template)
   • @run_pod.yaml endly -r=run_pod

   pipeline:
     runPod:
       action: kubernetes:run
       name: nginx
       image: nginx
       restartPolicy: Never
   

3. Start the perl container to compute π to 2000 places and print it out. (batch/v1.Job template)
   • @run_job.yaml endly -r=run_job

   pipeline:
     runJob:
       action: kubernetes:run
       name: pi
       image: perl
       restartPolicy: OnFailure
       commands:
         - "perl -Mbignum=bpi -wle 'print bpi(2000)'"
   

4. Start the cron job to compute π to 2000 places and print it out every 1 minutes.
   • @schedule.yaml endly -r=schedule

   pipeline:
     runJob:
       action: kubernetes:run
       name: pi
       image: perl
       schedule: 0/1 * * * ?
       commands:
         - "perl -Mbignum=bpi -wle 'print bpi(2000)'"
   

Expose resources

Expose resource(s) port via service port.

1. Create a service for a explicit resource and port

   endly -run=kubernetes:expose resource=Deployment/nginx port=8080 targetPort=80 type=NodePort
   

2. • @expose.yaml endly -r=expose

   pipeline:
     applyNginx:
       action: kubernetes:expose
       name: myService
       resource: Deployment/myApp
   

Delete resources

1. Delete resource

   endly -run='kubernetes:delete' kind=pod name=myPod
   

2. Delete resources

   endly -run='kubernetes:delete' kind='*' name=myPod
   

3. Delete resource from file

   endly -run='kubernetes:delete' URL=resources.yaml
   

Config Maps

1. Creating config maps with yaml resource file

   • endly -r=create_config
   • @create_config.yaml @config.yaml

   pipeline:
     createConfig:
       action: kubernetes:create
       URL: config.yaml
       expand: true
   

2. Creating config maps

   • endly -r=configmaps
   • @configmap

   pipeline:
     createConfig:
       action: kubernetes:create
       kind: ConfigMap
       apiVersion: v1
       metadata:
         name: examplecfg
       data:
         config.property.1: value1
         config.property.2: value2
         config.properties: |-
           property.1=value-1
           property.2=value-2
           property.3=value-3
       binaryData:
         foo: L3Jvb3QvMTAw
   

3. Creating config maps for folder/URL

   • endly -r=configmap_from_file
   • @configmap_from_file.yaml

   pipeline:
     createConfig:
       action: kubernetes:create
       kind: ConfigMap
       apiVersion: v1
       metadata:
         name: mycfg
       data: $AssetsToMap('config/')
       binaryData: $BinaryAssetsToMap('config/bin')
   

Secrets

1. Creating secrets from literals
   • endly -r=raw_secrets
   • @raw_secrets

   init:
     username: $Cat(somefile.txt)
     password: dev
   pipeline:
     setSecrets:
       action: kubernetes:apply
       apiVersion: v1
       kind: Secret
       metadata:
         name: my-secrets
       type: Opaque
       data:
         username: $Base64Encode($username)
         password: $Base64Encode($password)    
   

2. Creating secrets with endly secrets
   • endly -r=endly_secrets
   • @endly_secrets

   init:
     devSecrets: $secrets.dev
   pipeline:
     info:
       action: print
       message: $devSecrets.Data
   
     setSecrets:
       action: kubernetes:apply
       apiVersion: v1
       kind: Secret
       metadata:
         name: dev-secrets
       type: Opaque
       data:
         dev.json: $Base64Encode($devSecrets.Data)
         username: $Base64Encode($devSecrets.Username)
         password: $Base64Encode($devSecrets.Password)
   
   

3. Testing secrets without pipeline
   • endly kubernetes:get secrets kind=secret name=dev-secrets
   • endly kubernetes:get secrets kind=secret
   • endly kubernetes:apply url=dev-secrets.yaml

Forwarding ports

1. Forwarding port for service in interactive mode (-m)
   • endly -r=forward -m
   • @forward.yaml

   pipeline:
     setup:
       action: kubernetes:forwardPorts
       kind: service
       name: mysql
       ports:
         - 3306:3306
   

2. Forwarding port for pod
   • endly -r=forward
   • @forward.yaml

   pipeline:
     setup:
       action: kubernetes:forwardPorts
       kind: pod
       name: mysql-648d67bf7c-prfgs
       ports:
         - 3306:3306
   

Global contract parameters

• context
• namespace
• kubeconfig
• masterurl