droplet_kit 2.6.1 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 86f7ab1bde3cbd736afb675cef233f4d24775c32
-  data.tar.gz: 8d525afec4d2bf96b3e77cafa35dd475584210f6
+  metadata.gz: cc932d61ca690fb4a81e55d15b6f8c733ffa1599
+  data.tar.gz: 0451b7c0f8fb34965cb6bb4450b8794f0cd5591c
 SHA512:
-  metadata.gz: 9d8b775dea7c1d4f2972e22a4c27d00d697f1f028fe27b9caf232ea3643bd21f545591cc736893730f2cccc0294b563d13a1a003e61396266d4150acd4b34e16
-  data.tar.gz: fed45dc62fe67d39777503472e32345bcb9ac0d886792782fe4ab914cf5f7197d349dcb1ce23c827160531d7a65d7620fa691470abf44aa5a1203dad417a93da
+  metadata.gz: 98cbeaaaa47c810447898415d480e3d5a6ba0bb3f0bad57da13192411dd109c0ae569760a92771f8f738bdac758eedd66ee9ce18b21b49cb0c2b7f2409407094
+  data.tar.gz: 71a7bf51defafd88379603eb7f6525be77ef7b20c00d13bc9b6ea4050545f535f22cae2b3fd58de9df68cdd7a86ad4f45ca3a038fc1ceca04c478b5ab2216ad6

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+### Version 2.7.0
+* Added KubernetesCluster resource
+* Added KubernetesOptions resource
+* Added kubernetes cluster and node pool functionality
+
 ### Version 2.6.1
 * Added custom User-Agent for DropletKit
 

data/README.md

@@ -288,6 +288,40 @@ Image Actions Supported:
 * `client.image_actions.transfer(image_id: 123, region: 'nyc3')`
 
 
+## Kubernetes Resource
+
+```
+client = DropletKit::Client.new(access_token: 'TOKEN')
+client.kubernetes_clusters #=> DropletKit::KubernetesClusterResource
+```
+
+Actions supported
+
+When the arguments below refer to cluster, they refer to:
+```
+cluster = DropletKit::KubernetesCluster.new(name: "foo", region: "nyc1", ...) # cluster attributes
+```
+
+When the arguments below refer to node_pool, they refer to:
+```
+node_pool = DropletKit::KubernetesNodePool.new(name: 'frontend', size: 's-1vcpu-1gb', count: 3, ...) # Node Pool attributes
+```
+
+* `client.kubernetes_clusters.all()`
+* `client.kubernetes_clusters.find(id: 'cluster_id')`
+* `client.kubernetes_clusters.create(cluster, id: 'cluster_id')`
+* `client.kubernetes_clusters.kubeconfig(id: 'cluster_id')`
+* `client.kubernetes_clusters.update(cluster, id: 'cluster_id')`
+* `client.kubernetes_clusters.delete(id: 'cluster_id')`
+* `client.kubernetes_clusters.node_pools(id: 'cluster_id')`
+* `client.kubernetes_clusters.find_node_pool(id: 'cluster_id', pool_id: 'node_pool_id')`
+* `client.kubernetes_clusters.create_node_pool(node_pool, id: 'cluster_id')`
+* `client.kubernetes_clusters.update_node_pool(node_pool, id: 'cluster_id', pool_id: 'node_pool_id')`
+* `client.kubernetes_clusters.delete_node_pool(id: 'cluster_id', pool_id: 'node_pool_id')`
+* `client.kubernetes_clusters.recycle_node_pool([node_id, node_id, ...], id: 'cluster_id', pool_id: 'node_pool_id')`
+* `client.kubernetes_options.all()`
+
+
 ## Load balancer resource
 ```ruby
 client = DropletKit::Client.new(access_token: 'TOKEN')

data/lib/droplet_kit.rb

@@ -43,6 +43,10 @@ module DropletKit
   autoload :FirewallOutboundRule, 'droplet_kit/models/firewall_outbound_rule'
   autoload :FirewallPendingChange, 'droplet_kit/models/firewall_pending_change'
   autoload :CDN, 'droplet_kit/models/cdn'
+  autoload :KubernetesCluster, 'droplet_kit/models/kubernetes_cluster'
+  autoload :KubernetesNodePool, 'droplet_kit/models/kubernetes_node_pool'
+  autoload :KubernetesNode, 'droplet_kit/models/kubernetes_node'
+  autoload :KubernetesOptions, 'droplet_kit/models/kubernetes_options'
 
   # Resources
   autoload :DropletResource, 'droplet_kit/resources/droplet_resource'
@@ -68,6 +72,8 @@ module DropletKit
   autoload :CertificateResource, 'droplet_kit/resources/certificate_resource'
   autoload :FirewallResource, 'droplet_kit/resources/firewall_resource'
   autoload :CDNResource, 'droplet_kit/resources/cdn_resource'
+  autoload :KubernetesClusterResource, 'droplet_kit/resources/kubernetes_cluster_resource'
+  autoload :KubernetesOptionsResource, 'droplet_kit/resources/kubernetes_options_resource'
 
   # JSON Maps
   autoload :DropletMapping, 'droplet_kit/mappings/droplet_mapping'
@@ -106,6 +112,10 @@ module DropletKit
   autoload :FirewallOutboundRuleMapping, 'droplet_kit/mappings/firewall_outbound_rule_mapping'
   autoload :FirewallPendingChangeMapping, 'droplet_kit/mappings/firewall_pending_change_mapping'
   autoload :CDNMapping, 'droplet_kit/mappings/cdn_mapping'
+  autoload :KubernetesClusterMapping, 'droplet_kit/mappings/kubernetes_cluster_mapping'
+  autoload :KubernetesNodePoolMapping, 'droplet_kit/mappings/kubernetes_node_pool_mapping'
+  autoload :KubernetesNodeMapping, 'droplet_kit/mappings/kubernetes_node_mapping'
+  autoload :KubernetesOptionsMapping, 'droplet_kit/mappings/kubernetes_options_mapping'
 
   # Utils
   autoload :PaginatedResource, 'droplet_kit/paginated_resource'

data/lib/droplet_kit/client.rb

@@ -23,6 +23,8 @@ module DropletKit
         cdns: CDNResource,
         certificates: CertificateResource,
         droplets: DropletResource,
+        kubernetes_clusters: KubernetesClusterResource,
+        kubernetes_options: KubernetesOptionsResource,
         domains: DomainResource,
         domain_records: DomainRecordResource,
         droplet_actions: DropletActionResource,

data/lib/droplet_kit/mappings/kubernetes_cluster_mapping.rb

@@ -0,0 +1,20 @@
+module DropletKit
+  class KubernetesClusterMapping
+    include Kartograph::DSL
+    kartograph do
+      mapping KubernetesCluster
+      root_key plural: 'kubernetes_clusters', singular: 'kubernetes_cluster', scopes: [:read]
+
+      property :id, scopes: [:read]
+      property :name, scopes: [:read, :update, :create]
+      property :region, scopes: [:read, :create]
+      property :version, scopes: [:read, :create]
+      property :cluster_subnet, scopes: [:read]
+      property :service_subnet, scopes: [:read]
+      property :ipv4, scopes: [:read]
+      property :endpoint, scopes: [:read]
+      property :tags, scopes: [:read, :update, :create]
+      property :node_pools, scopes: [:read, :create]
+    end
+  end
+end

data/lib/droplet_kit/mappings/kubernetes_node_mapping.rb

@@ -0,0 +1,15 @@
+module DropletKit
+  class KubernetesNodeMapping
+    include Kartograph::DSL
+    kartograph do
+      mapping KubernetesNode
+
+      property :id, scopes: [:read]
+      property :name, scopes: [:read]
+      property :status, scopes: [:read]
+      property :created_at, scopes: [:read]
+      property :updated_at, scopes: [:read]
+    end
+  end
+end
+

data/lib/droplet_kit/mappings/kubernetes_node_pool_mapping.rb

@@ -0,0 +1,27 @@
+module DropletKit
+  class KubernetesNodePoolMapping
+    include Kartograph::DSL
+    kartograph do
+      mapping KubernetesNodePool
+      root_key plural: 'node_pools', singular: 'node_pool', scopes: [:read]
+
+      property :id, scopes: [:read]
+      property :name, scopes: [:read]
+      property :size, scopes: [:read]
+      property :count, scopes: [:read]
+      property :tags, scopes: [:read]
+
+      property :nodes, plural: true, scopes: [:read], include: KubernetesNodeMapping
+
+      # Create properties
+      property :name, scopes: [:create, :update]
+      property :size, scopes: [:create, :update]
+      property :count, scopes: [:create, :update]
+      property :tags, scopes: [:create, :update]
+
+      # recycle
+      property :nodes, plural: true, scopes: [:recycle]
+    end
+  end
+end
+

data/lib/droplet_kit/mappings/kubernetes_options_mapping.rb

@@ -0,0 +1,30 @@
+module DropletKit
+  class KubernetesOptionsMapping
+    include Kartograph::DSL
+    kartograph do
+      mapping KubernetesOptions
+      root_key singular: 'options', scopes: [:read]
+
+      Version = Struct.new(:slug, :kubernetes_version)
+      property :versions, plural: true, scopes: [:read] do
+        mapping Version
+        property :slug, scopes: [:read]
+        property :kubernetes_version, scopes: [:read]
+      end
+
+      Region = Struct.new(:name, :slug)
+      property :regions, plural: true, scopes: [:read] do
+        mapping Region
+        property :name, scopes: [:read]
+        property :slug, scopes: [:read]
+      end
+
+      Size = Struct.new(:name, :slug)
+      property :sizes, plural: true, scopes: [:read] do
+        mapping Size
+        property :name, scopes: [:read]
+        property :slug, scopes: [:read]
+      end
+    end
+  end
+end

data/lib/droplet_kit/models/kubernetes_cluster.rb

@@ -0,0 +1,7 @@
+module DropletKit
+  class KubernetesCluster < BaseModel
+    [:id, :name, :region, :version, :cluster_subnet, :service_subnet, :ipv4, :endpoint, :tags, :node_pools].each do |key|
+      attribute(key)
+    end
+  end
+end

data/lib/droplet_kit/models/kubernetes_node.rb

@@ -0,0 +1,7 @@
+module DropletKit
+  class KubernetesNode < BaseModel
+    [:id, :name, :status, :created_at, :updated_at].each do |key|
+      attribute(key)
+    end
+  end
+end

data/lib/droplet_kit/models/kubernetes_node_pool.rb

@@ -0,0 +1,7 @@
+module DropletKit
+  class KubernetesNodePool < BaseModel
+    [:id, :name, :size, :count, :tags, :nodes].each do |key|
+      attribute(key)
+    end
+  end
+end

data/lib/droplet_kit/models/kubernetes_options.rb

@@ -0,0 +1,7 @@
+module DropletKit
+  class KubernetesOptions < BaseModel
+    attribute :versions
+    attribute :regions
+    attribute :sizes
+  end
+end

data/lib/droplet_kit/resources/kubernetes_cluster_resource.rb

@@ -0,0 +1,70 @@
+module DropletKit
+  class KubernetesClusterResource < ResourceKit::Resource
+    include ErrorHandlingResourcable
+
+    resources do
+      action :all, 'GET /v2/kubernetes/clusters' do
+        query_keys :per_page, :page, :tag_name
+        handler(200) { |response| KubernetesClusterMapping.extract_collection(response.body, :read) }
+      end
+
+      action :find, 'GET /v2/kubernetes/clusters/:id' do
+        handler(200) { |response| KubernetesClusterMapping.extract_single(response.body, :read) }
+      end
+
+      action :create, 'POST /v2/kubernetes/clusters' do
+        body { |object| KubernetesClusterMapping.representation_for(:create, object) }
+        handler(201) { |response, cluster| KubernetesClusterMapping.extract_into_object(cluster, response.body, :read) }
+        handler(422) { |response| ErrorMapping.fail_with(FailedCreate, response.body) }
+      end
+
+      action :kubeconfig, 'GET /v2/kubernetes/clusters/:id/kubeconfig' do
+        handler(200) { |response| response.body }
+      end
+
+      action :update, 'PUT /v2/kubernetes/clusters/:id' do
+        body { |cluster| KubernetesClusterMapping.representation_for(:update, cluster) }
+        handler(202) { |response| KubernetesClusterMapping.extract_single(response.body, :read) }
+        handler(422) { |response| ErrorMapping.fail_with(FailedUpdate, response.body) }
+      end
+
+      action :delete, 'DELETE /v2/kubernetes/clusters/:id' do
+        handler(202) { |response| true }
+      end
+
+      action :node_pools, 'GET /v2/kubernetes/clusters/:id/node_pools' do
+        handler(200) { |response| KubernetesNodePoolMapping.extract_collection(response.body, :read) }
+      end
+
+      action :find_node_pool, 'GET /v2/kubernetes/clusters/:id/node_pools/:pool_id' do
+        handler(200) { |response| KubernetesNodePoolMapping.extract_single(response.body, :read) }
+      end
+
+      action :create_node_pool, 'POST /v2/kubernetes/clusters/:id/node_pools' do
+        body { |node_pool| KubernetesNodePoolMapping.representation_for(:create, node_pool) }
+        handler(201) { |response| KubernetesNodePoolMapping.extract_single(response.body, :read) }
+        handler(422) { |response| ErrorMapping.fail_with(FailedCreate, response.body) }
+      end
+
+      action :update_node_pool, 'PUT /v2/kubernetes/clusters/:id/node_pools/:pool_id' do
+        body { |node_pool| KubernetesNodePoolMapping.representation_for(:update, node_pool) }
+        handler(202) { |response| KubernetesNodePoolMapping.extract_single(response.body, :read) }
+        handler(404) { |response| ErrorMapping.fail_with(FailedUpdate, response.body) }
+      end
+
+      action :delete_node_pool, 'DELETE /v2/kubernetes/clusters/:id/node_pools/:pool_id' do
+        handler(202) { |response| true }
+      end
+
+      action :recycle_node_pool, 'POST /v2/kubernetes/clusters/:id/node_pools/:pool_id/recycle' do
+        body { |node_ids| { nodes: node_ids }.to_json }
+        handler(202) { |response| true }
+        handler(404) { |response| ErrorMapping.fail_with(FailedUpdate, response.body) }
+      end
+    end
+
+    def all(*args)
+      PaginatedResource.new(action(:all), self, *args)
+    end
+  end
+end

data/lib/droplet_kit/resources/kubernetes_options_resource.rb

@@ -0,0 +1,10 @@
+module DropletKit
+  class KubernetesOptionsResource < ResourceKit::Resource
+    include ErrorHandlingResourcable
+    resources do
+      action :all, 'GET /v2/kubernetes/options' do
+        handler(200) { |response| KubernetesOptionsMapping.extract_single(response.body, :read) }
+      end
+    end
+  end
+end

data/lib/droplet_kit/version.rb

@@ -1,3 +1,3 @@
 module DropletKit
-  VERSION = "2.6.1"
+  VERSION = "2.7.0"
 end

data/spec/fixtures/kubernetes/all.json

@@ -0,0 +1,70 @@
+{
+  "kubernetes_clusters": [
+    {
+      "id": "cluster-1-id",
+      "name": "test-cluster",
+      "region": "nyc1",
+      "version": "1.12.1-do.2",
+      "cluster_subnet": "10.244.0.0/16",
+      "service_subnet": "",
+      "ipv4": "0.0.0.0",
+      "endpoint": "",
+      "tags": [
+        "test-k8",
+        "k8s",
+        "k8s:cluster-1-id"
+      ],
+      "node_pools": [
+        {
+          "id": "node-pool-id",
+          "name": "node-pool-1",
+          "size": "s-1vcpu-1gb",
+          "count": 3,
+          "tags": [
+            "k8s",
+            "k8s:node-pool-id",
+            "k8s:worker",
+            "test-k8"
+          ],
+          "nodes": [
+            {
+              "id": "node-1-id",
+              "name": "node-1",
+              "status": {
+                "state": "running"
+              },
+              "created_at": "2018-11-16T20:41:44Z",
+              "updated_at": "2018-11-16T20:44:27Z"
+            },
+            {
+              "id": "node-2-id",
+              "name": "node-2",
+              "status": {
+                "state": "running"
+              },
+              "created_at": "2018-11-16T20:41:44Z",
+              "updated_at": "2018-11-16T20:44:27Z"
+            },
+            {
+              "id": "node-3-id",
+              "name": "node-3",
+              "status": {
+                "state": "running"
+              },
+              "created_at": "2018-11-16T20:41:44Z",
+              "updated_at": "2018-11-16T20:44:27Z"
+            }
+          ]
+        }
+      ],
+      "status": {
+        "state": "running"
+      },
+      "created_at": "2018-11-16T20:41:43Z",
+      "updated_at": "2018-11-16T20:44:27Z"
+    }
+  ],
+  "meta": {
+    "total": 1
+  }
+}

data/spec/fixtures/kubernetes/all_empty.json

@@ -0,0 +1,7 @@
+{
+  "kubernetes_clusters": [
+  ],
+  "meta": {
+    "total": 0
+  }
+}

data/spec/fixtures/kubernetes/cluster_node_pool.json

@@ -0,0 +1,24 @@
+{
+  "node_pool": {
+    "id": "f9f16e5a-83b8-4c9b-acf1-4f91492a6652",
+    "name": "k8s-1-12-1-do-2-nyc1-1542638764614-1",
+    "size": "s-1vcpu-1gb",
+    "count": 1,
+    "tags": [
+      "k8s",
+      "k8s:c28bf806-eba8-4a6d-a98f-8fd388740bd0",
+      "k8s:worker"
+    ],
+    "nodes": [
+      {
+        "id": "1607ad61-2d9b-4366-9cb4-5ab6483a7e09",
+        "name": "blissful-antonelli-3u87",
+        "status": {
+          "state": "running"
+        },
+        "created_at": "2018-11-19T14:46:38Z",
+        "updated_at": "2018-11-19T14:56:42Z"
+      }
+    ]
+  }
+}

data/spec/fixtures/kubernetes/cluster_node_pool_create.json

@@ -0,0 +1,40 @@
+{
+  "node_pool": {
+    "id": "5abb80b7-de9e-4e47-bf2d-9318e64ef390",
+    "name": "frontend",
+    "size": "s-1vcpu-1gb",
+    "count": 3,
+    "tags": [
+      "k8-tag"
+    ],
+    "nodes": [
+      {
+        "id": "6f981ff5-560e-4375-a46d-03336d18b4d2",
+        "name": "",
+        "status": {
+          "state": "provisioning"
+        },
+        "created_at": "2018-11-19T17:34:37Z",
+        "updated_at": "2018-11-19T17:34:37Z"
+      },
+      {
+        "id": "af4a3da4-b4c5-490c-a481-0b780d67842a",
+        "name": "",
+        "status": {
+          "state": "provisioning"
+        },
+        "created_at": "2018-11-19T17:34:37Z",
+        "updated_at": "2018-11-19T17:34:37Z"
+      },
+      {
+        "id": "e58e0d0b-52e5-4f3a-8d7d-c7efd34b5f8a",
+        "name": "",
+        "status": {
+          "state": "provisioning"
+        },
+        "created_at": "2018-11-19T17:34:37Z",
+        "updated_at": "2018-11-19T17:34:37Z"
+      }
+    ]
+  }
+}