Skip to main content

Auto-Update Process (Ocean GKE)

Cloud service provider relevance: GKE

Ocean auto-updates keep your clusters and virtual node groups (VNGs) synchronized with the respective GKE configuration in the control plane manager. Configuration changes made on the GKE cluster or node pools are automatically reflected in the Ocean configuration.

You only need to update specific GKE parameters once in your GKE console, such as Kubernetes Version or NodeLocal DNSCaching, and Ocean automatically syncs the changes.

Prerequisites​

  • The console's cluster version and the default node pool version must be identical to apply auto-updates for custom and default virtual node groups.

  • Preserve the original node pool name to ensure upgrade synchronization. You can drain all nodes from the original node pool, but do not delete or rename it.

How It Works​

The auto-update process runs once every 30 minutes, as follows:

  1. Ocean scans the GKE cluster and node pool configurations for changes to these fields: version, metadata (Kube-labels, Kube-env), sourceImage, and serviceAccount.
  2. When Ocean detects changes, it automatically updates the corresponding Ocean cluster configuration and affected virtual node groups.
  3. The updated configuration becomes active in Ocean.

Example Scenario​

If you created an Ocean cluster with virtual node groups using the Spot console, and you enabled the NodeLocal DNSCache:

  1. GKE adds labels to the node pool metadata that allow the affinity of the nodeLocal dns daemonSet pods to be scheduled to the nodes.
  2. Ocean’s auto-update process runs at regular intervals and discovers changes in the GKE node pool configurations.
  3. The Ocean-managed virtual node groups are updated with the new labels to reflect the added NodeLocal DNSCache.
  4. The changes take effect in Ocean, and the daemonset is scheduled as expected.

Turn the Auto-Update Process on or off for Your Clusters​

You can optionally enable the auto-update through the Spot API at the cluster level (under cluster).

By default, autoUpdate = true

Set autoUpdate = false to turn off auto-update.

Manually Trigger the Auto-Update Process​

The auto-update process occurs every 30 minutes (by default). If you do not want to wait, use the Reimport Cluster in the Spot API to trigger the auto-update process manually.

Example:

  1. Make a change in the GKE configuration.
  2. Manually trigger the auto-update process.
  3. Manually trigger a roll.

You will immediately see your changes in the relevant Ocean cluster or virtual node group configurations.