chore(release-process): update flags and flags link

as part of the release process, it is required to update the flags documentation and also ensuring that the components.md file points to the tagged version of the flags.md file.

Author: Tore Stendal Lønøy

vertical-pod-autoscaler/RELEASE.md

@@ -122,12 +122,18 @@ sure nothing we care about will break if we do.
 1.  [ ] Update information about newest version and K8s compatibility in
     [the installation section of README](https://github.com/kubernetes/autoscaler/blob/master/vertical-pod-autoscaler/README.md#installation).
 
-1.  [ ] Update the yaml files:
+1.  [ ] Update the yaml and sh files:
 
     ```sh
-    sed -i -s "s|[0-9]\+\.[0-9]\+\.[0-9]\+|[*vpa-version*]|" ./deploy/*-deployment*.yaml ./hack/vpa-process-yaml.sh
+    sed -i -s "s|[0-9]\+\.[0-9]\+\.[0-9]\+|[*vpa-version*]|g" ./deploy/*-deployment*.yaml
+    sed -i -s "s|DEFAULT_TAG=\"[0-9]\+\.[0-9]\+\.[0-9]\+\"|DEFAULT_TAG=\"[*vpa-version*]\"|g" ./hack/*.sh
+    ```
+
+1.  [ ] Generate the flags files:
+
+    ```sh
+    ./hack/generate-flags.sh
     ```
-1.  [ ] Update the default tag in  [vpa-up.sh](https://github.com/kubernetes/autoscaler/blob/master/vertical-pod-autoscaler/hack/vpa-up.sh).
 
 1.  [ ] Merge these changes into branch vpa-release-1.{$minor} and optionally into master if 1.{$minor} is the latest minor release
     (example PR: [#5460](https://github.com/kubernetes/autoscaler/pull/5460)).

vertical-pod-autoscaler/docs/flags.md

@@ -1,6 +1,8 @@
 # Vertical Pod Autoscaler Flags
 This document contains the flags for all VPA components.
 
+To view the most recent _release_ of flags for all VPA components, consult the release tag [flags(1.3.0)](/kubernetes/autoscaler/blob/vertical-pod-autoscaler-1.3.0/vertical-pod-autoscaler/docs/flags.md) documentation.
+
 > **Note:** This document is auto-generated from the default branch (master) of the VPA repository.
 
 # What are the parameters to VPA admission-controller?
@@ -34,7 +36,7 @@ This document is auto-generated from the flag definitions in the VPA admission-c
 | `--tls-cert-file` | "/etc/tls-certs/serverCert.pem" |                   Path to server certificate PEM file. |
 | `--tls-ciphers` |  |                     A comma-separated or colon-separated list of ciphers to accept.  Only works when min-tls-version is set to tls1_2. |
 | `--tls-private-key` | "/etc/tls-certs/serverKey.pem" |                 Path to server certificate key PEM file. |
-| `--v` | 4 | Set the log level verbosity |
+| `--v` |  | Set the log level verbosity |
 | `--vmodule` |  |                     comma-separated list of pattern=N settings for file-filtered logging |
 | `--vpa-object-namespace` |  |            Specifies the namespace to search for VPA objects. Leave empty to include all namespaces. If provided, the garbage collector will only clean this namespace. |
 | `--webhook-address` |  |                 Address under which webhook is registered. Used when registerByURL is set to true. |
@@ -119,7 +121,7 @@ This document is auto-generated from the flag definitions in the VPA recommender
 | `--target-memory-percentile` | 0.9 |                         Memory usage percentile that will be used as a base for memory target recommendation. Doesn't affect memory lower bound nor memory upper bound. |
 | `--use-external-metrics` |  |                                   ALPHA.  Use an external metrics provider instead of metrics_server. |
 | `--username` |  |                                        The username used in the prometheus server basic auth |
-| `--v` | 4 | Set the log level verbosity |
+| `--v` |  | Set the log level verbosity |
 | `--vmodule` |  |                                     comma-separated list of pattern=N settings for file-filtered logging |
 | `--vpa-object-namespace` |  |                            Specifies the namespace to search for VPA objects. Leave empty to include all namespaces. If provided, the garbage collector will only clean this namespace. |
 
@@ -161,7 +163,7 @@ This document is auto-generated from the flag definitions in the VPA updater cod
 | `--stderrthreshold` |  |                                        set the log level threshold for writing to standard error |
 | `--updater-interval` | 1m0s |                                       How often updater should run |
 | `--use-admission-controller-status` | true |                                 If true, updater will only evict pods when admission controller status is valid. |
-| `--v` | 4 | Set the log level verbosity |
+| `--v` |  | Set the log level verbosity |
 | `--vmodule` |  |                                              comma-separated list of pattern=N settings for file-filtered logging |
 | `--vpa-object-namespace` |  |                                     Specifies the namespace to search for VPA objects. Leave empty to include all namespaces. If provided, the garbage collector will only clean this namespace. |
 

vertical-pod-autoscaler/hack/generate-flags.sh

@@ -21,6 +21,7 @@ set -o pipefail
 SCRIPT_ROOT=$(realpath $(dirname "${BASH_SOURCE[0]}"))/..
 TARGET_FILE="${SCRIPT_ROOT}/docs/flags.md"
 COMPONENTS=("admission-controller" "recommender" "updater")
+DEFAULT_TAG="1.3.0"
 
 # Function to extract flags from a binary
 extract_flags() {
@@ -75,6 +76,8 @@ echo "Generating flags documentation..."
     echo "# Vertical Pod Autoscaler Flags"
     echo "This document contains the flags for all VPA components."
     echo
+    echo "To view the most recent _release_ of flags for all VPA components, consult the release tag [flags($DEFAULT_TAG)](/kubernetes/autoscaler/blob/vertical-pod-autoscaler-$DEFAULT_TAG/vertical-pod-autoscaler/docs/flags.md) documentation."
+    echo
     echo "> **Note:** This document is auto-generated from the default branch (master) of the VPA repository."
     echo