Skip to content

Commit 329325b

Browse files
soltyshsoltysh
committed
Add generated files
Signed-off-by: Maciej Szulik <[email protected]>
1 parent 3c60431 commit 329325b

File tree

5 files changed

+1105
-419
lines changed

5 files changed

+1105
-419
lines changed

‎content/en/docs/reference/_index.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ client libraries:
5959
a set of back-ends.
6060
* [kube-scheduler](/docs/reference/command-line-tools-reference/kube-scheduler/) -
6161
Scheduler that manages availability, performance, and capacity.
62-
62+
6363
* [Scheduler Policies](/docs/reference/scheduling/policies)
6464
* [Scheduler Profiles](/docs/reference/scheduling/config#profiles)
6565

@@ -76,6 +76,7 @@ operator to use or manage a cluster.
7676

7777
* [kubeconfig (v1)](/docs/reference/config-api/kubeconfig.v1/)
7878
* [kuberc (v1alpha1)](/docs/reference/config-api/kuberc.v1alpha1/)
79+
* [kuberc (v1beta1)](/docs/reference/config-api/kuberc.v1beta1/)
7980
* [kube-apiserver admission (v1)](/docs/reference/config-api/apiserver-admission.v1/)
8081
* [kube-apiserver configuration (v1alpha1)](/docs/reference/config-api/apiserver-config.v1alpha1/) and
8182
* [kube-apiserver configuration (v1beta1)](/docs/reference/config-api/apiserver-config.v1beta1/) and
@@ -89,7 +90,7 @@ operator to use or manage a cluster.
8990
* [kube-controller-manager configuration (v1alpha1)](/docs/reference/config-api/kube-controller-manager-config.v1alpha1/)
9091
* [kube-proxy configuration (v1alpha1)](/docs/reference/config-api/kube-proxy-config.v1alpha1/)
9192
* [`audit.k8s.io/v1` API](/docs/reference/config-api/apiserver-audit.v1/)
92-
* [Client authentication API (v1beta1)](/docs/reference/config-api/client-authentication.v1beta1/) and
93+
* [Client authentication API (v1beta1)](/docs/reference/config-api/client-authentication.v1beta1/) and
9394
[Client authentication API (v1)](/docs/reference/config-api/client-authentication.v1/)
9495
* [WebhookAdmission configuration (v1)](/docs/reference/config-api/apiserver-webhookadmission.v1/)
9596
* [ImagePolicy API (v1alpha1)](/docs/reference/config-api/imagepolicy.v1alpha1/)

‎content/en/docs/reference/config-api/kuberc.v1alpha1.md‎

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ auto_generated: true
2828

2929

3030
<tr><td><code>overrides</code> <B>[Required]</B><br/>
31-
<a href="#kubectl-config-k8s-io-v1alpha1-CommandOverride"><code>[]CommandOverride</code></a>
31+
<a href="#kubectl-config-k8s-io-v1alpha1-CommandDefaults"><code>[]CommandDefaults</code></a>
3232
</td>
3333
<td>
3434
<p>overrides allows changing default flag values of commands.
@@ -40,7 +40,7 @@ set flags each time.</p>
4040
<a href="#kubectl-config-k8s-io-v1alpha1-AliasOverride"><code>[]AliasOverride</code></a>
4141
</td>
4242
<td>
43-
<p>aliases allows defining command aliases for existing kubectl commands, with optional default flag values.
43+
<p>aliases allow defining command aliases for existing kubectl commands, with optional default flag values.
4444
If the alias name collides with a built-in command, built-in command always takes precedence.
4545
Flag overrides defined in the overrides section do NOT apply to aliases for the same command.
4646
kubectl [ALIAS NAME] [USER_FLAGS] [USER_EXPLICIT_ARGS] expands to
@@ -105,7 +105,7 @@ prependArgs:</li>
105105
<code>string</code>
106106
</td>
107107
<td>
108-
<p>Name is the name of alias that can only include alphabetical characters
108+
<p>name is the name of alias that can only include alphabetical characters
109109
If the alias name conflicts with the built-in command,
110110
built-in command will be used.</p>
111111
</td>
@@ -114,46 +114,46 @@ built-in command will be used.</p>
114114
<code>string</code>
115115
</td>
116116
<td>
117-
<p>Command is the single or set of commands to execute, such as &quot;set env&quot; or &quot;create&quot;</p>
117+
<p>command is the single or set of commands to execute, such as &quot;set env&quot; or &quot;create&quot;</p>
118118
</td>
119119
</tr>
120120
<tr><td><code>prependArgs</code> <B>[Required]</B><br/>
121121
<code>[]string</code>
122122
</td>
123123
<td>
124-
<p>PrependArgs stores the arguments such as resource names, etc.
124+
<p>prependArgs stores the arguments such as resource names, etc.
125125
These arguments are inserted after the alias name.</p>
126126
</td>
127127
</tr>
128128
<tr><td><code>appendArgs</code> <B>[Required]</B><br/>
129129
<code>[]string</code>
130130
</td>
131131
<td>
132-
<p>AppendArgs stores the arguments such as resource names, etc.
132+
<p>appendArgs stores the arguments such as resource names, etc.
133133
These arguments are appended to the USER_ARGS.</p>
134134
</td>
135135
</tr>
136136
<tr><td><code>flags</code> <B>[Required]</B><br/>
137-
<a href="#kubectl-config-k8s-io-v1alpha1-CommandOverrideFlag"><code>[]CommandOverrideFlag</code></a>
137+
<a href="#kubectl-config-k8s-io-v1alpha1-CommandOptionDefault"><code>[]CommandOptionDefault</code></a>
138138
</td>
139139
<td>
140-
<p>Flag is allocated to store the flag definitions of alias.
141-
Flag only modifies the default value of the flag and if
140+
<p>flags is allocated to store the flag definitions of alias.
141+
flags only modifies the default value of the flag and if
142142
user explicitly passes a value, explicit one is used.</p>
143143
</td>
144144
</tr>
145145
</tbody>
146146
</table>
147147

148-
## `CommandOverride` {#kubectl-config-k8s-io-v1alpha1-CommandOverride}
148+
## `CommandDefaults` {#kubectl-config-k8s-io-v1alpha1-CommandDefaults}
149149

150150

151151
**Appears in:**
152152

153153
- [Preference](#kubectl-config-k8s-io-v1alpha1-Preference)
154154

155155

156-
<p>CommandOverride stores the commands and their associated flag's
156+
<p>CommandDefaults stores the commands and their associated option's
157157
default values.</p>
158158

159159

@@ -166,31 +166,31 @@ default values.</p>
166166
<code>string</code>
167167
</td>
168168
<td>
169-
<p>Command refers to a command whose flag's default value is changed.</p>
169+
<p>command refers to a command whose flag's default value is changed.</p>
170170
</td>
171171
</tr>
172172
<tr><td><code>flags</code> <B>[Required]</B><br/>
173-
<a href="#kubectl-config-k8s-io-v1alpha1-CommandOverrideFlag"><code>[]CommandOverrideFlag</code></a>
173+
<a href="#kubectl-config-k8s-io-v1alpha1-CommandOptionDefault"><code>[]CommandOptionDefault</code></a>
174174
</td>
175175
<td>
176-
<p>Flags is a list of flags storing different default values.</p>
176+
<p>flags is a list of flags storing different default values.</p>
177177
</td>
178178
</tr>
179179
</tbody>
180180
</table>
181181

182-
## `CommandOverrideFlag` {#kubectl-config-k8s-io-v1alpha1-CommandOverrideFlag}
182+
## `CommandOptionDefault` {#kubectl-config-k8s-io-v1alpha1-CommandOptionDefault}
183183

184184

185185
**Appears in:**
186186

187187
- [AliasOverride](#kubectl-config-k8s-io-v1alpha1-AliasOverride)
188188

189-
- [CommandOverride](#kubectl-config-k8s-io-v1alpha1-CommandOverride)
189+
- [CommandDefaults](#kubectl-config-k8s-io-v1alpha1-CommandDefaults)
190190

191191

192-
<p>CommandOverrideFlag stores the name and the specified default
193-
value of the flag.</p>
192+
<p>CommandOptionDefault stores the name and the specified default
193+
value of an option.</p>
194194

195195

196196
<table class="table">

‎content/en/docs/reference/config-api/kuberc.v1beta1.md‎

Lines changed: 218 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,218 @@
1+
---
2+
title: kuberc (v1beta1)
3+
content_type: tool-reference
4+
package: kubectl.config.k8s.io/v1beta1
5+
auto_generated: true
6+
---
7+
8+
9+
## Resource Types
10+
11+
12+
- [Preference](#kubectl-config-k8s-io-v1beta1-Preference)
13+
14+
15+
## `Preference` {#kubectl-config-k8s-io-v1beta1-Preference}
16+
17+
18+
19+
<p>Preference stores elements of KubeRC configuration file</p>
20+
21+
22+
<table class="table">
23+
<thead><tr><th width="30%">Field</th><th>Description</th></tr></thead>
24+
<tbody>
25+
26+
<tr><td><code>apiVersion</code><br/>string</td><td><code>kubectl.config.k8s.io/v1beta1</code></td></tr>
27+
<tr><td><code>kind</code><br/>string</td><td><code>Preference</code></td></tr>
28+
29+
30+
<tr><td><code>defaults</code> <B>[Required]</B><br/>
31+
<a href="#kubectl-config-k8s-io-v1beta1-CommandDefaults"><code>[]CommandDefaults</code></a>
32+
</td>
33+
<td>
34+
<p>defaults allow changing default option values of commands.
35+
This is especially useful, when user doesn't want to explicitly
36+
set options each time.</p>
37+
</td>
38+
</tr>
39+
<tr><td><code>aliases</code> <B>[Required]</B><br/>
40+
<a href="#kubectl-config-k8s-io-v1beta1-AliasOverride"><code>[]AliasOverride</code></a>
41+
</td>
42+
<td>
43+
<p>aliases allow defining command aliases for existing kubectl commands, with optional default option values.
44+
If the alias name collides with a built-in command, built-in command always takes precedence.
45+
Option overrides defined in the defaults section do NOT apply to aliases for the same command.
46+
kubectl [ALIAS NAME] [USER_OPTIONS] [USER_EXPLICIT_ARGS] expands to
47+
kubectl [COMMAND] # built-in command alias points to
48+
[KUBERC_PREPEND_ARGS]
49+
[USER_OPTIONS]
50+
[KUBERC_OPTIONS] # rest of the options that are not passed by user in [USER_OPTIONS]
51+
[USER_EXPLICIT_ARGS]
52+
[KUBERC_APPEND_ARGS]
53+
e.g.</p>
54+
<ul>
55+
<li>name: runx
56+
command: run
57+
options:
58+
<ul>
59+
<li>name: image
60+
default: nginx
61+
appendArgs:</li>
62+
</ul>
63+
<hr>
64+
<ul>
65+
<li>custom-arg1
66+
For example, if user invokes &quot;kubectl runx test-pod&quot; command,
67+
this will be expanded to &quot;kubectl run --image=nginx test-pod -- custom-arg1&quot;</li>
68+
</ul>
69+
</li>
70+
<li>name: getn
71+
command: get
72+
options:
73+
<ul>
74+
<li>name: output
75+
default: wide
76+
prependArgs:</li>
77+
<li>node
78+
&quot;kubectl getn control-plane-1&quot; expands to &quot;kubectl get node control-plane-1 --output=wide&quot;
79+
&quot;kubectl getn control-plane-1 --output=json&quot; expands to &quot;kubectl get node --output=json control-plane-1&quot;</li>
80+
</ul>
81+
</li>
82+
</ul>
83+
</td>
84+
</tr>
85+
</tbody>
86+
</table>
87+
88+
## `AliasOverride` {#kubectl-config-k8s-io-v1beta1-AliasOverride}
89+
90+
91+
**Appears in:**
92+
93+
- [Preference](#kubectl-config-k8s-io-v1beta1-Preference)
94+
95+
96+
<p>AliasOverride stores the alias definitions.</p>
97+
98+
99+
<table class="table">
100+
<thead><tr><th width="30%">Field</th><th>Description</th></tr></thead>
101+
<tbody>
102+
103+
104+
<tr><td><code>name</code> <B>[Required]</B><br/>
105+
<code>string</code>
106+
</td>
107+
<td>
108+
<p>name is the name of alias that can only include alphabetical characters
109+
If the alias name conflicts with the built-in command,
110+
built-in command will be used.</p>
111+
</td>
112+
</tr>
113+
<tr><td><code>command</code> <B>[Required]</B><br/>
114+
<code>string</code>
115+
</td>
116+
<td>
117+
<p>command is the single or set of commands to execute, such as &quot;set env&quot; or &quot;create&quot;</p>
118+
</td>
119+
</tr>
120+
<tr><td><code>prependArgs</code> <B>[Required]</B><br/>
121+
<code>[]string</code>
122+
</td>
123+
<td>
124+
<p>prependArgs stores the arguments such as resource names, etc.
125+
These arguments are inserted after the alias name.</p>
126+
</td>
127+
</tr>
128+
<tr><td><code>appendArgs</code> <B>[Required]</B><br/>
129+
<code>[]string</code>
130+
</td>
131+
<td>
132+
<p>appendArgs stores the arguments such as resource names, etc.
133+
These arguments are appended to the USER_ARGS.</p>
134+
</td>
135+
</tr>
136+
<tr><td><code>options</code> <B>[Required]</B><br/>
137+
<a href="#kubectl-config-k8s-io-v1beta1-CommandOptionDefault"><code>[]CommandOptionDefault</code></a>
138+
</td>
139+
<td>
140+
<p>options is allocated to store the option definitions of alias.
141+
options only modify the default value of the option and if
142+
user explicitly passes a value, explicit one is used.</p>
143+
</td>
144+
</tr>
145+
</tbody>
146+
</table>
147+
148+
## `CommandDefaults` {#kubectl-config-k8s-io-v1beta1-CommandDefaults}
149+
150+
151+
**Appears in:**
152+
153+
- [Preference](#kubectl-config-k8s-io-v1beta1-Preference)
154+
155+
156+
<p>CommandDefaults stores the commands and their associated option's
157+
default values.</p>
158+
159+
160+
<table class="table">
161+
<thead><tr><th width="30%">Field</th><th>Description</th></tr></thead>
162+
<tbody>
163+
164+
165+
<tr><td><code>command</code> <B>[Required]</B><br/>
166+
<code>string</code>
167+
</td>
168+
<td>
169+
<p>command refers to a command whose option's default value is changed.</p>
170+
</td>
171+
</tr>
172+
<tr><td><code>options</code> <B>[Required]</B><br/>
173+
<a href="#kubectl-config-k8s-io-v1beta1-CommandOptionDefault"><code>[]CommandOptionDefault</code></a>
174+
</td>
175+
<td>
176+
<p>options is a list of options storing different default values.</p>
177+
</td>
178+
</tr>
179+
</tbody>
180+
</table>
181+
182+
## `CommandOptionDefault` {#kubectl-config-k8s-io-v1beta1-CommandOptionDefault}
183+
184+
185+
**Appears in:**
186+
187+
- [AliasOverride](#kubectl-config-k8s-io-v1beta1-AliasOverride)
188+
189+
- [CommandDefaults](#kubectl-config-k8s-io-v1beta1-CommandDefaults)
190+
191+
192+
<p>CommandOptionDefault stores the name and the specified default
193+
value of an option.</p>
194+
195+
196+
<table class="table">
197+
<thead><tr><th width="30%">Field</th><th>Description</th></tr></thead>
198+
<tbody>
199+
200+
201+
<tr><td><code>name</code> <B>[Required]</B><br/>
202+
<code>string</code>
203+
</td>
204+
<td>
205+
<p>Option name (long form, without dashes).</p>
206+
</td>
207+
</tr>
208+
<tr><td><code>default</code> <B>[Required]</B><br/>
209+
<code>string</code>
210+
</td>
211+
<td>
212+
<p>In a string format of a default value. It will be parsed
213+
by kubectl to the compatible value of the option.</p>
214+
</td>
215+
</tr>
216+
</tbody>
217+
</table>
218+

0 commit comments

Comments
 (0)