Stay organized with collections Save and categorize content based on your preferences.
On Compute Engine you can manage the operating systems that are running on your virtual machines (VMs) by using VM Manager.
This page describes how to upgrade an existing setup of VM Manager. Google recommends that you use the latest version of the agent.
Before you beginInstall the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Note: If you installed the gcloud CLI previously, make sure you have the latest version by runninggcloud components update
.To update your VM Manager setup, complete the following steps:
20201110
or later20210427
or later.If you have OS inventory management (earlier version) running on your VMs, you can check the OS Config agent version by running the following command:
gcloud compute instances os-inventory describe VM-NAME \ --zone=ZONE
Replace the following:
VM-NAME
: the name of your VMZONE
: the zone where the VM is locatedIn the output, search for OSConfigAgentVersion
.
OSConfigAgentVersion: 20210316.00-g1
In the preceding output snippet, the OS Config agent version is dated 20210316
(2021-03-16).
To update the OS Config agent, do one of the following:
One method of updating the OS Config agent is to update the package for your operating system.
CentOS/RHEL/RockyTo update the agent on CentOS, Rocky Linux, and RHEL operating systems, run the following command:
sudo yum update google-osconfig-agentDebian
To update the agent on Debian operating systems, run the following commands:
sudo apt update sudo apt install google-osconfig-agentSLES
To update the agent on SLES, run the following command:
sudo zypper -n update google-osconfig-agentNote: The package repository available from SUSE Linux Enterprise Server (SLES) might not have the latest OS Config agent available.
To update the agent on SLES VMs, you can also do a reinstall of the agent using the Google-provided packages. To do an install using Google-provided packages, see Install the OS Config agent.
UbuntuTo update the agent on Ubuntu operating systems, run the following commands:
sudo apt update sudo apt install google-osconfig-agentNote: The package repository available from Ubuntu might not have the latest OS Config agent available.
To update the agent on Ubuntu VMs, we recommend that you do a reinstall of the agent using the Google-provided packages. To do an install using Google-provided packages, see Install the OS Config agent.
WindowsTo update the agent on Windows operating systems, run the following command:
googet install google-osconfig-agentRun a patch job
Another method of updating the OS Config agent is by running a patch job and specifying the exclusive_packages
flag. This patch job only updates the OS Config agent on the target VMs.
To set the target VMs, you need to specify an INSTANCE_FILTER
. For more information about instance filters, see instance filters.
To update the agent for CentOS, Rocky Linux and RHEL VMs, run the following command:
gcloud compute os-config patch-jobs execute INSTANCE_FILTER \ --yum-exclusive-packages=google-osconfig-agentDebian
To update the agent for Debian VMs, run the following commands:
gcloud compute os-config patch-jobs execute INSTANCE_FILTER \ --apt-exclusive-packages=google-osconfig-agentSLES
To update the agent for SLES VMs, run the following command:
gcloud compute os-config patch-jobs execute INSTANCE_FILTER \ --zypper-exclusive-patches=google-osconfig-agentNote: The package repository available from SUSE Linux Enterprise Server (SLES) might not have the latest OS Config agent available.
To update the agent on SLES VMs, you can also do a reinstall of the agent using the Google-provided packages. To do an install using Google-provided packages, see Install the OS Config agent.
UbuntuTo update the agent for Ubuntu VMs, run the following commands:
gcloud compute os-config patch-jobs execute INSTANCE_FILTER \ --apt-exclusive-packages=google-osconfig-agentNote: The package repository available from Ubuntu might not have the latest OS Config agent available.
To update the agent on Ubuntu VMs, we recommend that you do a reinstall of the agent using the Google-provided packages. To do an install using Google-provided packages, see Install the OS Config agent.
WindowsTo update the agent for Windows VMs, run the following command:
Note: This command also updates all the Google-provided software on the VM.gcloud compute os-config patch-jobs execute INSTANCE_FILTER \ --windows-exclusive-patches=google-packages
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["This page details how to upgrade an existing VM Manager setup, which Google recommends keeping up-to-date for optimal performance."],["To update the VM Manager, users must first check the current OS Config agent version installed on their VMs."],["The OS Config agent can be updated either by updating the operating system's package directly or by running a patch job."],["Specific commands for updating the OS Config agent are provided for CentOS, RHEL, Rocky Linux, Debian, SLES, Ubuntu, and Windows operating systems."],["Certain OS systems such as SLES and Ubuntu may require a reinstall of the agent using the Google provided packages to have the latest version."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4