kubes 0.2.3 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4f9062190dfd5888032514dc726587aeb3f55c826d1af71670c22268942ca4f
-  data.tar.gz: 9cfe8ce6833abc6c25323ceb960cbd8f63d9ba2bec698572328420607c12f8da
+  metadata.gz: d130212469e4bc5bd395cd0b12978199876a6c5b946caf80fa66a7e09608ccd5
+  data.tar.gz: b2fd2bfc17efa04772d69426e9895e3151c97c3628a573f245e7920824c9df9e
 SHA512:
-  metadata.gz: db1890f00464a7ed111dae86f8bdd084c7a947d36f8d74ba84e4e3abe6175d04cd6b6b81fe2dad59601c5553ba77a86cc8fd6ebfab9553d2a74c707562e935de
-  data.tar.gz: a02cd12c91fc241b281182a6773f2e58c8d12246881757374e3d07994541b9d0e83a0edd74e7d069e640b0f1a756bcba9d30088f62d75f84a3949dbf11974d5f
+  metadata.gz: cd1c1f453efdc400a6056443fe95a92bf1e0443cea14df03373a650f4c538a3d152e0c1b49195801a99a578df7eb0aa5092b6e612078775cb7a2086daca0937f
+  data.tar.gz: 95c492b92ce1890e011c9d93ebc46b8a9248eaa372b9545721f5c0d64ac72b96f20c07705ad0f667b6b7e84a2440af662d9b26b0a12186a83c218c62315c01a7

data/.dockerignore

@@ -0,0 +1,4 @@
+.git
+pkg
+docs
+spec

data/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 This project *loosely tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
 
+## [0.3.1]
+- #20 improve sidecar support. kubes exec -c option also
+
+## [0.3.0]
+- #19 new commands: exec, logs
+- delete preview
+- show pods as part of get
+
+## [0.2.6]
+- #18 gcloud builder. change to config.builder
+
+## [0.2.5]
+- #17 cloudbuild build strategy
+
+## [0.2.4]
+- #16 google cloudbuild support & docs: add Dockerfile for kubes as a docker entrypoint
+
 ## [0.2.3]
 - #15 use kubernetes default deployment strategy instead
 

data/Dockerfile

@@ -0,0 +1,14 @@
+FROM ruby:2.7-alpine
+
+RUN apk add --no-cache docker
+RUN apk add --no-cache build-base ruby ruby-dev
+
+RUN wget https://storage.googleapis.com/kubernetes-release/release/v1.18.6/bin/linux/amd64/kubectl
+RUN chmod u+x kubectl && mv kubectl /bin/kubectl
+
+WORKDIR /app
+ADD . /app
+RUN bundle install
+RUN rake install
+
+ENTRYPOINT ["/usr/local/bundle/bin/kubes"]

data/docs/_docs/auto-context.md

@@ -22,7 +22,7 @@ You can override configs on a per-env basis with `config/env` files. Examples:
 ```ruby
 Kubes.configure do |config|
   config.repo = "222222222222.dkr.ecr.us-west-2.amazonaws.com/demo"
-  config.kubectl.context = "dev-services"
+  config.kubectl.context = "dev-cluster"
 end
 ```
 
@@ -31,7 +31,7 @@ end
 ```ruby
 Kubes.configure do |config|
   config.repo = "333333333333.dkr.ecr.us-west-2.amazonaws.com/demo"
-  config.kubectl.context = "prod-services"
+  config.kubectl.context = "prod-cluster"
 end
 ```
 
@@ -39,8 +39,8 @@ end
 
 With this setup, when you deploy with kubes, it will automatically switch the kubectl context based on `KUBES_ENV`.  Example:
 
-    KUBES_ENV=dev  kubes deploy # to dev-services context
-    KUBES_ENV=prod kubes deploy # to prod-services context
+    KUBES_ENV=dev  kubes deploy # to dev-cluster context
+    KUBES_ENV=prod kubes deploy # to prod-cluster context
 
 ## context_keep Option
 

data/docs/_docs/ci/cloudbuild.md

@@ -0,0 +1,69 @@
+---
+title: CloudBuild
+---
+
+To build kubes as a Docker image entrypoint for [Google CloudBuild Custom Builder](https://cloud.google.com/cloud-build/docs/configuring-builds/use-community-and-custom-builders).
+
+    git clone http://github.com/boltops-tools/kubes
+    cd kubes
+    gcloud builds submit --tag gcr.io/$GOOGLE_PROJECT/kubes
+
+Be sure to set GOOGLE_PROJECT to your own project id.
+
+## Example Codebuild YAML
+
+cloudbuild.yaml:
+
+```yaml
+steps:
+# Simply calling kubectl version with the CLOUDSDK_* vars will auth to the GKE cluster. Unsure why.
+- name: gcr.io/cloud-builders/kubectl
+  args: ['version']
+  env:
+  - 'CLOUDSDK_COMPUTE_REGION=$_GCP_REGION'
+  - 'CLOUDSDK_CONTAINER_CLUSTER=$_GKE_CLUSTER'
+- name: 'gcr.io/$PROJECT_ID/kubes'
+  args: ["deploy"]
+  env:
+  - 'GOOGLE_PROJECT=$PROJECT_ID' # .kubes/config.rb: config.repo
+  - 'KUBES_ENV=$_KUBES_ENV'
+  - 'KUBES_EXTRA=$_KUBES_EXTRA'
+
+substitutions:
+  _GCP_REGION: us-central1
+  _GKE_CLUSTER: dev-cluster
+  _KUBES_ENV: dev
+  _KUBES_EXTRA: ''
+options:
+    substitution_option: 'ALLOW_LOOSE'
+```
+
+## Run CloudBuild
+
+Run cloudbuild with:
+
+    gcloud builds submit --config cloudbuild.yaml
+
+Example with output:
+
+    $ gcloud builds submit --config cloudbuild.yaml
+    Starting Step #1
+    Step #1: => docker build -t gcr.io/tung-275700/demo:kubes-2020-07-25T21-13-59 -f Dockerfile .
+    Step #1: Pushed gcr.io/tung-275700/demo:kubes-2020-07-25T21-13-59 docker image.
+    Step #1: Docker push took 2s.
+    Step #1: Compiled  .kubes/resources files to .kubes/output
+    Step #1: Deploying kubes resources
+    Step #1: => kubectl apply -f .kubes/output/shared/namespace.yaml
+    Step #1: namespace/demo unchanged
+    Step #1: => kubectl apply -f .kubes/output/web/service.yaml
+    Step #1: service/web unchanged
+    Step #1: => kubectl apply -f .kubes/output/web/deployment.yaml
+    Step #1: deployment.apps/web configured
+    $
+
+## Create Extra Environments
+
+If you are using the [with_extra helper]({% link _docs/extra-env.md %}), you can create additional environments of the same app like so:
+
+    gcloud builds submit --config cloudbuild.yaml --substitutions=_KUBES_EXTRA=2
+    gcloud builds submit --config cloudbuild.yaml --substitutions=_KUBES_EXTRA=3

data/docs/_docs/config/builder.md

@@ -0,0 +1,46 @@
+---
+title: Builder Strategy
+---
+
+Kubes uses the `docker` command to build the docker image by default. Kubes can also support an additional builder: gcloud.
+
+## Gcloud Builder
+
+With the gcloud builder, you do not need docker installed locally. Google CloudBuild is used to build and push the image to a GCR registry.
+
+You must set up the [gcloud cli](https://cloud.google.com/sdk/gcloud/reference/builds/submit).  Please refer to the [gcloud sdk install docs](https://cloud.google.com/sdk/install). Kubes will call out to `gcloud builds submit` to create the Docker image.
+
+## Configure
+
+You configure gcloud as the builder like so:
+
+```ruby
+Kubes.configure do |config|
+  config.repo = "gcr.io/#{ENV['GOOGLE_PROJECT']}/demo"
+  config.logger.level = "info"
+  config.builder = "gcloud" # <= changed to gcloud
+end
+```
+
+## Commands
+
+The kubes builds command will remain the same.
+
+    kubes docker build
+
+There is no need to run the push command, as the build command with the gcloud builder will always push.
+
+## Deploy
+
+The deploy commands remain the same. Example:
+
+    kubes deploy web
+
+If you want to skip the `docker build` phase of the deploy, you can run:
+
+    kubes deploy web --no-build
+
+Also, kubes apply another way to skip the docker build:
+
+    kubes apply web
+

data/docs/_docs/config/env.md

@@ -11,7 +11,7 @@ Kubes.configure do |config|
   config.repo = "111111111111.dkr.ecr.us-west-2.amazonaws.com/demo"
   config.logger.level = "info"
   # auto-switching
-  # config.kubectl.context = "dev-services"
+  # config.kubectl.context = "dev-cluster"
   # config.kubectl.context_keep = false
 end
 ```
@@ -25,7 +25,7 @@ You can override configs on a per-env basis with `config/env` files. Examples:
 ```ruby
 Kubes.configure do |config|
   config.repo = "222222222222.dkr.ecr.us-west-2.amazonaws.com/demo"
-  config.kubectl.context = "dev-services"
+  config.kubectl.context = "dev-cluster"
 end
 ```
 
@@ -34,7 +34,7 @@ end
 ```ruby
 Kubes.configure do |config|
   config.repo = "333333333333.dkr.ecr.us-west-2.amazonaws.com/demo"
-  config.kubectl.context = "prod-services"
+  config.kubectl.context = "prod-cluster"
 end
 ```
 

data/docs/_docs/dsl/resources/service.md

@@ -46,15 +46,31 @@ spec:
 
 ## DSL Methods
 
-Here's a list of more common methods:
+Here's a list of some of the methods:
+
+kubectl explain service.spec
+
+* clusterIP
+* externalIPs
+* externalName
+* externalTrafficPolicy
+* healthCheckNodePort
+* ipFamily
+* loadBalancerIP
+* loadBalancerSourceRanges
+* ports
+* publishNotReadyAddresses
+* selector
+* sessionAffinity
+* sessionAffinityConfig
+* type
+
+kubectl explain service.spec.ports
 
 * nodePort
 * port
-* portName: Note this field doesn't match the original field name. It's more qualified.
-* ports
+* portName: : Note this field doesn't match the original field name. It's more qualified.
 * protocol
-* selector
 * targetPort
-* type
 
 {% include dsl/methods.md name="service" %}

data/docs/_docs/learn/dsl/deploy.md

@@ -22,6 +22,8 @@ You'll see output like this:
     deployment.apps/demo-web created
     $
 
+Note: Showing an AWS ECR repo, but it may be different if you're using another repo like Google GCR.
+
 What did Kubes do?
 
 {% include kubes-steps.md %}

data/docs/_docs/learn/dsl/new-project.md

@@ -7,11 +7,10 @@ If you already a project with an existing Dockerfile, you can use that. If you d
     mkdir demo
     cd demo
 
-For this tutorial, we'll use an ECR repo, though any repo will work.
+{% include learn/repos.md %}
 
 Let's generate a starter project:
 
-    $ REPO=$(aws ecr describe-repositories --repository-name demo | jq -r '.repositories[].repositoryUri')
     $ kubes init --app demo --repo $REPO --type dsl
           create  .kubes/config.rb
           create  .kubes/config/env/dev.rb

data/docs/_docs/learn/yaml/deploy.md

@@ -22,6 +22,8 @@ You'll see output like this:
     deployment.apps/demo-web created
     $
 
+Note: Showing an AWS ECR repo, but it may be different if you're using another repo like Google GCR.
+
 What did Kubes do?
 
 {% include kubes-steps.md %}

data/docs/_docs/learn/yaml/new-project.md

@@ -7,7 +7,7 @@ If you already a project with an existing Dockerfile, you can use that. If you d
     mkdir demo
     cd demo
 
-For this tutorial, we'll use an ECR repo, though any repo will work.
+{% include learn/repos.md %}
 
 Let's generate a starter project:
 

data/docs/_includes/intro/install.md

@@ -4,7 +4,7 @@ Install kubes via RubyGems.
 
     gem install kubes
 
-Ruby 2.7 and patch variants of it is recommended.
+Ruby 2.7 and above is recommended.
 
 ## kubectl
 
@@ -13,3 +13,7 @@ Kubes calls kubectl. Kubes has been tested with kubectl v1.15+. Generally, it sh
 ## docker
 
 Kubes calls docker. Kubes has been tested with docker 18.x-ce+. Generally, it should work with most versions of docker.
+
+## gcloud
+
+If you are using the [gcloud builder](% link _docs/config/builder.md %), set up and configure the [gcloud cli](https://cloud.google.com/sdk/install).

data/docs/_includes/learn/cluster.md

@@ -1,12 +1,12 @@
-You'll need a Kubernetes cluster and a Docker repo to be able to push to. Setting up a Kubernetes cluster is a little bit out scope for this tutorial. We'll provide the docs and links though. We'll also use an AWS EKS cluster and ECR.
+You'll need a Kubernetes cluster and a Docker repo to be able to push to. Setting up a Kubernetes cluster is a little bit out scope for this tutorial. We'll provide the docs and links though. We'll provide instructions for AWS and Google.
 
-## Create an EKS cluster
+## AWS: Create an EKS cluster
 
 Here are the AWS docs to create an EKS cluster:
 
 * [Creating an Amazon EKS cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html)
 
-## Create an ECR Repo
+## AWS: Create an ECR Repo
 
 Here are the AWS docs to create a repo:
 
@@ -19,4 +19,21 @@ Here are also the commands to create an ECR repo:
 
 We'll be using the `$REPO` variable for the rest of the tutorial.
 
-Note: Though we're using AWS here, Kubes works with any Cloud Provider. Please adjust your commands and the `$REPO` variable for your cloud provider.
+## Google: Create GKE Cluster
+
+Here are the Google docs to create an GKE cluster:
+
+* [Creating an Google GKE cluster](https://cloud.google.com/kubernetes-engine/docs/how-to/creating-a-regional-cluster)
+
+## Google: GCR Repo
+
+For google, you do not have to create a repo. You simply push to the right repo url.  Example:
+
+    export GOOGLE_PROJECT=project-123
+    REPO=gcr.io/$GOOGLE_PROJECT/demo
+
+## Repo Variable
+
+We'll be using the `$REPO` variable for the rest of the tutorial.
+
+Note: Though we're using AWS and Google here, Kubes works with any Cloud Provider. Please adjust your commands and the `$REPO` variable for your cloud provider.

data/docs/_includes/learn/repos.md

@@ -0,0 +1,10 @@
+For this tutorial, here are examples of AWS ECR and Google GCR repos, though any repo will work.
+
+AWS:
+
+    REPO=$(aws ecr describe-repositories --repository-name demo | jq -r '.repositories[].repositoryUri')
+
+Google:
+
+    export GOOGLE_PROJECT=project-123
+    REPO=gcr.io/$GOOGLE_PROJECT/demo

data/docs/_includes/learn/review.md

@@ -4,10 +4,10 @@ The `config.rb` is where you can configure Kubes settings.
 
 ```ruby
 Kubes.configure do |config|
-  config.repo = "112233445566.dkr.ecr.us-west-2.amazonaws.com/demo"
+  config.repo = "112233445566.dkr.ecr.us-west-2.amazonaws.com/demo" # may be gcr.io/project-123/demo
   config.logger.level = "info"
   # auto-switching
-  # config.kubectl.context = "dev-services"
+  # config.kubectl.context = "dev-cluster"
 end
 ```
 

data/docs/_includes/sidebar.html

@@ -56,6 +56,7 @@
           <li><a href="{% link _docs/config/docker.md %}">Docker</a></li>
           <li><a href="{% link _docs/config/env.md %}">Env</a></li>
           <li><a href="{% link _docs/config/kubectl.md %}">Kubectl</a></li>
+          <li><a href="{% link _docs/config/builder.md %}">Builder</a></li>
         </ul>
       </li>
       <li><a href="{% link _docs/yaml.md %}">YAML</a></li>
@@ -93,6 +94,11 @@
       </li>
       <li><a href="{% link _docs/kustomize.md %}">Kustomize Support</a></li>
       <li><a href="{% link _docs/auto-context.md %}">Auto Context</a></li>
+      <li>CI/CD
+        <ul>
+          <li><a href="{% link _docs/ci/cloudbuild.md %}">CloudBuild</a></li>
+        </ul>
+      </li>
       <li>More
         <ul class="more">
           <li><a href="{% link support.md %}">Support</a></li>

data/docs/_reference/kubes-apply.md

@@ -5,11 +5,11 @@ reference: true
 
 ## Usage
 
-    kubes apply [APP] [RESOURCE]
+    kubes apply [ROLE] [RESOURCE]
 
 ## Description
 
-Apply the Kubernetes YAML files without changing them
+Apply the Kubernetes YAML files without building docker image
 
 
 ## Options

data/docs/_reference/kubes-delete.md

@@ -5,7 +5,7 @@ reference: true
 
 ## Usage
 
-    kubes delete [APP] [RESOURCE]
+    kubes delete [ROLE] [RESOURCE]
 
 ## Description
 

data/docs/_reference/kubes-deploy.md

@@ -5,7 +5,7 @@ reference: true
 
 ## Usage
 
-    kubes deploy [APP] [RESOURCE]
+    kubes deploy [ROLE] [RESOURCE]
 
 ## Description