kubes 0.8.1 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 484309e2efc4a2e2aa6b1491320b896b013bd1d963b795e15efe08a0f550337b
-  data.tar.gz: cbfab84cc9adca44c14ad5ed3ee1d92417a0a5615981bcaba6a81219a13c6938
+  metadata.gz: f66db42d33089c27d90ea7daa749ae0e2b8298a06d5bd5a554c7bc2936a6734f
+  data.tar.gz: bde5c65bfb606523754dd653c1067a2ed99ccf94c7c88ce496df2409d5581fd6
 SHA512:
-  metadata.gz: 6e0d546a1ef39c9da45dca25883e2ea903f205abd49ca982813e13ffb9e4147d7af450ff5c82812e275c1a758d673df71ed3992858eb3da0a24b7bec4918d466
-  data.tar.gz: 72ffc9257d4924485968d7006b87f08edb66d02b4b8f358992651a9abda6ce94ffe22a57f6fdc40d84f1c4a43e1cbdf04b326fc9d1221a11a04af56d2be0e527
+  metadata.gz: 940b22e57b741854513e1cee3367648189267ee34d1bd9ad4e0e07687ccc8d9d49f25b24977e43209e31af3967f7a7d47f251f5a0812b52d02f2a2cc64ad03c4
+  data.tar.gz: 89a6be8317b8e1a0aa49158f54376504d7f914ae4f8d2fd22845df23d1fb7cee1574d1ac6ef9416d14d3a793908b1d30ed8b624300cf6722512f8d46987f3b58

data/CHANGELOG.md

@@ -3,6 +3,9 @@
 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.8.2] - 2022-02-07
+- improve gem dependency version specifiers
+
 ## [0.8.1] - 2022-02-06
 - allow --version command to run outside project
 

data/docs/_docs/install/gem/custom-version.md

@@ -0,0 +1,70 @@
+---
+title: How to Use Custom Version of Kubes
+nav_text: Custom Version
+category: gem
+order: 1
+---
+
+If you want or need to run a forked version of kubes, here's how:
+
+## Change Version Number
+
+First, clone down the source and change version number so you can identify that it's a custom version.  Clone down the project:
+
+    $ git clone https://github.com/boltops-tools/kubes
+
+Update [lib/kubes/version.rb](https://github.com/boltops-tools/kubes/blob/master/lib/kubes/version.rb) so you'll be able to tell that it's a custom build.  For example:
+
+```ruby
+module kubes
+  VERSION = "0.8.2.custom"
+end
+```
+
+There are 2 ways to use the custom version:
+
+1. Gemfile: Forked Git Source
+2. Gem Package: Build and Install
+
+## Gemfile: Forked Git Source
+
+Point `kubes ` to use your repo with the forked version.  Example:
+
+Gemfile:
+
+```ruby
+source "https://rubygems.org"
+gem 'kubes', git: 'https://github.com/REPO/kubes', branch: "master"
+```
+
+Remember to change `REPO`, to your repo name.
+
+Then run:
+
+    bundle
+
+## Gem Package: Build and Install
+
+Build the gem package:
+
+    $ bundle
+    $ rake build
+    pkg/kubes-0.8.2.custom.gem
+
+The produced `.gem` file can used to install the gem. You can install it locally:
+
+    $ gem install pkg/kubes-0.8.2.custom.gem
+    $ kubes -v
+    0.8.2.custom
+
+Or on any machine with Ruby installed. You can copy it to the machine, ssh into it, and install the custom gem:
+
+    $ scp pkg/kubes-0.8.2.custom.gem user@server.com:
+    $ ssh user@server.com
+    $ gem install kubes-0.8.2.custom.gem
+    $ kubes -v
+    0.8.2.custom
+
+## Contributing
+
+Learning how to run a forked version of kubes allows you to make changes to the tool. Consider improving kubes by submitting a Pull Request. See: [Contributing]({% link _docs/contributing.md %}).

data/docs/_docs/patterns/central-deployer.md

@@ -7,18 +7,18 @@ categories: patterns
 Kubes can be use as either an app-centric or ops-centric tool.
 
 * **app-centric**: Each app repo has it's own `.kubes` settings files. This is useful if your applications are very differently setup.
-* **ops-centric**: Each app repo has pretty much the same `.kubes` settings files. This is useful if your applications are very similarly setup.
+* **ops-centric**: Each app repo has pretty much the same `.kubes` settings files. This is useful if your applications are very similarly set up.
 
 ## Setup
 
 With an ops-centric approach, you use the same `.kubes` settings files for the app repos you want to use. For example:
 
-    https://github.com/repo/app1
-    https://github.com/repo/app2
+    https://github.com/org/app1
+    https://github.com/org/app2
 
 You then also have a
 
-    https://github.com/repo/.kubes
+    https://github.com/org/.kubes
 
 You can simply copy the `.kubes` folder into the app repo folder or even add the `repo/.kubes` as a submodule.
 

data/docs/_docs/yaml/erb-comment.md

@@ -30,7 +30,7 @@ spec:
   type: ClusterIP
 ```
 
-This allows IDB kubernetes autocompletion plugins and tools to work because the `.kubes/resources/web/service.yaml` source code itself is perfectly valid YAML.
+This allows IDE kubernetes autocompletion plugins and tools to work because the `.kubes/resources/web/service.yaml` source code itself is perfectly valid YAML.
 
 The `#ERB` comments are essentially replaced by `<% ... %>` tags before ERB processing happens. Example:
 

data/docs/_includes/sidebar.html

@@ -54,7 +54,11 @@
       </li>
       <li><a href="{% link _docs/install.md %}">Install</a>
         <ul>
-          <li><a href="{% link _docs/install/gem.md %}">Gem</a></li>
+          <li><a href="{% link _docs/install/gem.md %}">Gem</a>
+            <ul>
+              <li><a href="{% link _docs/install/gem/custom-version.md %}">Custom Version</a></li>
+            </ul>
+          </li>
           <li><a href="{% link _docs/install/standalone.md %}">Standalone</a>
             <ul>
               {% assign docs = site.docs | where: "categories","standalone" | sort:"order" %}
@@ -235,7 +239,7 @@
     <h2>sidebar options:</h2>
     <ul class="list-unstyled">
       <li><a href="#" id="expand-all">expand all</a></li>
-      <li><a href="{{ site.gh_url }}/blob/master/docs/{{ page.path }}" target="_blank">edit page</a></li>
+      <li><a href="{{ site.gh_url }}/blob/master/docs/" id="edit-page" target="_blank">edit page</a></li>
     </ul>
   </div>
 </div>

data/kubes.gemspec

@@ -30,8 +30,8 @@ Gem::Specification.new do |spec|
   spec.add_dependency "zeitwerk"
 
   # core helper libs
-  spec.add_dependency "kubes_aws", "~> 0.3.1"
-  spec.add_dependency "kubes_google", "~> 0.3.5"
+  spec.add_dependency "kubes_aws", ">= 0.3.1"
+  spec.add_dependency "kubes_google", ">= 0.3.8"
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "byebug"

data/lib/kubes/version.rb

@@ -1,3 +1,3 @@
 module Kubes
-  VERSION = "0.8.1"
+  VERSION = "0.8.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kubes
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.2
 platform: ruby
 authors:
 - Tung Nguyen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-02-06 00:00:00.000000000 Z
+date: 2022-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -154,30 +154,30 @@ dependencies:
   name: kubes_aws
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.1
 - !ruby/object:Gem::Dependency
   name: kubes_google
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.5
+        version: 0.3.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.5
+        version: 0.3.8
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -346,6 +346,7 @@ files:
 - docs/_docs/install.md
 - docs/_docs/install/dependencies.md
 - docs/_docs/install/gem.md
+- docs/_docs/install/gem/custom-version.md
 - docs/_docs/install/standalone.md
 - docs/_docs/install/standalone/centos.md
 - docs/_docs/install/standalone/details.md