eks_cli 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 480dc6f8255f768201d707a1a7d6dc2fcc23fbca
-  data.tar.gz: 0a14e99747c6f6f7c86de4c17693f4c750496c6e
+  metadata.gz: 78d1ac1a9a28a095b8364a99e2c6025bbdf82aab
+  data.tar.gz: cd3872bd0c7b043af27f5158a6459f5b3c168026
 SHA512:
-  metadata.gz: 09300a05da8fc3234a4233cecb6e888f415188525459f261332eaf300133241fa82909402c2daa9526766685e3f7f9780478c428359db45cdb09abdad5bd76a4
-  data.tar.gz: 50169c1923c45b6611bd6b120127d715979806c335d394ef577296c1389f7efbf02a04e47410b0afeab5c23b2d7124770b24d8b7be641334b2350bc51be86016
+  metadata.gz: 4286725d3526103ed2373364391b2f759ea2d7b0bf74768b42f8c67796b7332d211d8c9382162edd689225fad2b8d369088d1bf73ccb5cdce2f54b7ece5bb648
+  data.tar.gz: 132517e6b5e8cb935faad6da978d5f52a2ac9216b367c792862be202c2a7f12ef179daa1c9cb4c0b847b59f33afc9d659ed2f01c15de4ad0de54b311b99d7880

data/.gitignore

@@ -1 +1 @@
-eks_cli-0.1.0.gem
+*.gem

data/README.md

@@ -2,18 +2,33 @@
 
 EKS cluster bootstrap with batteries included
 
+## Highlights
+
+* Supports creation of various node groups of different types with communication between them
+* Taint and label your nodegroups
+* Manage IAM policies that will be attached to your nodes
+* Easily configure docker repository secrets to allow pulling private images
+* Manage Route53 DNS records to point at your Kubernetes services
+* Even more...
+
 ## Usage
 
 ```
 $ gem install eks_cli
-$ eks bootstrap us-west-2 --cluster-name=My-EKS-Cluster
-$ eks create-cluster-vpc --cluster-name=My-EKS-Cluster
-$ eks create-cluster-security-group --cluster-name My-EKS-Cluster --open-ports=22
+$ eks create us-west-2 --cluster-name=My-EKS-Cluster
 $ eks create-nodegroup --cluster-name My-EKS-Cluster --group-name nodes --ssh-key-name my-ssh-key --min 1 --max 3
 $ eks create-nodegroup --cluster-name My-EKS-Cluster --group-name other-nodes --ssh-key-name my-ssh-key --min 3 --max 3 --instance-type m5.2xlarge
 $ eks create-nodegroup --all --cluster-name My-EKS-Cluster --yes
 ```
 
+You can type `eks` in your shell to get the full synopsys of available commands
+
+## Prerequisite
+
+1. Ruby
+2. `kubectl` with version > 10 on your `PATH`
+3. `aws-iam-authenticator` on your `PATH`
+
 ## Extra Stuff
 
 ### Setting IAM policies to be attached to EKS nodes
@@ -41,7 +56,7 @@ Installs the nvidia device plugin required to have your GPUs exposed
 
 ### Adding Dockerhub Secrets
 
-`$ eks set-docker-registry-credentials <dockerhub-user> <dockerhub-email> <dockerhub-password> --cluster-name My-EKS-Cluster`
+`$ eks set-docker-registry-credentials <dockerhub-user> <dockerhub-password> <dockerhub-email> --cluster-name My-EKS-Cluster`
 
 Adds your dockerhub credentials as a secret and attaches it to the default serviceaccount imagePullSecrets
 
@@ -50,3 +65,18 @@ Adds your dockerhub credentials as a secret and attaches it to the default servi
 `$ eks create-default-storage-class --cluster-name My-EKS-Cluster`
 
 Creates a standard gp2 default storage class named gp2
+
+### Connecting to an existing VPC
+
+`$ eks set-inter-vpc-networking VPC_ID SG_ID`
+
+Assuming you have some resources shared on another VPC (an RDS instance for example) this command allows you to interact with from the new EKS cluster it by:
+
+1. Creating and accepting a VPC peering connection from you EKS cluster VPC to the old VPC
+2. Setting route tables on both directions to allow communication
+3. Adding an ingress role to SG_ID to accept all communication from your new cluster nodes.
+
+
+## Contributing
+
+Is more than welcome! ;)

data/eks_cli.gemspec

@@ -1,10 +1,11 @@
 # coding: utf-8
 lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'eks_cli/version'
 
 Gem::Specification.new do |s|
   s.name        = 'eks_cli'
-  s.version     = '0.1.0'
+  s.version     = EksCli::VERSION
   s.date        = '2018-11-18'
   s.summary     = "Make EKS great again!"
   s.description = "A utility to manage and create EKS (Kubernetes) cluster on Amazon Web Services"

data/lib/eks_cli/cli.rb

@@ -1,4 +1,5 @@
 require 'thor'
+require 'version'
 
 autoload :JSON, 'json'
 
@@ -34,10 +35,20 @@ module EksCli
 
     class_option :cluster_name, required: true, aliases: :c
 
-    desc "bootstrap REGION", "bootstrap cluster configuration"
-    def bootstrap(region)
+    desc "create REGION", "creates a new EKS cluster"
+    option :open_ports, type: :array, default: [], desc: "open ports on cluster nodes (eg 22 for SSH access)"
+    def create(region)
+      Config[cluster_name].bootstrap({region: region})
+      create_eks_role
+      create_cluster_vpc
+      create_eks_cluster
+      create_cluster_security_group
+    end
+
+    desc "create-eks-role", "creates an IAM role for usage by EKS"
+    def create_eks_role
       role = IAM::Client.new(cluster_name).create_eks_role
-      Config[cluster_name].bootstrap({region: region, eks_role_arn: role.arn})
+      Config[cluster_name].write({eks_role_arn: role.arn})
     end
 
     desc "show-config", "print cluster configuration"
@@ -146,6 +157,12 @@ module EksCli
       VPC::Client.new(cluster_name).set_inter_vpc_networking(to_vpc_id, to_sg_id)
     end
 
+    disable_required_check! :version
+    desc "version", "prints eks_cli version"
+    def version
+      puts EksCli::VERSION
+    end
+
     no_commands do
       def cluster_name; options[:cluster_name]; end
 

data/lib/eks_cli/version.rb

@@ -0,0 +1,3 @@
+module EksCli
+  VERSION = "0.1.1"
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eks_cli
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Erez Rabih
@@ -155,6 +155,7 @@ files:
 - lib/eks_cli/log.rb
 - lib/eks_cli/nodegroup.rb
 - lib/eks_cli/route53/client.rb
+- lib/eks_cli/version.rb
 - lib/eks_cli/vpc/client.rb
 homepage: https://github.com/nanit/eks_cli
 licenses: