Add proto generation automation script and workflow integration

Co-authored-by: brendandburns <[email protected]>

Author: Copilot

.github/workflows/generate.yml

@@ -73,12 +73,22 @@ jobs:
 
           USE_SINGLE_PARAMETER=true bash java.sh ../../kubernetes/ settings
           popd
-          rm -rf gen
           git config user.email "[email protected]"
           git config user.name "Kubernetes Publisher"
           git checkout -b "$BRANCH"
           git add .
           git commit -s -m 'Automated openapi generation from ${{ github.event.inputs.kubernetesBranch }}'
+      - name: Generate Proto
+        run: |
+          pushd gen/proto
+          # Download proto dependencies for the specified Kubernetes branch
+          bash dependencies.sh "${{ github.event.inputs.kubernetesBranch }}"
+          # Generate Java proto classes
+          bash generate.sh java ../../proto/src/main/java/
+          popd
+          rm -rf gen
+          git add proto/
+          git commit -s -m 'Automated proto generation from ${{ github.event.inputs.kubernetesBranch }}'
       - name: Apply Manual Diffs
         if: ${{ github.event.inputs.skip_patches != 'true' }}
         run: |

proto/README.md

@@ -1,7 +1,43 @@
 # Generating proto files
 
+## Automated Generation
+
+Protocol buffer files are automatically generated as part of the regular code generation workflow when a new Kubernetes release is published. This happens through the GitHub Actions workflow defined in `.github/workflows/generate.yml`.
+
+To trigger proto generation manually along with OpenAPI generation:
+
+1. Go to the [Generate workflow](https://github.com/kubernetes-client/java/actions/workflows/generate.yml) in GitHub Actions
+2. Click "Run workflow"
+3. Specify the Kubernetes branch (e.g., "release-1.30" or "master")
+4. The workflow will automatically:
+   - Generate OpenAPI client code
+   - Generate protocol buffer classes
+   - Apply any necessary patches
+   - Generate fluent API
+   - Create a pull request with all changes
+
+## Manual Generation
+
+For local development or testing, you can generate proto files manually using the provided script:
+
+```sh
+cd /path/to/kubernetes-client-java
+KUBERNETES_BRANCH=master bash scripts/update-proto.sh
+```
+
+You can specify a different Kubernetes branch/tag:
+
+```sh
+KUBERNETES_BRANCH=release-1.30 bash scripts/update-proto.sh
+```
+
+## Using the kubernetes-client/gen Repository Directly
+
+Alternatively, you can use the kubernetes-client/gen repository directly:
+
 ```sh
 git clone https://github.com/kubernetes-client/gen
 cd gen/proto
-./generate.sh java ${PATH_TO_JAVA_CLIENT_ROOT}/java/proto/src/main/java/
+bash dependencies.sh master  # or specify a different branch
+bash generate.sh java ${PATH_TO_JAVA_CLIENT_ROOT}/proto/src/main/java/
 `````````````````````````````````

scripts/update-proto.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+
+# Copyright 2017 The Kubernetes Authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Script to generate protocol buffer classes from upstream Kubernetes proto files.
+# Generates proto classes at proto/src/main/java/
+
+set -o errexit
+set -o nounset
+set -o pipefail
+
+SCRIPT_ROOT=$(dirname "${BASH_SOURCE}")
+PROTO_ROOT="${SCRIPT_ROOT}/../proto"
+
+pushd "${SCRIPT_ROOT}" > /dev/null
+SCRIPT_ROOT=$(pwd)
+popd > /dev/null
+
+pushd "${PROTO_ROOT}" > /dev/null
+PROTO_ROOT=$(pwd)
+popd > /dev/null
+
+TEMP_FOLDER=$(mktemp -d)
+trap "rm -rf ${TEMP_FOLDER}" EXIT SIGINT
+
+if [[ -z ${GEN_ROOT:-} ]]; then
+    GEN_ROOT="${TEMP_FOLDER}/gen"
+    echo ">>> Cloning gen repo"
+    git clone --recursive https://github.com/kubernetes-client/gen.git "${GEN_ROOT}"
+else
+    echo ">>> Reusing gen repo at ${GEN_ROOT}"
+fi
+
+# Allow specifying Kubernetes branch/tag, default to master
+KUBERNETES_BRANCH="${KUBERNETES_BRANCH:-master}"
+
+echo ">>> Generating proto files from Kubernetes ${KUBERNETES_BRANCH}"
+pushd "${GEN_ROOT}/proto" > /dev/null
+# Download proto dependencies for the specified Kubernetes branch
+bash dependencies.sh "${KUBERNETES_BRANCH}"
+# Generate Java proto classes
+bash generate.sh java "${PROTO_ROOT}/src/main/java/"
+popd > /dev/null
+
+echo ">>> Done."