Skip to content

Commit 3f54b84

Browse files
dhawtondhawton
committed
prepare for v as istio source is already branched
1 parent 268a16f commit 3f54b84

File tree

35 files changed

+197
-1240
lines changed

35 files changed

+197
-1240
lines changed

‎Makefile.core.mk‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ export NETLIFY_URL
8787

8888

8989
# Which branch of the Istio source code do we fetch stuff from
90-
export SOURCE_BRANCH_NAME ?= master
90+
export SOURCE_BRANCH_NAME ?= release-1.28
9191

9292
site:
9393
@scripts/gen_site.sh

‎content/en/docs/examples/virtual-machines/snips.sh‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ sudo systemctl restart mysql
3939
}
4040

4141
snip_running_mysql_on_the_vm_3() {
42-
curl -LO https://raw.githubusercontent.com/istio/istio/master/samples/bookinfo/src/mysql/mysqldb-init.sql
42+
curl -LO https://raw.githubusercontent.com/istio/istio/release-1.28/samples/bookinfo/src/mysql/mysqldb-init.sql
4343
mysql -u root -ppassword < mysqldb-init.sql
4444
}
4545

‎content/en/docs/reference/commands/install-cni/index.html‎

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -574,15 +574,9 @@ <h2 id="envvars">Environment variables</h2>
574574
WARNING: Setting compliance policy in the control plane is a necessary but
575575
not a sufficient requirement to achieve compliance. There are additional
576576
steps necessary to claim compliance, including using the validated
577-
cryptographic modules (please consult
577+
cryptograhic modules (please consult
578578
https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/security/ssl#fips-140-2).</td>
579579
</tr>
580-
<tr id='disable-shadow-host-suffix'>
581-
<td><a href='#disable-shadow-host-suffix'><code>DISABLE_SHADOW_HOST_SUFFIX</code></a></td>
582-
<td>Boolean</td>
583-
<td><code>true</code></td>
584-
<td>If disabled, the shadow host suffix will be added to the hostnames of the mirrored requests.</td>
585-
</tr>
586580
<tr id='dry-run-file-path'>
587581
<td><a href='#dry-run-file-path'><code>DRY_RUN_FILE_PATH</code></a></td>
588582
<td>String</td>
@@ -953,6 +947,18 @@ <h2 id="envvars">Environment variables</h2>
953947
<td><code>false</code></td>
954948
<td>This will disable metrics endpoint from outside of the pod, allowing only localhost access.</td>
955949
</tr>
950+
<tr id='metric-graceful-deletion-interval'>
951+
<td><a href='#metric-graceful-deletion-interval'><code>METRIC_GRACEFUL_DELETION_INTERVAL</code></a></td>
952+
<td>Time Duration</td>
953+
<td><code>5m0s</code></td>
954+
<td>Metric expiry graceful deletion interval. No-op if METRIC_ROTATION_INTERVAL is disabled.</td>
955+
</tr>
956+
<tr id='metric-rotation-interval'>
957+
<td><a href='#metric-rotation-interval'><code>METRIC_ROTATION_INTERVAL</code></a></td>
958+
<td>Time Duration</td>
959+
<td><code>0s</code></td>
960+
<td>Metric scope rotation interval, set to 0 to disable the metric scope rotation</td>
961+
</tr>
956962
<tr id='monitoring-port'>
957963
<td><a href='#monitoring-port'><code>MONITORING_PORT</code></a></td>
958964
<td>Integer</td>
@@ -1400,7 +1406,7 @@ <h2 id="envvars">Environment variables</h2>
14001406
<tr id='pilot-spawn-upstream-span-for-gateway'>
14011407
<td><a href='#pilot-spawn-upstream-span-for-gateway'><code>PILOT_SPAWN_UPSTREAM_SPAN_FOR_GATEWAY</code></a></td>
14021408
<td>Boolean</td>
1403-
<td><code>true</code></td>
1409+
<td><code>false</code></td>
14041410
<td>If true, separate tracing span for each upstream request for gateway.</td>
14051411
</tr>
14061412
<tr id='pilot-status-max-workers'>
@@ -1651,7 +1657,6 @@ <h2 id="metrics">Exported metrics</h2>
16511657
<tr><td><code>pilot_xds_expired_nonce</code></td><td><code>Sum</code></td><td>Total number of XDS requests with an expired nonce.</td></tr>
16521658
<tr><td><code>pilot_xds_lds_reject</code></td><td><code>LastValue</code></td><td>Pilot rejected LDS.</td></tr>
16531659
<tr><td><code>pilot_xds_rds_reject</code></td><td><code>LastValue</code></td><td>Pilot rejected RDS.</td></tr>
1654-
<tr><td><code>pilot_xds_recv_max</code></td><td><code>LastValue</code></td><td>The maximum size request we have received so far.</td></tr>
16551660
<tr><td><code>pilot_xds_send_time</code></td><td><code>Distribution</code></td><td>Total time in seconds Pilot takes to send generated configuration.</td></tr>
16561661
<tr><td><code>pilot_xds_write_timeout</code></td><td><code>Sum</code></td><td>Pilot XDS response write timeouts.</td></tr>
16571662
<tr><td><code>provider_lookup_cluster_failures</code></td><td><code>Sum</code></td><td>Number of times a cluster lookup failed</td></tr>

‎content/en/docs/reference/commands/istioctl/index.html‎

Lines changed: 23 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -141,10 +141,10 @@ <h4 id="istioctl-admin Examples">Examples</h4>
141141
</code></pre>
142142
<h3 id="istioctl-admin-log">istioctl admin log</h3>
143143
<p>Retrieve or update logging levels of istiod components.</p>
144-
<pre class="language-bash"><code>istioctl admin log [&lt;pod-name&gt;]|[-r|--revision] [--level &lt;scope&gt;:&lt;level&gt;][--stack-trace-level &lt;scope&gt;:&lt;level&gt;]|[--reset|--log-reset|--stack-trace-reset]|[--output|-o short|json|yaml] [flags]
144+
<pre class="language-bash"><code>istioctl admin log [&lt;pod-name&gt;]|[-r|--revision] [--level &lt;scope&gt;:&lt;level&gt;][--stack-trace-level &lt;scope&gt;:&lt;level&gt;]|[--reset]|[--output|-o short|json|yaml] [flags]
145145
</code></pre>
146146
<div class="aliases">
147-
<pre class="language-bash"><code>istioctl admin l [&lt;pod-name&gt;]|[-r|--revision] [--level &lt;scope&gt;:&lt;level&gt;][--stack-trace-level &lt;scope&gt;:&lt;level&gt;]|[--reset|--log-reset|--stack-trace-reset]|[--output|-o short|json|yaml] [flags]
147+
<pre class="language-bash"><code>istioctl admin l [&lt;pod-name&gt;]|[-r|--revision] [--level &lt;scope&gt;:&lt;level&gt;][--stack-trace-level &lt;scope&gt;:&lt;level&gt;]|[--reset]|[--output|-o short|json|yaml] [flags]
148148
</code></pre></div>
149149
<table class="command-flags">
150150
<thead>
@@ -201,11 +201,6 @@ <h3 id="istioctl-admin-log">istioctl admin log</h3>
201201
<td>Comma-separated list of output logging level for scopes in the format of &lt;scope&gt;:&lt;level&gt;[,&lt;scope&gt;:&lt;level&gt;,...]. Possible values for &lt;level&gt;: none, error, warn, info, debug (default ``)</td>
202202
</tr>
203203
<tr>
204-
<td><code>--log-reset</code></td>
205-
<td></td>
206-
<td>Reset log levels to default value. (info) </td>
207-
</tr>
208-
<tr>
209204
<td><code>--namespace &lt;string&gt;</code></td>
210205
<td><code>-n</code></td>
211206
<td>Kubernetes namespace (default ``)</td>
@@ -218,7 +213,7 @@ <h3 id="istioctl-admin-log">istioctl admin log</h3>
218213
<tr>
219214
<td><code>--reset</code></td>
220215
<td></td>
221-
<td>Reset all levels to default value. (info) </td>
216+
<td>Reset levels to default value. (info) </td>
222217
</tr>
223218
<tr>
224219
<td><code>--revision &lt;string&gt;</code></td>
@@ -236,11 +231,6 @@ <h3 id="istioctl-admin-log">istioctl admin log</h3>
236231
<td>Comma-separated list of stack trace level for scopes in the format of &lt;scope&gt;:&lt;stack-trace-level&gt;[,&lt;scope&gt;:&lt;stack-trace-level&gt;,...]. Possible values for &lt;stack-trace-level&gt;: none, error, warn, info, debug (default ``)</td>
237232
</tr>
238233
<tr>
239-
<td><code>--stack-trace-reset</code></td>
240-
<td></td>
241-
<td>Reset stack stace levels to default value. (none) </td>
242-
</tr>
243-
<tr>
244234
<td><code>--vklog &lt;Level&gt;</code></td>
245235
<td></td>
246236
<td>number for the log level verbosity. Like -v flag. ex: --vklog=9 (default `0`)</td>
@@ -254,20 +244,14 @@ <h4 id="istioctl-admin-log Examples">Examples</h4>
254244
# Retrieve information about istiod logging levels on a specific control plane pod.
255245
istioctl admin l istiod-5c868d8bdd-pmvgg
256246

257-
# Update levels of the specified loggers and stack trace.
258-
istioctl admin log --level ads:debug,authorization:debug --stack-trace-level ads:debug,adsc:debug
247+
# Update levels of the specified loggers.
248+
istioctl admin log --level ads:debug,authorization:debug
259249

260250
# Retrieve information about istiod logging levels for a specified revision.
261251
istioctl admin log --revision v1
262252

263253
# Reset levels of all the loggers to default value (info).
264-
istioctl admin log --log-reset
265-
266-
# Reset all stack stace levels to default value. (none)
267-
istioctl admin log --stack-trace-reset
268-
269-
# Reset levels of all the loggers and stack stace to default value.
270-
istioctl admin log --log-reset
254+
istioctl admin log --reset
271255

272256
</code></pre>
273257
<h3 id="istioctl-analyze">istioctl analyze</h3>
@@ -622,11 +606,6 @@ <h3 id="istioctl-bug-report">istioctl bug-report</h3>
622606
<td>Set a specific directory for output archive file. (default ``)</td>
623607
</tr>
624608
<tr>
625-
<td><code>--proxy-admin-port &lt;int&gt;</code></td>
626-
<td></td>
627-
<td>Envoy proxy admin port (default `15000`)</td>
628-
</tr>
629-
<tr>
630609
<td><code>--rq-concurrency &lt;int&gt;</code></td>
631610
<td></td>
632611
<td>Set the concurrency limit of requests to the Kubernetes API server, defaults to 32. (default `0`)</td>
@@ -767,11 +746,6 @@ <h3 id="istioctl-bug-report-version">istioctl bug-report version</h3>
767746
<td>Set a specific directory for output archive file. (default ``)</td>
768747
</tr>
769748
<tr>
770-
<td><code>--proxy-admin-port &lt;int&gt;</code></td>
771-
<td></td>
772-
<td>Envoy proxy admin port (default `15000`)</td>
773-
</tr>
774-
<tr>
775749
<td><code>--rq-concurrency &lt;int&gt;</code></td>
776750
<td></td>
777751
<td>Set the concurrency limit of requests to the Kubernetes API server, defaults to 32. (default `0`)</td>
@@ -2463,11 +2437,6 @@ <h3 id="istioctl-experimental-authz-check">istioctl experimental authz check</h3
24632437
<td>Kubernetes namespace (default ``)</td>
24642438
</tr>
24652439
<tr>
2466-
<td><code>--proxy-admin-port &lt;int&gt;</code></td>
2467-
<td></td>
2468-
<td>Envoy proxy admin port (default `15000`)</td>
2469-
</tr>
2470-
<tr>
24712440
<td><code>--vklog &lt;Level&gt;</code></td>
24722441
<td></td>
24732442
<td>number for the log level verbosity. Like -v flag. ex: --vklog=9 (default `0`)</td>
@@ -2813,19 +2782,14 @@ <h3 id="istioctl-experimental-describe-pod">istioctl experimental describe pod</
28132782
<td>Kubernetes namespace (default ``)</td>
28142783
</tr>
28152784
<tr>
2816-
<td><code>--proxy-admin-port &lt;int&gt;</code></td>
2817-
<td></td>
2818-
<td>Envoy proxy admin port (default `15000`)</td>
2819-
</tr>
2820-
<tr>
28212785
<td><code>--vklog &lt;Level&gt;</code></td>
28222786
<td></td>
28232787
<td>number for the log level verbosity. Like -v flag. ex: --vklog=9 (default `0`)</td>
28242788
</tr>
28252789
</tbody>
28262790
</table>
28272791
<h4 id="istioctl-experimental-describe-pod Examples">Examples</h4>
2828-
<pre class="language-bash"><code> # Pod query with inferred namespace (current context&#39;s namespace)
2792+
<pre class="language-bash"><code> #Pod query with inferred namespace (current context&#39;s namespace)
28292793
istioctl experimental describe pod helloworld-v1-676yyy3y5r-d8hdl
28302794

28312795
# Pod query with explicit namespace
@@ -2897,19 +2861,14 @@ <h3 id="istioctl-experimental-describe-service">istioctl experimental describe s
28972861
<td>Kubernetes namespace (default ``)</td>
28982862
</tr>
28992863
<tr>
2900-
<td><code>--proxy-admin-port &lt;int&gt;</code></td>
2901-
<td></td>
2902-
<td>Envoy proxy admin port (default `15000`)</td>
2903-
</tr>
2904-
<tr>
29052864
<td><code>--vklog &lt;Level&gt;</code></td>
29062865
<td></td>
29072866
<td>number for the log level verbosity. Like -v flag. ex: --vklog=9 (default `0`)</td>
29082867
</tr>
29092868
</tbody>
29102869
</table>
29112870
<h4 id="istioctl-experimental-describe-service Examples">Examples</h4>
2912-
<pre class="language-bash"><code> # Service query with inferred namespace (current context&#39;s namespace)
2871+
<pre class="language-bash"><code> #Service query with inferred namespace (current context&#39;s namespace)
29132872
istioctl experimental describe service productpage
29142873

29152874
# Service query with explicit namespace
@@ -3216,11 +3175,6 @@ <h3 id="istioctl-experimental-internal-debug">istioctl experimental internal-deb
32163175
<td>Kubernetes configuration file (default ``)</td>
32173176
</tr>
32183177
<tr>
3219-
<td><code>--list</code></td>
3220-
<td><code>-L</code></td>
3221-
<td>List all supported debug types. </td>
3222-
</tr>
3223-
<tr>
32243178
<td><code>--namespace &lt;string&gt;</code></td>
32253179
<td><code>-n</code></td>
32263180
<td>Kubernetes namespace (default ``)</td>
@@ -3269,9 +3223,6 @@ <h4 id="istioctl-experimental-internal-debug Examples">Examples</h4>
32693223
# Retrieve sync diff for a single Envoy and Istiod
32703224
istioctl x internal-debug syncz istio-egressgateway-59585c5b9c-ndc59.istio-system
32713225

3272-
# List all supported debug types
3273-
istioctl x internal-debug --list
3274-
32753226
# SECURITY OPTIONS
32763227

32773228
# Retrieve syncz debug information directly from the control plane, using token security
@@ -3564,11 +3515,6 @@ <h3 id="istioctl-experimental-proxy-status">istioctl experimental proxy-status</
35643515
<td>Use plain-text HTTP/2 when connecting to server (no TLS). </td>
35653516
</tr>
35663517
<tr>
3567-
<td><code>--proxy-admin-port &lt;int&gt;</code></td>
3568-
<td></td>
3569-
<td>Envoy proxy admin port (default `15000`)</td>
3570-
</tr>
3571-
<tr>
35723518
<td><code>--revision &lt;string&gt;</code></td>
35733519
<td><code>-r</code></td>
35743520
<td>Control plane revision (default ``)</td>
@@ -6199,11 +6145,6 @@ <h3 id="istioctl-proxy-status">istioctl proxy-status</h3>
61996145
<td>Use plain-text HTTP/2 when connecting to server (no TLS). </td>
62006146
</tr>
62016147
<tr>
6202-
<td><code>--proxy-admin-port &lt;int&gt;</code></td>
6203-
<td></td>
6204-
<td>Envoy proxy admin port (default `15000`)</td>
6205-
</tr>
6206-
<tr>
62076148
<td><code>--revision &lt;string&gt;</code></td>
62086149
<td><code>-r</code></td>
62096150
<td>Control plane revision (default ``)</td>
@@ -8520,15 +8461,9 @@ <h2 id="envvars">Environment variables</h2>
85208461
WARNING: Setting compliance policy in the control plane is a necessary but
85218462
not a sufficient requirement to achieve compliance. There are additional
85228463
steps necessary to claim compliance, including using the validated
8523-
cryptographic modules (please consult
8464+
cryptograhic modules (please consult
85248465
https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/security/ssl#fips-140-2).</td>
85258466
</tr>
8526-
<tr id='disable-shadow-host-suffix'>
8527-
<td><a href='#disable-shadow-host-suffix'><code>DISABLE_SHADOW_HOST_SUFFIX</code></a></td>
8528-
<td>Boolean</td>
8529-
<td><code>true</code></td>
8530-
<td>If disabled, the shadow host suffix will be added to the hostnames of the mirrored requests.</td>
8531-
</tr>
85328467
<tr id='enable-100-continue-headers'>
85338468
<td><a href='#enable-100-continue-headers'><code>ENABLE_100_CONTINUE_HEADERS</code></a></td>
85348469
<td>Boolean</td>
@@ -8953,6 +8888,18 @@ <h2 id="envvars">Environment variables</h2>
89538888
<td><code>false</code></td>
89548889
<td>This will disable metrics endpoint from outside of the pod, allowing only localhost access.</td>
89558890
</tr>
8891+
<tr id='metric-graceful-deletion-interval'>
8892+
<td><a href='#metric-graceful-deletion-interval'><code>METRIC_GRACEFUL_DELETION_INTERVAL</code></a></td>
8893+
<td>Time Duration</td>
8894+
<td><code>5m0s</code></td>
8895+
<td>Metric expiry graceful deletion interval. No-op if METRIC_ROTATION_INTERVAL is disabled.</td>
8896+
</tr>
8897+
<tr id='metric-rotation-interval'>
8898+
<td><a href='#metric-rotation-interval'><code>METRIC_ROTATION_INTERVAL</code></a></td>
8899+
<td>Time Duration</td>
8900+
<td><code>0s</code></td>
8901+
<td>Metric scope rotation interval, set to 0 to disable the metric scope rotation</td>
8902+
</tr>
89568903
<tr id='mutex-profile-fraction'>
89578904
<td><a href='#mutex-profile-fraction'><code>MUTEX_PROFILE_FRACTION</code></a></td>
89588905
<td>Integer</td>
@@ -9382,7 +9329,7 @@ <h2 id="envvars">Environment variables</h2>
93829329
<tr id='pilot-spawn-upstream-span-for-gateway'>
93839330
<td><a href='#pilot-spawn-upstream-span-for-gateway'><code>PILOT_SPAWN_UPSTREAM_SPAN_FOR_GATEWAY</code></a></td>
93849331
<td>Boolean</td>
9385-
<td><code>true</code></td>
9332+
<td><code>false</code></td>
93869333
<td>If true, separate tracing span for each upstream request for gateway.</td>
93879334
</tr>
93889335
<tr id='pilot-status-max-workers'>
@@ -9552,7 +9499,6 @@ <h2 id="metrics">Exported metrics</h2>
95529499
<tr><td><code>pilot_k8s_cfg_events</code></td><td><code>Sum</code></td><td>Events from k8s config.</td></tr>
95539500
<tr><td><code>pilot_k8s_endpoints_pending_pod</code></td><td><code>LastValue</code></td><td>Number of endpoints that do not currently have any corresponding pods.</td></tr>
95549501
<tr><td><code>pilot_k8s_endpoints_with_no_pods</code></td><td><code>Sum</code></td><td>Endpoints that does not have any corresponding pods.</td></tr>
9555-
<tr><td><code>pilot_k8s_proxies_with_no_service_targets</code></td><td><code>Sum</code></td><td>Number of proxies that do not have any corresponding service targets.</td></tr>
95569502
<tr><td><code>pilot_k8s_reg_events</code></td><td><code>Sum</code></td><td>Events from k8s registry.</td></tr>
95579503
<tr><td><code>pilot_no_ip</code></td><td><code>LastValue</code></td><td>Pods not found in the endpoint table, possibly invalid.</td></tr>
95589504
<tr><td><code>pilot_proxy_convergence_time</code></td><td><code>Distribution</code></td><td>Delay in seconds between config change and a proxy receiving all required configuration.</td></tr>
@@ -9578,7 +9524,6 @@ <h2 id="metrics">Exported metrics</h2>
95789524
<tr><td><code>pilot_xds_push_time</code></td><td><code>Distribution</code></td><td>Total time in seconds Pilot takes to push lds, rds, cds and eds.</td></tr>
95799525
<tr><td><code>pilot_xds_pushes</code></td><td><code>Sum</code></td><td>Pilot build and send errors for lds, rds, cds and eds.</td></tr>
95809526
<tr><td><code>pilot_xds_rds_reject</code></td><td><code>LastValue</code></td><td>Pilot rejected RDS.</td></tr>
9581-
<tr><td><code>pilot_xds_recv_max</code></td><td><code>LastValue</code></td><td>The maximum size request we have received so far.</td></tr>
95829527
<tr><td><code>pilot_xds_send_time</code></td><td><code>Distribution</code></td><td>Total time in seconds Pilot takes to send generated configuration.</td></tr>
95839528
<tr><td><code>pilot_xds_write_timeout</code></td><td><code>Sum</code></td><td>Pilot XDS response write timeouts.</td></tr>
95849529
<tr><td><code>provider_lookup_cluster_failures</code></td><td><code>Sum</code></td><td>Number of times a cluster lookup failed</td></tr>
@@ -9593,7 +9538,7 @@ <h2 id="metrics">Exported metrics</h2>
95939538
<tr><td><code>startup_duration_seconds</code></td><td><code>LastValue</code></td><td>The time from the process starting to being marked ready.</td></tr>
95949539
<tr><td><code>wasm_cache_entries</code></td><td><code>LastValue</code></td><td>number of Wasm remote fetch cache entries.</td></tr>
95959540
<tr><td><code>wasm_cache_lookup_count</code></td><td><code>Sum</code></td><td>number of Wasm remote fetch cache lookups.</td></tr>
9596-
<tr><td><code>wasm_config_conversion_count</code></td><td><code>Sum</code></td><td>number of Wasm config conversions and results, including success, no remote load, marshal failure, remote fetch failure, miss remote fetch hint.</td></tr>
9541+
<tr><td><code>wasm_config_conversion_count</code></td><td><code>Sum</code></td><td>number of Wasm config conversion count and results, including success, no remote load, marshal failure, remote fetch failure, miss remote fetch hint.</td></tr>
95979542
<tr><td><code>wasm_config_conversion_duration</code></td><td><code>Distribution</code></td><td>Total time in milliseconds istio-agent spends on converting remote load in Wasm config.</td></tr>
95989543
<tr><td><code>wasm_remote_fetch_count</code></td><td><code>Sum</code></td><td>number of Wasm remote fetches and results, including success, download failure, and checksum mismatch.</td></tr>
95999544
<tr><td><code>webhook_patch_attempts_total</code></td><td><code>Sum</code></td><td>Webhook patching attempts</td></tr>

0 commit comments

Comments
 (0)