ruby-kubernetes-controller 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e1d7bfdc1de0725fb1f2d4cad6780c71f58bc8dd619836d80514f81f80c706ac
+  data.tar.gz: 4650e322ec9b9ef297e782e17f0b245f16e05d8432aecb8ef1c02d6b6896e054
+SHA512:
+  metadata.gz: b6637290fee0b38a28187a4f4f9ca100eef89de7476ebe7feacda2b23e97697111532ceb9a66358b3f0b389def34ce5fedbf77b3229366cc5ad6279cc676dc4d
+  data.tar.gz: dc1339715316475a8600ab9d5d5eeec4259a2554a42dd95e2fcf9579e250095093cc48324249174e1de407176b5b564cf32de9512bd1ab368932790a3c5f39c5

data/.circleci/config.yml

@@ -0,0 +1,131 @@
+# Ruby CircleCI 2.0 configuration file
+#
+# Check https://circleci.com/docs/2.0/language-ruby/ for more details
+#
+jobs:
+  build:
+    docker:
+      - image: circleci/ruby:2.6.3
+
+    working_directory: ~/repo
+    steps:
+      - checkout
+      - run:
+          name: Install Bundler
+          command: gem install bundler
+      - restore_cache:
+          keys:
+            - ruby-kubernetes-controller-{{ checksum "ruby-kubernetes-controller.gemspec" }}
+            # fallback to using the latest cache if no exact match is found
+            - ruby-kubernetes-controller-
+      - run:
+          name: Install Bundles
+          command: bundle check || bundle install
+      - save_cache:
+          paths:
+            - ./vendor/bundle
+          key: ruby-kubernetes-controller-{{ checksum "ruby-kubernetes-controller.gemspec" }}
+      - run:
+          name: Build gem
+          command: gem build ruby-kubernetes-controller.gemspec
+
+  test:
+    docker:
+      - image: circleci/ruby:2.6.3
+
+    working_directory: ~/repo
+    steps:
+      - checkout
+      - run:
+          name: Install Bundler
+          command: gem install bundler
+      - restore_cache:
+          keys:
+            - ruby-kubernetes-controller-{{ checksum "ruby-kubernetes-controller.gemspec" }}
+            # fallback to using the latest cache if no exact match is found
+            - ruby-kubernetes-controller-
+      - run:
+          name: Install Bundles
+          command: bundle check || bundle install
+      - save_cache:
+          paths:
+            - ./vendor/bundle
+          key: ruby-kubernetes-controller-{{ checksum "ruby-kubernetes-controller.gemspec" }}
+      - run:
+          name:
+          command: bundle exec rake test
+          when: always
+      - store_test_results:
+          path: test/reports
+
+  publish:
+    docker:
+      - image: circleci/ruby:2.6.3
+
+    working_directory: ~/repo
+    steps:
+      - checkout
+      - run:
+          name: Setup Rubygems
+          command: bash .circleci/setup-rubygems.sh
+
+      - run:
+          name: Publish to Rubygems
+          command: |
+            gem build ruby-kubernetes-controller.gemspec
+            gem push ruby-kubernetes-controller-$CIRCLE_TAG.gem
+
+workflows:
+  version: 2
+  development-build:
+      jobs:
+        - build:
+            filters:
+              tags:
+                only: /^dev.*/
+              branches:
+                ignore: /.*/
+        - test:
+            requires:
+              - build
+            filters:
+              tags:
+                only: /^dev.*/
+              branches:
+                ignore: /.*/
+  production-build:
+    jobs:
+      - build:
+          filters:
+            tags:
+              only: /^\d+(\.\d+)*$/
+            branches:
+              ignore: /.*/
+      - test:
+          requires:
+            - build
+          filters:
+            tags:
+              only: /^\d+(\.\d+)*$/
+            branches:
+              ignore: /.*/
+      - hold:
+          type: approval
+          requires:
+            - test
+            - build
+          filters:
+            tags:
+              only: /^\d+(\.\d+)*$/
+            branches:
+              ignore: /.*/
+      - publish:
+          requires:
+            - build
+            - test
+            - hold
+          filters:
+            tags:
+              only: /^\d+(\.\d+)*$/
+            branches:
+              ignore: /.*/

data/.circleci/setup-rubygems.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+mkdir ~/.gem
+echo -e "---\r\n:rubygems_api_key: $RUBYGEMS_API_KEY" > ~/.gem/credentials
+chmod 0600 /home/circleci/.gem/credentials

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.idea/
+ruby-kubernetes-controller-*.gem
+Gemfile.lock
+.DS_Store

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at shivanshvij@ibm.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Documentation/DOCUMENTATION.md

@@ -0,0 +1,1606 @@
+# Documentation
+
+## Pre-requisites
+Before beginning, you must generate a bearer token for the Ruby Kubernetes Controller to use:
+
+
+1. Save the following as `serviceaccount.yaml` (file available [here][SERVICEACCOUNT])
+    <p align="center"><img width=100% src="./serviceaccount.png"></p>
+2. Run the following in a terminal, with `kubectl` pre-configured for your existing cluster
+    ```bash
+    $ kubectl apply -f serviceaccount.yaml
+    $ kubectl -n kube-system describe secret $(kubectl -n kube-system get secret | grep admin-user | awk '{print $1}')
+    ```
+3. Copy down your bearer token
+4. You can get your endpoint by running `kubectl cluster-info`
+
+###### Source: https://github.com/kubernetes/dashboard/wiki/Creating-sample-user
+#### Get Nodes
+* List all nodes
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    puts client.get_nodes # Returns JSON
+```
+#### Create Namespace
+* Create new Namespace
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    json_config = 
+    '{
+        "kind": "Namespace",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.create_new_namespace(json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    yaml_file_path = '/path/to/file.yaml'    
+        
+    puts yaml_client.create_new_namespace(yaml_file_path) # Returns JSON
+```
+
+#### Get Namespaces
+* List all Namespaces
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    puts client.get_all_namespaces # Returns JSON
+```
+
+#### Update Namespace
+* Update existing Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_update = 
+    '{
+        "kind": "Namespace",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespace(namespace, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = '/path/to/file.yaml'
+        
+    puts yaml_client.update_namespace(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Patch Namespace
+* Patch existing Namespace
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_namespace(namespace, patch) # Returns JSON
+```
+
+#### Delete Namespace
+* Delete existing Namespace
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_options = 
+    '{
+        "kind": "Namespace",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.delete_namespace(namespace, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'  
+    
+    puts yaml_client.delete_namespace(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Create Ingress
+* Create new Ingress
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/extensions/v1beta1/definitions/#_v1beta1_ingress
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "Ingress",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_ingress(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.create_new_ingress(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get Ingresses
+* List all Ingresses
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    puts client.get_all_ingresses # Returns JSON
+```
+
+#### Get Namespaced Ingresses
+* List all existing Ingresses in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_ingresses(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced Ingress
+* Get details for single Ingress in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    ingress_name = "ingress"
+    
+    puts client.get_single_namespaced_ingress(namespace, ingress_name) # Returns JSON
+```
+
+#### Update Ingress
+* Update existing Ingress in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/extensions/v1beta1/definitions/#_v1beta1_ingress
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    ingress_name = "ingress"
+    json_update = 
+    '{
+        "kind": "Ingress",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_ingress(namespace, ingress_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    ingress_name = "ingress"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.update_namespaced_ingress(namespace, ingress_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch Ingress
+* Patch existing Ingress
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    ingress_name = "ingress"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_ingress(namespace, ingress_name, patch) # Returns JSON
+```
+
+#### Delete Ingress
+* Delete existing Ingress
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    ingress_name = "ingress"
+    json_options = 
+    '{
+        "kind": "Ingress",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'    
+    
+    puts json_client.delete_ingress(namespace, ingress_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    ingress_name = "ingress"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.delete_ingress(namespace, ingress_name, yaml_file_path) # Returns JSON
+```
+
+#### Create Endpoint
+* Create new Endpoint
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_service
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "Endpoints",
+        "apiVersion": "v1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_endpoint(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'
+  
+    puts yaml_client.create_new_endpoint(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get Endpoints
+* List all Endpoints
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    puts client.get_all_endpoints # Returns JSON
+```
+
+#### Get Namespaced Endpoints
+* List all existing Endpoints in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_endpoints(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced Endpoint
+* Get details for single Endpoint in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    endpoint_name = "endpoint"
+    
+    puts client.get_single_namespaced_endpoint(namespace, endpoint_name) # Returns JSON
+```
+
+#### Update Endpoint
+* Update existing Endpoint in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_service
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    endpoint_name = "endpoint"
+    json_update = 
+    '{
+        "kind": "Endpoints",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_endpoint(namespace, endpoint_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    endpoint_name = "endpoint"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.update_namespaced_endpoint(namespace, endpoint_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch Endpoint
+* Patch existing Endpoint
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    endpoint_name = "endpoint"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_endpoint(namespace, endpoint_name, patch) # Returns JSON
+```
+
+#### Delete Endpoint
+* Delete existing Endpoint
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    endpoint_name = "endpoint"
+    json_options = 
+    '{
+        "kind": "Endpoints",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.delete_endpoint(namespace, endpoint_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    endpoint_name = "endpoint"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.delete_endpoint(namespace, endpoint_name, yaml_file_path) # Returns JSON
+```
+
+#### Create Pod
+* Create new Pod
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_service
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    pod = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "Pod",
+        "apiVersion": "v1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_pod(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.create_new_pod(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get Pods
+* List all Pods
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    pod = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl)
+    
+    puts client.get_all_pods # Returns JSON
+```
+
+#### Get Namespaced Pods
+* List all existing Pods in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    pod = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_pods(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced Pod
+* Get details for single Pod in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    pod = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl)
+    
+    namespace = "default"
+    pod_name = "pod"
+    
+    puts client.get_single_namespaced_pod(namespace, pod_name) # Returns JSON
+```
+
+#### Update Pod
+* Update existing Pod in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_service
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    pod = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    pod_name = "pod"
+    json_update = 
+    '{
+        "kind": "Pod",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_pod(namespace, pod_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    pod_name = "pod"
+    yaml_file_path = 'path/to/file.yaml'   
+    
+    puts yaml_client.update_namespaced_pod(namespace, pod_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch Pod
+* Patch existing Pod
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    pod = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl)
+    
+    namespace = "default"
+    pod_name = "pod"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_pod(namespace, pod_name, patch) # Returns JSON
+```
+
+#### Delete Pod
+* Delete existing Pod
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    pod = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    pod_name = "pod"
+    json_options = 
+    '{
+        "kind": "Pod",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.delete_pod(namespace, pod_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(pod, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    pod_name = "pod"
+    yaml_file_path = 'path/to/file.yaml'      
+    
+    puts yaml_client.delete_pod(namespace, pod_name, yaml_file_path) # Returns JSON
+```
+
+#### Create Service
+* Create new Service
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_service
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    service = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "Service",
+        "apiVersion": "v1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_service(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'      
+    
+    puts yaml_client.create_new_service(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get Services
+* List all Services
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    service = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl)
+    
+    puts client.get_all_services # Returns JSON
+```
+
+#### Get Namespaced Services
+* List all existing Services in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    service = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_services(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced Service
+* Get details for single Service in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    service = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl)
+    
+    namespace = "default"
+    service_name = "service"
+    
+    puts client.get_single_namespaced_service(namespace, service_name) # Returns JSON
+```
+
+#### Update Service
+* Update existing Service in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_service
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    service = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    service_name = "service"
+    json_update = 
+    '{
+        "kind": "Service",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_service(namespace, service_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    service_name = "service"
+    yaml_file_path = 'path/to/file.yaml'       
+    
+    puts yaml_client.update_namespaced_service(namespace, service_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch Service
+* Patch existing Service
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    service = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl)
+    
+    namespace = "default"
+    service_name = "service"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_service(namespace, service_name, patch) # Returns JSON
+```
+
+#### Delete Service
+* Delete existing Service
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    service = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(service, bearer_token, ssl)
+    
+    namespace = "default"
+    service_name = "service"
+    
+    puts client.delete_service(namespace, service_name) # Returns JSON
+```
+
+#### Create Deployment
+* Create new Deployment
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/extensions/v1beta1/definitions/#_v1beta1_deployment
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "Deployment",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_deployment(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.create_new_deployment(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get Deploymentes
+* List all Deploymentes
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    puts client.get_all_deploymentes # Returns JSON
+```
+
+#### Get Namespaced Deploymentes
+* List all existing Deploymentes in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_deploymentes(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced Deployment
+* Get details for single Deployment in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    deployment_name = "deployment"
+    
+    puts client.get_single_namespaced_deployment(namespace, deployment_name) # Returns JSON
+```
+
+#### Update Deployment
+* Update existing Deployment in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/extensions/v1beta1/definitions/#_v1beta1_deployment
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    deployment_name = "deployment"
+    json_update = 
+    '{
+        "kind": "Deployment",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_deployment(namespace, deployment_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    deployment_name = "deployment"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.update_namespaced_deployment(namespace, deployment_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch Deployment
+* Patch existing Deployment
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    deployment_name = "deployment"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_deployment(namespace, deployment_name, patch) # Returns JSON
+```
+
+#### Delete Deployment
+* Delete existing Deployment
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    deployment_name = "deployment"
+    json_options = 
+    '{
+        "kind": "Deployment",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'    
+    
+    puts json_client.delete_deployment(namespace, deployment_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    deployment_name = "deployment"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.delete_deployment(namespace, deployment_name, yaml_file_path) # Returns JSON
+```
+
+#### Create Replicaset
+* Create new Replicaset
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/extensions/v1beta1/definitions/#_v1beta1_replicaset
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "Replicaset",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_replicaset(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.create_new_replicaset(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get Replicasets
+* List all Replicasets
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    puts client.get_all_replicasets # Returns JSON
+```
+
+#### Get Namespaced Replicasets
+* List all existing Replicasets in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_replicasets(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced Replicaset
+* Get details for single Replicaset in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    replicaset_name = "replicaset"
+    
+    puts client.get_single_namespaced_replicaset(namespace, replicaset_name) # Returns JSON
+```
+
+#### Update Replicaset
+* Update existing Replicaset in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/extensions/v1beta1/definitions/#_v1beta1_replicaset
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    replicaset_name = "replicaset"
+    json_update = 
+    '{
+        "kind": "Replicaset",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_replicaset(namespace, replicaset_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    replicaset_name = "replicaset"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.update_namespaced_replicaset(namespace, replicaset_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch Replicaset
+* Patch existing Replicaset
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl)
+    
+    namespace = "default"
+    replicaset_name = "replicaset"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_replicaset(namespace, replicaset_name, patch) # Returns JSON
+```
+
+#### Delete Replicaset
+* Delete existing Replicaset
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    endpoint = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    replicaset_name = "replicaset"
+    json_options = 
+    '{
+        "kind": "Replicaset",
+        "apiVersion": "extensions/v1beta1",
+         ... 
+     }'    
+    
+    puts json_client.delete_replicaset(namespace, replicaset_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(endpoint, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    replicaset_name = "replicaset"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.delete_replicaset(namespace, replicaset_name, yaml_file_path) # Returns JSON
+```
+
+#### Create Configmap
+* Create new Configmap
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_configmap
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    configmap = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "ConfigMap",
+        "apiVersion": "v1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_configmap(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'
+  
+    puts yaml_client.create_new_configmap(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get Configmaps
+* List all Configmaps
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    configmap = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl)
+    
+    puts client.get_all_configmaps # Returns JSON
+```
+
+#### Get Namespaced Configmaps
+* List all existing Configmaps in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    configmap = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_configmaps(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced Configmap
+* Get details for single Configmap in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    configmap = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl)
+    
+    namespace = "default"
+    configmap_name = "configmap"
+    
+    puts client.get_single_namespaced_configmap(namespace, configmap_name) # Returns JSON
+```
+
+#### Update Configmap
+* Update existing Configmap in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_configmap
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    configmap = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    configmap_name = "configmap"
+    json_update = 
+    '{
+        "kind": "ConfigMap",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_configmap(namespace, configmap_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    configmap_name = "configmap"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.update_namespaced_configmap(namespace, configmap_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch Configmap
+* Patch existing Configmap
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    configmap = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl)
+    
+    namespace = "default"
+    configmap_name = "configmap"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_configmap(namespace, configmap_name, patch) # Returns JSON
+```
+
+#### Delete Configmap
+* Delete existing Configmap
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    configmap = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    configmap_name = "configmap"
+    json_options = 
+    '{
+        "kind": "ConfigMap",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.delete_configmap(namespace, configmap_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(configmap, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    configmap_name = "configmap"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.delete_configmap(namespace, configmap_name, yaml_file_path) # Returns JSON
+```
+
+#### Create PersistentVolume
+* Create new PersistentVolume
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_persistentvolume
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolume = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "persistentvolume",
+        "apiVersion": "v1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_persistentvolume(json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl, yaml = true)
+    # yaml file could be a link to a file in Cloud object storage or a github raw
+    yaml_file_path = 'path/to/file.yaml'
+  
+    puts yaml_client.create_new_persistentvolume(yaml_file_path) # Returns JSON
+```
+
+#### Get PersistentVolumes
+* List all PersistentVolumes
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolume = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl)
+    
+    puts client.get_all_persistentvolumes # Returns JSON
+```
+
+#### Get Single PersistentVolumes
+* Get details for single PersistentVolumes
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolume = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl)
+    
+    persistentvolume_name = "persistentvolume"
+    
+    puts client.get_single_persistentvolume(persistentvolume_name) # Returns JSON
+```
+
+#### Update PersistentVolumes
+* Update existing PersistentVolumes in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_persistentvolume
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolume = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl, yaml = false)
+    persistentvolume_name = "persistentvolume"
+    json_update = 
+    '{
+        "kind": "persistentvolume",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_persistentvolume(persistentvolume_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl, yaml = true)
+    persistentvolume_name = "persistentvolume"
+    # yaml file could be a link to a file in Cloud object storage or a github raw
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.update_namespaced_persistentvolume(persistentvolume_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch PersistentVolumes
+* Patch existing PersistentVolumes
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolume = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl)
+    
+    persistentvolume_name = "persistentvolume"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_persistentvolume(persistentvolume_name, patch) # Returns JSON
+```
+
+#### Delete PersistentVolumes
+* Delete existing PersistentVolumes
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolume = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl, yaml = false)
+    persistentvolume_name = "persistentvolume"
+    json_options = 
+    '{
+        "kind": "persistentvolume",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.delete_persistentvolume(persistentvolume_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(persistentvolume, bearer_token, ssl, yaml = true)
+    persistentvolume_name = "persistentvolume"
+    # yaml file could be a link to a file in Cloud object storage or a github raw
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.delete_persistentvolume(persistentvolume_name, yaml_file_path) # Returns JSON
+```
+
+#### Create PersistentVolumeClaim
+* Create new PersistentVolumeClaim
+* Config options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_persistentvolumeclaim
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolumeclaim = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    json_config = 
+    '{
+        "kind": "persistentvolumeclaim",
+        "apiVersion": "v1",
+         ... 
+     }'   
+    
+    puts json_client.create_new_persistentvolumeclaim(namespace, json_config) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    yaml_file_path = 'path/to/file.yaml'
+  
+    puts yaml_client.create_new_persistentvolumeclaim(namespace, yaml_file_path) # Returns JSON
+```
+
+#### Get PersistentVolumeClaims
+* List all PersistentVolumeClaims
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolumeclaim = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl)
+    
+    puts client.get_all_persistentvolumeclaims # Returns JSON
+```
+
+#### Get Namespaced PersistentVolumeClaims
+* List all existing PersistentVolumeClaims in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolumeclaim = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl)
+    
+    namespace = "default"
+    
+    puts client.get_all_namespaced_persistentvolumeclaims(namespace) # Returns JSON
+```
+
+#### Get Single Namespaced PersistentVolumeClaims
+* Get details for single PersistentVolumeClaims in Namespace
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolumeclaim = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl)
+    
+    namespace = "default"
+    persistentvolumeclaim_name = "persistentvolumeclaim"
+    
+    puts client.get_single_namespaced_persistentvolumeclaim(namespace, persistentvolumeclaim_name) # Returns JSON
+```
+
+#### Update PersistentVolumeClaims
+* Update existing PersistentVolumeClaims in Namespace
+* Update options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_persistentvolumeclaim
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolumeclaim = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    persistentvolumeclaim_name = "persistentvolumeclaim"
+    json_update = 
+    '{
+        "kind": "persistentvolumeclaim",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.update_namespaced_persistentvolumeclaim(namespace, persistentvolumeclaim_name, json_update) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    persistentvolumeclaim_name = "persistentvolumeclaim"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.update_namespaced_persistentvolumeclaim(namespace, persistentvolumeclaim_name, yaml_file_path) # Returns JSON
+```
+
+#### Patch PersistentVolumeClaims
+* Patch existing PersistentVolumeClaims
+* Patch Format documentation available at: http://jsonpatch.com/
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolumeclaim = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl)
+    
+    namespace = "default"
+    persistentvolumeclaim_name = "persistentvolumeclaim"
+    patch = 
+    '[
+      { "op": "replace", "path": "/baz", "value": "boo" },
+      { "op": "add", "path": "/hello", "value": ["world"] },
+      { "op": "remove", "path": "/foo" }
+    ]'    
+    
+    puts client.patch_persistentvolumeclaim(namespace, persistentvolumeclaim_name, patch) # Returns JSON
+```
+
+#### Delete PersistentVolumeClaims
+* Delete existing PersistentVolumeClaims
+* Delete options documentation available at: https://kubernetes.io/docs/reference/federation/v1/definitions/#_v1_deleteoptions
+```ruby
+    require 'ruby-kubernetes-controller'
+    
+    persistentvolumeclaim = "localhost"
+    bearer_token = "token"
+    ssl = false
+    
+    # With JSON
+    json_client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl, yaml = false)
+    namespace = "default"
+    persistentvolumeclaim_name = "persistentvolumeclaim"
+    json_options = 
+    '{
+        "kind": "persistentvolumeclaim",
+        "apiVersion": "v1",
+         ... 
+     }'    
+    
+    puts json_client.delete_persistentvolumeclaim(namespace, persistentvolumeclaim_name, json_options) # Returns JSON
+    
+    # With YAML
+    yaml_client = ::RubyKubernetesController::Client.new(persistentvolumeclaim, bearer_token, ssl, yaml = true)
+    namespace = "default"
+    persistentvolumeclaim_name = "persistentvolumeclaim"
+    yaml_file_path = 'path/to/file.yaml'
+    
+    puts yaml_client.delete_persistentvolumeclaim(namespace, persistentvolumeclaim_name, yaml_file_path) # Returns JSON
+```
+
+[SERVICEACCOUNT]: https://github.com/IBM/ruby-kubernetes-controller/blob/master/Documentation/serviceaccount.yaml