This page describes how to update the admin node image type. This affects the osImageType field in the admin cluster configuration file for Google Distributed Cloud.
You can update the admin node image type with the gkectl update admin command as described here.
Update the admin node image type to COS
In your admin cluster configuration file, set osImageType to cos
For each of your admin clusters, run gkectl update command:
[[["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-09-04 UTC."],[[["\u003cp\u003eThis guide outlines how to modify the \u003ccode\u003eosImageType\u003c/code\u003e field in the admin cluster configuration file for Google Distributed Cloud.\u003c/p\u003e\n"],["\u003cp\u003eYou can change the admin node image type using the \u003ccode\u003egkectl update admin\u003c/code\u003e command, as described in this documentation.\u003c/p\u003e\n"],["\u003cp\u003eTo update to COS, set the \u003ccode\u003eosImageType\u003c/code\u003e field to \u003ccode\u003ecos\u003c/code\u003e in the admin cluster configuration file and execute the \u003ccode\u003egkectl update admin\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eTo update to Ubuntu, set the \u003ccode\u003eosImageType\u003c/code\u003e field to \u003ccode\u003eubuntu_containerd\u003c/code\u003e in the admin cluster configuration file and run the \u003ccode\u003egkectl update admin\u003c/code\u003e command.\u003c/p\u003e\n"]]],[],null,["# Update admin node image type\n\n\u003cbr /\u003e\n\nThis page describes how to update the admin node image type. This affects the `osImageType` field in the admin cluster configuration file for Google Distributed Cloud.\n\nYou can update the admin node image type with the `gkectl update admin` command as described here.\n\nUpdate the admin node image type to COS\n---------------------------------------\n\n1. In your admin cluster configuration file, set [`osImageType`](/anthos/clusters/docs/on-prem/1.14/how-to/admin-cluster-configuration-file#os-image-type-field) to `cos`\n\n2. For each of your admin clusters, run gkectl update command:\n\n ```\n gkectl update admin --config ADMIN_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG\n ```\n\n \u003cbr /\u003e\n\n Replace:\n - \u003cvar translate=\"no\"\u003eADMIN_CLUSTER_CONFIG\u003c/var\u003e with the path of your admin cluster configuration file.\n\nUpdate the admin node image type to Ubuntu\n------------------------------------------\n\n1. In your admin cluster configuration file, set [`osImageType`](/anthos/clusters/docs/on-prem/1.14/how-to/admin-cluster-configuration-file#os-image-type-field)\n to `ubuntu_containerd`\n\n2. For each of your admin clusters, run gkectl update command:\n\n ```\n gkectl update admin --config ADMIN_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG\n ```\n\n \u003cbr /\u003e\n\n Replace:\n - \u003cvar translate=\"no\"\u003eADMIN_CLUSTER_CONFIG\u003c/var\u003e with the path of your admin cluster configuration file."]]
