kruby 1.36.0.4 → 1.36.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +63 -5
- data/lib/kubernetes/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 48735cde95715a6cfd7f6d62ddcab32548709ad660fc46ea00903335640daedf
|
|
4
|
+
data.tar.gz: 851c93212611a110cf4a13fa4c2ce0aba252522d70a8e228045633e44751367a
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5abb5cd43b9d158927cf98fe8da73177e222f5db42e523e952544742ad1417bacee5fcf3f67c81e3a6e25264b0a9fa9c8438700ccb75aee5e5a165b39fbc8fe3
|
|
7
|
+
data.tar.gz: c31af26d89ed7b923a34075a45e1b95ef642c738438a0d2c020ac23e423bdc9e74efb8bdde090439317f1fe7fcba7fc5d6070d5516479fffe681c51b827e8359
|
data/README.md
CHANGED
|
@@ -7,7 +7,7 @@ No description provided (generated by Openapi Generator https://github.com/opena
|
|
|
7
7
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
|
8
8
|
|
|
9
9
|
- API version: release-1.36
|
|
10
|
-
- Package version: 1.36.
|
|
10
|
+
- Package version: 1.36.2.1
|
|
11
11
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
|
12
12
|
|
|
13
13
|
## Project Origin
|
|
@@ -18,7 +18,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
|
|
|
18
18
|
## Release History
|
|
19
19
|
|
|
20
20
|
- User-visible release notes are tracked in the repository [CHANGELOG.md](https://github.com/doridoridoriand/kruby/blob/master/CHANGELOG.md).
|
|
21
|
-
- Release tags use the format `v<version>` (for example `v1.36.
|
|
21
|
+
- Release tags use the format `v<version>` (for example `v1.36.2.1`), and matching GitHub Releases are published at [github.com/doridoridoriand/kruby/releases](https://github.com/doridoridoriand/kruby/releases).
|
|
22
22
|
|
|
23
23
|
## Installation
|
|
24
24
|
|
|
@@ -33,17 +33,17 @@ gem build kubernetes.gemspec
|
|
|
33
33
|
Then either install the gem locally:
|
|
34
34
|
|
|
35
35
|
```shell
|
|
36
|
-
gem install ./kruby-1.36.
|
|
36
|
+
gem install ./kruby-1.36.2.1.gem
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
(for development, run `gem install --dev ./kruby-1.36.
|
|
39
|
+
(for development, run `gem install --dev ./kruby-1.36.2.1.gem` to install the development dependencies)
|
|
40
40
|
|
|
41
41
|
or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
|
|
42
42
|
|
|
43
43
|
Finally add this to the Gemfile:
|
|
44
44
|
|
|
45
45
|
```ruby
|
|
46
|
-
gem 'kruby', '~> 1.36.
|
|
46
|
+
gem 'kruby', '~> 1.36.2.1'
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
### Install from Git
|
|
@@ -89,6 +89,64 @@ end
|
|
|
89
89
|
|
|
90
90
|
For backward compatibility, `require 'kubernetes'` is also supported.
|
|
91
91
|
|
|
92
|
+
## Usage Guides
|
|
93
|
+
|
|
94
|
+
### Common API entry points
|
|
95
|
+
|
|
96
|
+
- Core resources: [CoreV1Api](docs/CoreV1Api.md), [V1Pod](docs/V1Pod.md), [V1ConfigMap](docs/V1ConfigMap.md), [V1Service](docs/V1Service.md)
|
|
97
|
+
- Workloads: [AppsV1Api](docs/AppsV1Api.md), [BatchV1Api](docs/BatchV1Api.md), [V1Deployment](docs/V1Deployment.md), [V1StatefulSet](docs/V1StatefulSet.md)
|
|
98
|
+
- Networking and policy: [NetworkingV1Api](docs/NetworkingV1Api.md), [V1Ingress](docs/V1Ingress.md), [V1NetworkPolicy](docs/V1NetworkPolicy.md)
|
|
99
|
+
- Custom resources: [CustomObjectsApi](docs/CustomObjectsApi.md)
|
|
100
|
+
- Discovery and cluster metadata: [DiscoveryApi](docs/DiscoveryApi.md), [VersionApi](docs/VersionApi.md)
|
|
101
|
+
- Logs and streaming: [LogsApi](docs/LogsApi.md), `Kubernetes::Watch`
|
|
102
|
+
|
|
103
|
+
### Curated examples
|
|
104
|
+
|
|
105
|
+
- Full example index: <https://github.com/doridoridoriand/kruby/tree/master/examples/README.md>
|
|
106
|
+
- Minimal client: <https://github.com/doridoridoriand/kruby/blob/master/examples/simple/simple.rb>
|
|
107
|
+
- Safe dry-run write: <https://github.com/doridoridoriand/kruby/blob/master/examples/dry-run/dry-run.rb>
|
|
108
|
+
- Efficient filtered reads: <https://github.com/doridoridoriand/kruby/blob/master/examples/label-selector/label-selector.rb>
|
|
109
|
+
- Concurrent watches: <https://github.com/doridoridoriand/kruby/blob/master/examples/multi-watch/multi-watch.rb>
|
|
110
|
+
- Logs with lifecycle cleanup: <https://github.com/doridoridoriand/kruby/blob/master/examples/logs/logs.rb>
|
|
111
|
+
|
|
112
|
+
### Error handling
|
|
113
|
+
|
|
114
|
+
```ruby
|
|
115
|
+
config = Kubernetes::Configuration.default_config
|
|
116
|
+
Kubernetes.load_kube_config(ENV["KUBECONFIG"], client_configuration: config)
|
|
117
|
+
client = Kubernetes::CoreV1Api.new(Kubernetes::ApiClient.new(config))
|
|
118
|
+
|
|
119
|
+
begin
|
|
120
|
+
pod = client.read_namespaced_pod("example", "default")
|
|
121
|
+
puts pod.metadata.name
|
|
122
|
+
rescue Kubernetes::ApiError => e
|
|
123
|
+
case e.code.to_i
|
|
124
|
+
when 404
|
|
125
|
+
warn "Pod was not found"
|
|
126
|
+
when 409
|
|
127
|
+
warn "Resource version conflict"
|
|
128
|
+
else
|
|
129
|
+
warn "Kubernetes API call failed: #{e.message}"
|
|
130
|
+
raise
|
|
131
|
+
end
|
|
132
|
+
end
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
### Concurrent usage
|
|
136
|
+
|
|
137
|
+
When you need multiple long-lived streams, create one `Kubernetes::ApiClient`, wrap it in `Kubernetes::Watch`, and fan out watches in threads.
|
|
138
|
+
See the `multi-watch` example for a concrete pattern:
|
|
139
|
+
|
|
140
|
+
- <https://github.com/doridoridoriand/kruby/blob/master/examples/multi-watch/multi-watch.rb>
|
|
141
|
+
|
|
142
|
+
### Performance tips
|
|
143
|
+
|
|
144
|
+
- Reuse a single `Kubernetes::ApiClient` and API object across many calls instead of rebuilding them per request.
|
|
145
|
+
- Prefer `label_selector` and `field_selector` when listing large collections.
|
|
146
|
+
- Use `Kubernetes::Watch` for change streams instead of frequent polling loops.
|
|
147
|
+
- Start from namespaced list/read methods when you already know the namespace to reduce server-side work.
|
|
148
|
+
- Use dry-run for manifest validation paths that should not persist resources.
|
|
149
|
+
|
|
92
150
|
## Documentation for API Endpoints
|
|
93
151
|
|
|
94
152
|
All URIs are relative to *http://localhost*
|
data/lib/kubernetes/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: kruby
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.36.
|
|
4
|
+
version: 1.36.2.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- doridoridoriand
|
|
@@ -932,7 +932,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
932
932
|
- !ruby/object:Gem::Version
|
|
933
933
|
version: '0'
|
|
934
934
|
requirements: []
|
|
935
|
-
rubygems_version:
|
|
935
|
+
rubygems_version: 3.6.7
|
|
936
936
|
specification_version: 4
|
|
937
937
|
summary: Kruby community client for Kubernetes API.
|
|
938
938
|
test_files: []
|