Stay organized with collections
Save and categorize content based on your preferences.
This document describes the two versions of configuration files use in
Google Distributed Cloud.
In Google Distributed Cloud version 1.4, the configuration files changed
substantially. The new files are called v1 configuration files.
The configuration files that were used in Google Distributed Cloud versions
earlier than 1.4 are called v0 configuration files.
As of version 1.7 of Google Distributed Cloud, the v0 configuration files
are no longer supported.
Converting configuration files
To convert a v0 configuration file to a v1 admin cluster configuration file:
[OLD_CONFIG_PATH] is the path of your v0 configuration file.
[OUTPUT_PATH] is a path of your choice for the generated
v1 admin cluster configuration file. If you omit this flag, gkectl names the
file admin-cluster.yaml and puts it in the current directory.
To convert a v0 configuration file to a v1 user cluster configuration file:
[OLD_CONFIG_PATH] is the path of your v0 configuration file.
[OUTPUT_PATH] is a path of your choice for the generated
v1 user cluster configuration file. If you omit this flag, gkectl names the
file user-cluster.yaml and puts it in the current directory.
[[["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-29 UTC."],[[["\u003cp\u003eGoogle Distributed Cloud utilizes two versions of configuration files: v0 (used before version 1.4) and v1 (introduced in version 1.4).\u003c/p\u003e\n"],["\u003cp\u003eAs of Google Distributed Cloud version 1.7, v0 configuration files are no longer supported.\u003c/p\u003e\n"],["\u003cp\u003eYou can convert a v0 configuration file to a v1 admin cluster configuration file using the command \u003ccode\u003egkectl create-config admin --from [OLD_CONFIG_PATH] --config [OUTPUT_PATH]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can convert a v0 configuration file to a v1 user cluster configuration file using the command \u003ccode\u003egkectl create-config cluster --from [OLD_CONFIG_PATH] --config [OUTPUT_PATH]\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Old cluster configuration file\n\nThis document describes the two versions of configuration files use in\nGoogle Distributed Cloud.\n\nIn Google Distributed Cloud version 1.4, the configuration files changed\nsubstantially. The new files are called v1 configuration files.\nThe configuration files that were used in Google Distributed Cloud versions\nearlier than 1.4 are called v0 configuration files.\n\nAs of version 1.7 of Google Distributed Cloud, the v0 configuration files\nare no longer supported.\n\nConverting configuration files\n------------------------------\n\nTo convert a v0 configuration file to a v1 admin cluster configuration file: \n\n```\ngkectl create-config admin --from [OLD_CONFIG_PATH] --config [OUTPUT_PATH]\n```\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003e[OLD_CONFIG_PATH]\u003c/var\u003e is the path of your v0 configuration file.\n\n- \u003cvar translate=\"no\"\u003e[OUTPUT_PATH]\u003c/var\u003e is a path of your choice for the generated\n v1 admin cluster configuration file. If you omit this flag, `gkectl` names the\n file `admin-cluster.yaml` and puts it in the current directory.\n\nTo convert a v0 configuration file to a v1 user cluster configuration file: \n\n```\ngkectl create-config cluster --from [OLD_CONFIG_PATH] --config [OUTPUT_PATH]\n```\n\n- \u003cvar translate=\"no\"\u003e[OLD_CONFIG_PATH]\u003c/var\u003e is the path of your v0 configuration file.\n\n- \u003cvar translate=\"no\"\u003e[OUTPUT_PATH]\u003c/var\u003e is a path of your choice for the generated\n v1 user cluster configuration file. If you omit this flag, `gkectl` names the\n file `user-cluster.yaml` and puts it in the current directory."]]
