gke-operator

command module
v1.16.0-rc.6 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 19, 2026 License: Apache-2.0 Imports: 8 Imported by: 0

README

Nightly e2e tests

gke-operator

The GKE operator is a controller for Kubernetes Custom Resource Definitions (CRDs) that manages cluster provisioning in Google Kubernetes Engine. It uses a GKEClusterConfig defined by a CRD.

Build

Operator binary can be built using the following command:

    make operator

Deploy operator from source

You can use the following command to deploy a Kind cluster with Rancher manager and operator:

    make kind-deploy-operator

After this, you can also scale down operator deployment and run it from a local binary.

Tests

To run unit tests use the following command:

    make test

E2E

We run e2e tests after every merged PR and periodically every 24 hours. They are triggered by a Github action

For running e2e tests:

  1. Set GKE_PROJECT_ID and GKE_CREDENTIALS environment variables:
    export GKE_PROJECT_ID="replace-with-your-value"
    export GKE_CREDENTIALS=$( cat /path/to/gke-credentials.json )
  1. and finally run:
    make kind-e2e-tests

This will setup a kind cluster locally, and the e2e tests will be run against where it will:

* deploy rancher and cert-manager
* deploy gke operator and operator CRD charts
* create gke credentials secret
* create a cluster in GKE
* wait for cluster to be ready
* clean up cluster

Once e2e tests are completed, the local kind cluster can also be deleted by running:

    make delete-local-kind-cluster

Release

When should I release?

A KEv2 operator should be released if:

  • There have been several commits since the last release,
  • You need to pull in an update/bug fix/backend code to unblock UI for a feature enhancement in Rancher
  • The operator needs to be unRC for a Rancher release
How do I release?

Tag the latest commit on the master branch. For example, if latest tag is:

  • v1.1.3-rc1 you should tag v1.1.3-rc2.
  • v1.1.3 you should tag v1.1.4-rc1.
# Get the latest upstream changes
# Note: `upstream` must be the remote pointing to `git@github.com:rancher/gke-operator.git`.
git pull upstream master --tags

# Export the tag of the release to be cut, e.g.:
export RELEASE_TAG=v1.1.3-rc2

# Create tags locally
git tag -s -a ${RELEASE_TAG} -m ${RELEASE_TAG}

# Push tags
# Note: `upstream` must be the remote pointing to `git@github.com:rancher/gke-operator.git`.
git push upstream ${RELEASE_TAG}

After pushing the release tag, you need to run 2 Github Actions. You can find them in the Actions tab of the repo:

How do I unRC?

unRC is the process of removing the rc from a KEv2 operator tag and means the released version is stable and ready for use. Release the KEv2 operator but instead of bumping the rc, remove the rc. For example, if the latest release of GKE operator is:

  • v1.1.3-rc1, release the next version without the rc which would be v1.1.3.
  • v1.1.3, that has no rc so release that version or v1.1.4 if updates are available.
Chart releases (charts v2)

Pushing a v* tag starts the Stage chart workflow. It does not wait for the images of the release workflow. It stages the rancher-gke-operator and rancher-gke-operator-crd charts in the staging registry with cargueiro and opens a pull request against the staging branch of rancher/charts. The charts come from charts/gke-operator and charts/gke-operator-crd, prepared for the tag by prepare-charts.sh. cargueiro works out the chart version from the catalog.cattle.io/rancher-version annotation, the app version and the versions already released, and writes the helm.sh/images annotation from the image in values.yaml. The chart steps of the release workflow stay until the old chart path is retired.

A tag v1.N.x is for Rancher 2.N. Before the first tag of a new minor, update the catalog.cattle.io/rancher-version and kube-version annotations in charts/gke-operator/Chart.yaml: the workflow refuses a tag that does not match them, before anything is pushed. If it fails, fix the cause and run it again on the tag with gh workflow run stage-chart.yaml --ref <tag>; what to do after a push is in When something fails.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
pkg
apis/gke.cattle.io/v1
+k8s:deepcopy-gen=package +groupName=gke.cattle.io
+k8s:deepcopy-gen=package +groupName=gke.cattle.io
codegen command
codegen/cleanup command
gke
gke/services/mock_services
Package mock_services is a generated GoMock package.
Package mock_services is a generated GoMock package.
test

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL