Files
rancher-docs/pages-for-subheaders/gke-cluster-configuration.html
T

26 lines
61 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-pages-for-subheaders/gke-cluster-configuration">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v2.3.1">
<title data-rh="true">GKE Cluster Configuration Reference | Rancher</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="http://ranchermanager.docs.rancher.com/pages-for-subheaders/gke-cluster-configuration"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="GKE Cluster Configuration Reference | Rancher"><meta data-rh="true" name="description" content="Changes in Rancher v2.6"><meta data-rh="true" property="og:description" content="Changes in Rancher v2.6"><link data-rh="true" rel="icon" href="/img/favicon.png"><link data-rh="true" rel="canonical" href="http://ranchermanager.docs.rancher.com/pages-for-subheaders/gke-cluster-configuration"><link data-rh="true" rel="alternate" href="http://ranchermanager.docs.rancher.com/pages-for-subheaders/gke-cluster-configuration" hreflang="en"><link data-rh="true" rel="alternate" href="http://ranchermanager.docs.rancher.com/zh/pages-for-subheaders/gke-cluster-configuration" hreflang="zh"><link data-rh="true" rel="alternate" href="http://ranchermanager.docs.rancher.com/pages-for-subheaders/gke-cluster-configuration" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://30NEY6C9UY-dsn.algolia.net" crossorigin="anonymous"><link rel="preconnect" href="https://www.googletagmanager.com">
<script>window.dataLayer=window.dataLayer||[]</script>
<script>!function(e,t,a,n,g){e[n]=e[n]||[],e[n].push({"gtm.start":(new Date).getTime(),event:"gtm.js"});var m=t.getElementsByTagName(a)[0],r=t.createElement(a);r.async=!0,r.src="https://www.googletagmanager.com/gtm.js?id=GTM-57KS2MW",m.parentNode.insertBefore(r,m)}(window,document,"script","dataLayer")</script>
<link rel="search" type="application/opensearchdescription+xml" title="Rancher" href="/opensearch.xml">
<script src="https://cdn.cookielaw.org/scripttemplates/otSDKStub.js" charset="UTF-8" data-domain-script="0f98beb0-fc4c-417d-a42e-564e2cae42d2" async></script>
<script src="/scripts/optanonwrapper.js" async></script><link rel="stylesheet" href="/assets/css/styles.35be4547.css">
<link rel="preload" href="/assets/js/runtime~main.b0c4bb1a.js" as="script">
<link rel="preload" href="/assets/js/main.d8782442.js" as="script">
</head>
<body class="navigation-with-keyboard">
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
<div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/rancher-logo-horiz-color.svg" alt="logo" class="themedImage_ToTc themedImage--light_HNdA"><img src="/img/rancher-logo-horiz-color.svg" alt="logo" class="themedImage_ToTc themedImage--dark_i4oU"></div><b class="navbar__title text--truncate"></b></a><div class="navbar__item dropdown dropdown--hoverable"><a aria-current="page" class="navbar__link active" aria-haspopup="true" aria-expanded="false" role="button" href="/">v2.7</a><ul class="dropdown__menu"><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/pages-for-subheaders/gke-cluster-configuration">v2.7</a></li><li><a class="dropdown__link" href="/v2.6/pages-for-subheaders/gke-cluster-configuration">v2.6</a></li><li><a class="dropdown__link" href="/v2.5/pages-for-subheaders/gke-cluster-configuration">v2.5</a></li><li><a class="dropdown__link" href="/v2.0-v2.4">v2.0-v2.4</a></li><li><a class="dropdown__link" href="/versions">All versions</a></li></ul></div></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link"><svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" class="iconLanguage_nlXk"><path fill="currentColor" d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"></path></svg>English</a><ul class="dropdown__menu"><li><a href="/pages-for-subheaders/gke-cluster-configuration" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/zh/pages-for-subheaders/gke-cluster-configuration" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="zh">简体中文</a></li></ul></div><a href="https://github.com/rancher/rancher-docs" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link navbar__github">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><a href="https://rancher.com" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Rancher Home<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><div class="searchBox_ZlJk"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebarViewport_Xe31"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/">What is Rancher?</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/getting-started/overview">Getting Started</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/pages-for-subheaders/new-user-guides">How-to Guides</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" aria-expanded="true" href="/pages-for-subheaders/best-practices">Reference Guides</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/best-practices">Best Practices</a><button aria-label="Toggle the collapsible sidebar category &#x27;Best Practices&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/rancher-manager-architecture">Rancher Architecture</a><button aria-label="Toggle the collapsible sidebar category &#x27;Rancher Architecture&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" tabindex="0" href="/pages-for-subheaders/cluster-configuration">Cluster Configuration</a><button aria-label="Toggle the collapsible sidebar category &#x27;Cluster Configuration&#x27;" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-3 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" tabindex="0" href="/pages-for-subheaders/rancher-server-configuration">Rancher Server Configuration</a><button aria-label="Toggle the collapsible sidebar category &#x27;Rancher Server Configuration&#x27;" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-4 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration">RKE Cluster Configuration Reference</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-4 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/cluster-configuration/rancher-server-configuration/rke2-cluster-configuration">RKE2 Cluster Configuration Reference</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-4 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/cluster-configuration/rancher-server-configuration/k3s-cluster-configuration">K3s Cluster Configuration Reference</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-4 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/cluster-configuration/rancher-server-configuration/eks-cluster-configuration">EKS Cluster Configuration Reference</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-4 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/cluster-configuration/rancher-server-configuration/aks-cluster-configuration">AKS Cluster Configuration Reference</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-4 menu__list-item"><div class="menu__list-item-collapsible menu__list-item-collapsible--active"><a class="menu__link menu__link--sublist menu__link--active" aria-current="page" aria-expanded="true" tabindex="0" href="/pages-for-subheaders/gke-cluster-configuration">GKE Cluster Configuration</a><button aria-label="Toggle the collapsible sidebar category &#x27;GKE Cluster Configuration&#x27;" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-5 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/cluster-configuration/rancher-server-configuration/gke-cluster-configuration/gke-private-clusters">Private Clusters</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-4 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/use-existing-nodes">Use Existing Nodes</a><button aria-label="Toggle the collapsible sidebar category &#x27;Use Existing Nodes&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-4 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/cluster-configuration/rancher-server-configuration/sync-clusters">Syncing</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-3 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/downstream-cluster-configuration">Downstream Cluster Configuration</a><button aria-label="Toggle the collapsible sidebar category &#x27;Downstream Cluster Configuration&#x27;" type="button" class="clean-btn menu__caret"></button></div></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/single-node-rancher-in-docker">Single-Node Rancher in Docker</a><button aria-label="Toggle the collapsible sidebar category &#x27;Single-Node Rancher in Docker&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/backup-restore-configuration">Backup &amp; Restore Configuration</a><button aria-label="Toggle the collapsible sidebar category &#x27;Backup &amp; Restore Configuration&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/kubernetes-concepts">Kubernetes Concepts</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/monitoring-v2-configuration">Monitoring V2 Configuration</a><button aria-label="Toggle the collapsible sidebar category &#x27;Monitoring V2 Configuration&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/prometheus-federator">Prometheus Federator</a><button aria-label="Toggle the collapsible sidebar category &#x27;Prometheus Federator&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/user-settings">User Settings</a><button aria-label="Toggle the collapsible sidebar category &#x27;User Settings&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/cli-with-rancher">CLI with Rancher</a><button aria-label="Toggle the collapsible sidebar category &#x27;CLI with Rancher&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/about-the-api">About the API</a><button aria-label="Toggle the collapsible sidebar category &#x27;About the API&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/rancher-cluster-tools">Cluster Tools for Logging, Monitoring, and Visibility</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/rancher-project-tools">Project Tools for Logging, Monitoring, and Visibility</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/system-tools">System Tools</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/reference-guides/rke1-template-example-yaml">RKE1 Example YAML</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/pages-for-subheaders/rancher-security">Rancher Security</a><button aria-label="Toggle the collapsible sidebar category &#x27;Rancher Security&#x27;" type="button" class="clean-btn menu__caret"></button></div></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/pages-for-subheaders/cloud-marketplace">Integrations in Rancher</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/faq/general-faq">FAQ</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/troubleshooting/general-troubleshooting">Troubleshooting</a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/contribute-to-rancher">Contributing to Rancher</a></li></ul></nav></div></div></aside><main class="docMainContainer_gTbr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">Reference Guides</span><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/pages-for-subheaders/cluster-configuration"><span itemprop="name">Cluster Configuration</span></a><meta itemprop="position" content="2"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/pages-for-subheaders/rancher-server-configuration"><span itemprop="name">Rancher Server Configuration</span></a><meta itemprop="position" content="3"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">GKE Cluster Configuration</span><meta itemprop="position" content="4"></li></ul></nav><span class="theme-doc-version-badge badge badge--secondary">Version: v2.7</span><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>GKE Cluster Configuration Reference</h1></header><h2 class="anchor anchorWithStickyNavbar_LWe7" id="changes-in-rancher-v26">Changes in Rancher v2.6<a href="#changes-in-rancher-v26" class="hash-link" aria-label="Direct link to Changes in Rancher v2.6" title="Direct link to Changes in Rancher v2.6">​</a></h2><ul><li>Support for additional configuration options:<ul><li>Project network isolation</li><li>Network tags</li></ul></li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="cluster-location">Cluster Location<a href="#cluster-location" class="hash-link" aria-label="Direct link to Cluster Location" title="Direct link to Cluster Location">​</a></h2><table><thead><tr><th>Value</th><th>Description</th></tr></thead><tbody><tr><td>Location Type</td><td>Zonal or Regional. With GKE, you can create a cluster tailored to the availability requirements of your workload and your budget. By default, a cluster&#x27;s nodes run in a single compute zone. When multiple zones are selected, the cluster&#x27;s nodes will span multiple compute zones, while the controlplane is located in a single zone. Regional clusters increase the availability of the controlplane as well. For help choosing the type of cluster availability, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/best-practices/scalability#choosing_a_regional_or_zonal_control_plane" target="_blank" rel="noopener noreferrer">these docs.</a></td></tr><tr><td>Zone</td><td>Each region in Compute engine contains a number of zones. For more information about available regions and zones, refer to <a href="https://cloud.google.com/compute/docs/regions-zones#available" target="_blank" rel="noopener noreferrer">these docs.</a></td></tr><tr><td>Additional Zones</td><td>For zonal clusters, you can select additional zones to create a <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/types-of-clusters#multi-zonal_clusters" target="_blank" rel="noopener noreferrer">multi-zone cluster.</a></td></tr><tr><td>Region</td><td>For <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/types-of-clusters#regional_clusters" target="_blank" rel="noopener noreferrer">regional clusters,</a> you can select a region. For more information about available regions and zones, refer to <a href="https://cloud.google.com/compute/docs/regions-zones#available" target="_blank" rel="noopener noreferrer">this section</a>. The first part of each zone name is the name of the region.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_LWe7" id="cluster-options">Cluster Options<a href="#cluster-options" class="hash-link" aria-label="Direct link to Cluster Options" title="Direct link to Cluster Options">​</a></h2><h3 class="anchor anchorWithStickyNavbar_LWe7" id="kubernetes-version">Kubernetes Version<a href="#kubernetes-version" class="hash-link" aria-label="Direct link to Kubernetes Version" title="Direct link to Kubernetes Version">​</a></h3><p><em>Mutable: yes</em></p><p>For more information on GKE Kubernetes versions, refer to <a href="https://cloud.google.com/kubernetes-engine/versioning" target="_blank" rel="noopener noreferrer">these docs.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="container-address-range">Container Address Range<a href="#container-address-range" class="hash-link" aria-label="Direct link to Container Address Range" title="Direct link to Container Address Range">​</a></h3><p><em>Mutable: no</em></p><p>The IP address range for pods in the cluster. Must be a valid CIDR range, e.g. 10.42.0.0/16. If not specified, a random range is automatically chosen from 10.0.0.0/8 and will exclude ranges already allocated to VMs, other clusters, or routes. Automatically chosen ranges may conflict with reserved IP addresses, dynamic routes, or routes within VPCs peering with the cluster.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="network">Network<a href="#network" class="hash-link" aria-label="Direct link to Network" title="Direct link to Network">​</a></h3><p><em>Mutable: no</em></p><p>The Compute Engine Network that the cluster connects to. Routes and firewalls will be created using this network. If using <a href="https://cloud.google.com/vpc/docs/shared-vpc" target="_blank" rel="noopener noreferrer">Shared VPCs</a>, the VPC networks that are shared to your project will appear here. will be available to select in this field. For more information, refer to <a href="https://cloud.google.com/vpc/docs/vpc#vpc_networks_and_subnets" target="_blank" rel="noopener noreferrer">this page</a>.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="node-subnet--subnet">Node Subnet / Subnet<a href="#node-subnet--subnet" class="hash-link" aria-label="Direct link to Node Subnet / Subnet" title="Direct link to Node Subnet / Subnet">​</a></h3><p><em>Mutable: no</em></p><p>The Compute Engine subnetwork that the cluster connects to. This subnetwork must belong to the network specified in the <strong>Network</strong> field. Select an existing subnetwork, or select &quot;Auto Create Subnetwork&quot; to have one automatically created. If not using an existing network, <strong>Subnetwork Name</strong> is required to generate one. If using <a href="https://cloud.google.com/vpc/docs/shared-vpc" target="_blank" rel="noopener noreferrer">Shared VPCs</a>, the VPC subnets that are shared to your project will appear here. If using a Shared VPC network, you cannot select &quot;Auto Create Subnetwork&quot;. For more information, refer to <a href="https://cloud.google.com/vpc/docs/vpc#vpc_networks_and_subnets" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="subnetwork-name">Subnetwork Name<a href="#subnetwork-name" class="hash-link" aria-label="Direct link to Subnetwork Name" title="Direct link to Subnetwork Name">​</a></h3><p><em>Mutable: no</em></p><p>Automatically create a subnetwork with the provided name. Required if &quot;Auto Create Subnetwork&quot; is selected for <strong>Node Subnet</strong> or <strong>Subnet</strong>. For more information on subnetworks, refer to <a href="https://cloud.google.com/vpc/docs/vpc#vpc_networks_and_subnets" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="ip-aliases">Ip Aliases<a href="#ip-aliases" class="hash-link" aria-label="Direct link to Ip Aliases" title="Direct link to Ip Aliases">​</a></h3><p><em>Mutable: no</em></p><p>Enable <a href="https://cloud.google.com/vpc/docs/alias-ip" target="_blank" rel="noopener noreferrer">alias IPs</a>. This enables VPC-native traffic routing. Required if using <a href="https://cloud.google.com/vpc/docs/shared-vpc" target="_blank" rel="noopener noreferrer">Shared VPCs</a>.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="network-policy">Network Policy<a href="#network-policy" class="hash-link" aria-label="Direct link to Network Policy" title="Direct link to Network Policy">​</a></h3><p><em>Mutable: yes</em></p><p>Enable network policy enforcement on the cluster. A network policy defines the level of communication that can occur between pods and services in the cluster. For more information, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/how-to/network-policy" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="project-network-isolation">Project Network Isolation<a href="#project-network-isolation" class="hash-link" aria-label="Direct link to Project Network Isolation" title="Direct link to Project Network Isolation">​</a></h3><p><em>Mutable: yes</em></p><p>choose whether to enable or disable inter-project communication. Note that enabling Project Network Isolation will automatically enable Network Policy and Network Policy Config, but not vice versa.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="node-ipv4-cidr-block">Node Ipv4 CIDR Block<a href="#node-ipv4-cidr-block" class="hash-link" aria-label="Direct link to Node Ipv4 CIDR Block" title="Direct link to Node Ipv4 CIDR Block">​</a></h3><p><em>Mutable: no</em></p><p>The IP address range of the instance IPs in this cluster. Can be set if &quot;Auto Create Subnetwork&quot; is selected for <strong>Node Subnet</strong> or <strong>Subnet</strong>. Must be a valid CIDR range, e.g. 10.96.0.0/14. For more information on how to determine the IP address range, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/alias-ips#cluster_sizing" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="cluster-secondary-range-name">Cluster Secondary Range Name<a href="#cluster-secondary-range-name" class="hash-link" aria-label="Direct link to Cluster Secondary Range Name" title="Direct link to Cluster Secondary Range Name">​</a></h3><p><em>Mutable: no</em></p><p>The name of an existing secondary range for Pod IP addresses. If selected, <strong>Cluster Pod Address Range</strong> will automatically be populated. Required if using a Shared VPC network.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="cluster-pod-address-range">Cluster Pod Address Range<a href="#cluster-pod-address-range" class="hash-link" aria-label="Direct link to Cluster Pod Address Range" title="Direct link to Cluster Pod Address Range">​</a></h3><p><em>Mutable: no</em></p><p>The IP address range assigned to pods in the cluster. Must be a valid CIDR range, e.g. 10.96.0.0/11. If not provided, will be created automatically. Must be provided if using a Shared VPC network. For more information on how to determine the IP address range for your pods, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/alias-ips#cluster_sizing_secondary_range_pods" target="_blank" rel="noopener noreferrer">this section.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="services-secondary-range-name">Services Secondary Range Name<a href="#services-secondary-range-name" class="hash-link" aria-label="Direct link to Services Secondary Range Name" title="Direct link to Services Secondary Range Name">​</a></h3><p><em>Mutable: no</em></p><p>The name of an existing secondary range for service IP addresses. If selected, <strong>Service Address Range</strong> will be automatically populated. Required if using a Shared VPC network.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="service-address-range">Service Address Range<a href="#service-address-range" class="hash-link" aria-label="Direct link to Service Address Range" title="Direct link to Service Address Range">​</a></h3><p><em>Mutable: no</em></p><p>The address range assigned to the services in the cluster. Must be a valid CIDR range, e.g. 10.94.0.0/18. If not provided, will be created automatically. Must be provided if using a Shared VPC network. For more information on how to determine the IP address range for your services, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/alias-ips#cluster_sizing_secondary_range_svcs" target="_blank" rel="noopener noreferrer">this section.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="private-cluster">Private Cluster<a href="#private-cluster" class="hash-link" aria-label="Direct link to Private Cluster" title="Direct link to Private Cluster">​</a></h3><p><em>Mutable: no</em></p><div class="theme-admonition theme-admonition-caution alert alert--warning admonition_LlT9"><div class="admonitionHeading_tbUL"><span class="admonitionIcon_kALy"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>caution</div><div class="admonitionContent_S0QG"><p>Private clusters require additional planning and configuration outside of Rancher. Refer to the <a href="/reference-guides/cluster-configuration/rancher-server-configuration/gke-cluster-configuration/gke-private-clusters">private cluster guide</a>.</p></div></div><p>Assign nodes only internal IP addresses. Private cluster nodes cannot access the public internet unless additional networking steps are taken in GCP.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="enable-private-endpoint">Enable Private Endpoint<a href="#enable-private-endpoint" class="hash-link" aria-label="Direct link to Enable Private Endpoint" title="Direct link to Enable Private Endpoint">​</a></h3><div class="theme-admonition theme-admonition-caution alert alert--warning admonition_LlT9"><div class="admonitionHeading_tbUL"><span class="admonitionIcon_kALy"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>caution</div><div class="admonitionContent_S0QG"><p>Private clusters require additional planning and configuration outside of Rancher. Refer to the <a href="/reference-guides/cluster-configuration/rancher-server-configuration/gke-cluster-configuration/gke-private-clusters">private cluster guide</a>.</p></div></div><p><em>Mutable: no</em></p><p>Locks down external access to the control plane endpoint. Only available if <strong>Private Cluster</strong> is also selected. If selected, and if Rancher does not have direct access to the Virtual Private Cloud network the cluster is running in, Rancher will provide a registration command to run on the cluster to enable Rancher to connect to it.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="master-ipv4-cidr-block">Master IPV4 CIDR Block<a href="#master-ipv4-cidr-block" class="hash-link" aria-label="Direct link to Master IPV4 CIDR Block" title="Direct link to Master IPV4 CIDR Block">​</a></h3><p><em>Mutable: no</em></p><p>The IP range for the control plane VPC.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="master-authorized-network">Master Authorized Network<a href="#master-authorized-network" class="hash-link" aria-label="Direct link to Master Authorized Network" title="Direct link to Master Authorized Network">​</a></h3><p><em>Mutable: yes</em></p><p>Enable control plane authorized networks to block untrusted non-GCP source IPs from accessing the Kubernetes master through HTTPS. If selected, additional authorized networks may be added. If the cluster is created with a public endpoint, this option is useful for locking down access to the public endpoint to only certain networks, such as the network where your Rancher service is running. If the cluster only has a private endpoint, this setting is required.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="additional-options">Additional Options<a href="#additional-options" class="hash-link" aria-label="Direct link to Additional Options" title="Direct link to Additional Options">​</a></h2><h3 class="anchor anchorWithStickyNavbar_LWe7" id="cluster-addons">Cluster Addons<a href="#cluster-addons" class="hash-link" aria-label="Direct link to Cluster Addons" title="Direct link to Cluster Addons">​</a></h3><p>Additional Kubernetes cluster components. For more information, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters#Cluster.AddonsConfig" target="_blank" rel="noopener noreferrer">this page.</a></p><h4 class="anchor anchorWithStickyNavbar_LWe7" id="horizontal-pod-autoscaling">Horizontal Pod Autoscaling<a href="#horizontal-pod-autoscaling" class="hash-link" aria-label="Direct link to Horizontal Pod Autoscaling" title="Direct link to Horizontal Pod Autoscaling">​</a></h4><p><em>Mutable: yes</em></p><p>The Horizontal Pod Autoscaler changes the shape of your Kubernetes workload by automatically increasing or decreasing the number of Pods in response to the workload&#x27;s CPU or memory consumption, or in response to custom metrics reported from within Kubernetes or external metrics from sources outside of your cluster. For more information, see <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/horizontalpodautoscaler" target="_blank" rel="noopener noreferrer">this page.</a></p><h4 class="anchor anchorWithStickyNavbar_LWe7" id="http-l7-load-balancing">HTTP (L7) Load Balancing<a href="#http-l7-load-balancing" class="hash-link" aria-label="Direct link to HTTP (L7) Load Balancing" title="Direct link to HTTP (L7) Load Balancing">​</a></h4><p><em>Mutable: yes</em></p><p>HTTP (L7) Load Balancing distributes HTTP and HTTPS traffic to backends hosted on GKE. For more information, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/tutorials/http-balancer" target="_blank" rel="noopener noreferrer">this page.</a></p><h4 class="anchor anchorWithStickyNavbar_LWe7" id="network-policy-config-master-only">Network Policy Config (master only)<a href="#network-policy-config-master-only" class="hash-link" aria-label="Direct link to Network Policy Config (master only)" title="Direct link to Network Policy Config (master only)">​</a></h4><p><em>Mutable: yes</em></p><p>Configuration for NetworkPolicy. This only tracks whether the addon is enabled or not on the master, it does not track whether network policy is enabled for the nodes.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="cluster-features-alpha-features">Cluster Features (Alpha Features)<a href="#cluster-features-alpha-features" class="hash-link" aria-label="Direct link to Cluster Features (Alpha Features)" title="Direct link to Cluster Features (Alpha Features)">​</a></h3><p><em>Mutable: no</em></p><p>Turns on all Kubernetes alpha API groups and features for the cluster. When enabled, the cluster cannot be upgraded and will be deleted automatically after 30 days. Alpha clusters are not recommended for production use as they are not covered by the GKE SLA. For more information, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/alpha-clusters" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="logging-service">Logging Service<a href="#logging-service" class="hash-link" aria-label="Direct link to Logging Service" title="Direct link to Logging Service">​</a></h3><p><em>Mutable: yes</em></p><p>The logging service the cluster uses to write logs. Use either <a href="https://cloud.google.com/logging" target="_blank" rel="noopener noreferrer">Cloud Logging</a> or no logging service in which case no logs are exported from the cluster.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="monitoring-service">Monitoring Service<a href="#monitoring-service" class="hash-link" aria-label="Direct link to Monitoring Service" title="Direct link to Monitoring Service">​</a></h3><p><em>Mutable: yes</em></p><p>The monitoring service the cluster uses to write metrics. Use either <a href="https://cloud.google.com/monitoring" target="_blank" rel="noopener noreferrer">Cloud Monitoring</a> or monitoring service in which case no metrics are exported from the cluster.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="maintenance-window">Maintenance Window<a href="#maintenance-window" class="hash-link" aria-label="Direct link to Maintenance Window" title="Direct link to Maintenance Window">​</a></h3><p><em>Mutable: yes</em></p><p>Set the start time for a 4 hour maintenance window. The time is specified in the UTC time zone using the HH:MM format. For more information, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions" target="_blank" rel="noopener noreferrer">this page.</a></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="node-pools">Node Pools<a href="#node-pools" class="hash-link" aria-label="Direct link to Node Pools" title="Direct link to Node Pools">​</a></h2><p>In this section, enter details describing the configuration of each node in the node pool.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="kubernetes-version-1">Kubernetes Version<a href="#kubernetes-version-1" class="hash-link" aria-label="Direct link to Kubernetes Version" title="Direct link to Kubernetes Version">​</a></h3><p><em>Mutable: yes</em></p><p>The Kubernetes version for each node in the node pool. For more information on GKE Kubernetes versions, refer to <a href="https://cloud.google.com/kubernetes-engine/versioning" target="_blank" rel="noopener noreferrer">these docs.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="image-type">Image Type<a href="#image-type" class="hash-link" aria-label="Direct link to Image Type" title="Direct link to Image Type">​</a></h3><p><em>Mutable: yes</em></p><p>The node operating system image. For more information for the node image options that GKE offers for each OS, refer to <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/node-images#available_node_images" target="_blank" rel="noopener noreferrer">this page.</a></p><div class="theme-admonition theme-admonition-note alert alert--secondary admonition_LlT9"><div class="admonitionHeading_tbUL"><span class="admonitionIcon_kALy"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_S0QG"><p>The default option is &quot;Container-Optimized OS with Docker&quot;. The read-only filesystem on GCP&#x27;s Container-Optimized OS is not compatible with the <a href="/v2.0-v2.4/pages-for-subheaders/cluster-logging">legacy logging</a> implementation in Rancher. If you need to use the legacy logging feature, select &quot;Ubuntu with Docker&quot; or &quot;Ubuntu with Containerd&quot;. The <a href="/pages-for-subheaders/logging">current logging feature</a> is compatible with the Container-Optimized OS image.</p></div></div><div class="theme-admonition theme-admonition-note alert alert--secondary admonition_LlT9"><div class="admonitionHeading_tbUL"><span class="admonitionIcon_kALy"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_S0QG"><p>If selecting &quot;Windows Long Term Service Channel&quot; or &quot;Windows Semi-Annual Channel&quot; for the node pool image type, you must also add at least one Container-Optimized OS or Ubuntu node pool.</p></div></div><h3 class="anchor anchorWithStickyNavbar_LWe7" id="machine-type">Machine Type<a href="#machine-type" class="hash-link" aria-label="Direct link to Machine Type" title="Direct link to Machine Type">​</a></h3><p><em>Mutable: no</em></p><p>The virtualized hardware resources available to node instances. For more information on Google Cloud machine types, refer to <a href="https://cloud.google.com/compute/docs/machine-types#machine_types" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="root-disk-type">Root Disk Type<a href="#root-disk-type" class="hash-link" aria-label="Direct link to Root Disk Type" title="Direct link to Root Disk Type">​</a></h3><p><em>Mutable: no</em></p><p>Standard persistent disks are backed by standard hard disk drives (HDD), while SSD persistent disks are backed by solid state drives (SSD). For more information, refer to <a href="https://cloud.google.com/compute/docs/disks" target="_blank" rel="noopener noreferrer">this section.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="local-ssd-disks">Local SSD Disks<a href="#local-ssd-disks" class="hash-link" aria-label="Direct link to Local SSD Disks" title="Direct link to Local SSD Disks">​</a></h3><p><em>Mutable: no</em></p><p>Configure each node&#x27;s local SSD disk storage in GB. Local SSDs are physically attached to the server that hosts your VM instance. Local SSDs have higher throughput and lower latency than standard persistent disks or SSD persistent disks. The data that you store on a local SSD persists only until the instance is stopped or deleted. For more information, see <a href="https://cloud.google.com/compute/docs/disks#localssds" target="_blank" rel="noopener noreferrer">this section.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="preemptible-nodes-beta">Preemptible nodes (beta)<a href="#preemptible-nodes-beta" class="hash-link" aria-label="Direct link to Preemptible nodes (beta)" title="Direct link to Preemptible nodes (beta)">​</a></h3><p><em>Mutable: no</em></p><p>Preemptible nodes, also called preemptible VMs, are Compute Engine VM instances that last a maximum of 24 hours in general, and provide no availability guarantees. For more information, see <a href="https://cloud.google.com/kubernetes-engine/docs/how-to/preemptible-vms" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="taints">Taints<a href="#taints" class="hash-link" aria-label="Direct link to Taints" title="Direct link to Taints">​</a></h3><p><em>Mutable: no</em></p><p>When you apply a taint to a node, only Pods that tolerate the taint are allowed to run on the node. In a GKE cluster, you can apply a taint to a node pool, which applies the taint to all nodes in the pool.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="node-labels">Node Labels<a href="#node-labels" class="hash-link" aria-label="Direct link to Node Labels" title="Direct link to Node Labels">​</a></h3><p><em>Mutable: no</em></p><p>You can apply labels to the node pool, which applies the labels to all nodes in the pool.</p><p>Invalid labels can prevent upgrades or can prevent Rancher from starting. For details on label syntax requirements, see the <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set" target="_blank" rel="noopener noreferrer">Kubernetes documentation.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="network-tags">Network Tags<a href="#network-tags" class="hash-link" aria-label="Direct link to Network Tags" title="Direct link to Network Tags">​</a></h3><p><em>Mutable: no</em></p><p>You can add network tags to the node pool to make firewall rules and routes between subnets. Tags will apply to all nodes in the pool.</p><p>For details on tag syntax and requirements, see the <a href="https://cloud.google.com/vpc/docs/add-remove-network-tags" target="_blank" rel="noopener noreferrer">Kubernetes documentation</a>.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="group-details">Group Details<a href="#group-details" class="hash-link" aria-label="Direct link to Group Details" title="Direct link to Group Details">​</a></h2><p>In this section, enter details describing the node pool.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="name">Name<a href="#name" class="hash-link" aria-label="Direct link to Name" title="Direct link to Name">​</a></h3><p><em>Mutable: no</em></p><p>Enter a name for the node pool.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="initial-node-count">Initial Node Count<a href="#initial-node-count" class="hash-link" aria-label="Direct link to Initial Node Count" title="Direct link to Initial Node Count">​</a></h3><p><em>Mutable: yes</em></p><p>Integer for the starting number of nodes in the node pool.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="max-pod-per-node">Max Pod Per Node<a href="#max-pod-per-node" class="hash-link" aria-label="Direct link to Max Pod Per Node" title="Direct link to Max Pod Per Node">​</a></h3><p><em>Mutable: no</em></p><p>GKE has a hard limit of 110 Pods per node. For more information on the Kubernetes limits, see <a href="https://cloud.google.com/kubernetes-engine/docs/best-practices/scalability#dimension_limits" target="_blank" rel="noopener noreferrer">this section.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="autoscaling">Autoscaling<a href="#autoscaling" class="hash-link" aria-label="Direct link to Autoscaling" title="Direct link to Autoscaling">​</a></h3><p><em>Mutable: yes</em></p><p>Node pool autoscaling dynamically creates or deletes nodes based on the demands of your workload. For more information, see <a href="https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-autoscaler" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="auto-repair">Auto Repair<a href="#auto-repair" class="hash-link" aria-label="Direct link to Auto Repair" title="Direct link to Auto Repair">​</a></h3><p><em>Mutable: yes</em></p><p>GKE&#x27;s node auto-repair feature helps you keep the nodes in your cluster in a healthy, running state. When enabled, GKE makes periodic checks on the health state of each node in your cluster. If a node fails consecutive health checks over an extended time period, GKE initiates a repair process for that node. For more information, see the section on <a href="https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-repair" target="_blank" rel="noopener noreferrer">auto-repairing nodes.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="auto-upgrade">Auto Upgrade<a href="#auto-upgrade" class="hash-link" aria-label="Direct link to Auto Upgrade" title="Direct link to Auto Upgrade">​</a></h3><p><em>Mutable: yes</em></p><p>When enabled, the auto-upgrade feature keeps the nodes in your cluster up-to-date with the cluster control plane (master) version when your control plane is <a href="https://cloud.google.com/kubernetes-engine/upgrades#automatic_cp_upgrades" target="_blank" rel="noopener noreferrer">updated on your behalf.</a> For more information about auto-upgrading nodes, see <a href="https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-upgrades" target="_blank" rel="noopener noreferrer">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="access-scopes">Access Scopes<a href="#access-scopes" class="hash-link" aria-label="Direct link to Access Scopes" title="Direct link to Access Scopes">​</a></h3><p><em>Mutable: no</em></p><p>Access scopes are the legacy method of specifying permissions for your nodes.</p><ul><li><strong>Allow default access:</strong> The default access for new clusters is the <a href="https://cloud.google.com/compute/docs/access/service-accounts?hl=en_US#default_service_account" target="_blank" rel="noopener noreferrer">Compute Engine default service account.</a></li><li><strong>Allow full access to all Cloud APIs:</strong> Generally, you can just set the cloud-platform access scope to allow full access to all Cloud APIs, then grant the service account only relevant IAM roles. The combination of access scopes granted to the virtual machine instance and the IAM roles granted to the service account determines the amount of access the service account has for that instance.</li><li><strong>Set access for each API:</strong> Alternatively, you can choose to set specific scopes that permit access to the particular API methods that the service will call.</li></ul><p>For more information, see the <a href="https://cloud.google.com/compute/docs/access/create-enable-service-accounts-for-instances" target="_blank" rel="noopener noreferrer">section about enabling service accounts for a VM.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="configuring-the-refresh-interval">Configuring the Refresh Interval<a href="#configuring-the-refresh-interval" class="hash-link" aria-label="Direct link to Configuring the Refresh Interval" title="Direct link to Configuring the Refresh Interval">​</a></h3><p>The refresh interval can be configured through the setting &quot;gke-refresh&quot;, which is an integer representing seconds.</p><p>The default value is 300 seconds.</p><p>The syncing interval can be changed by running <code>kubectl edit setting gke-refresh</code>.</p><p>The shorter the refresh window, the less likely any race conditions will occur, but it does increase the likelihood of encountering request limits that may be in place for GCP APIs.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/rancher/rancher-docs/edit/main/docs/pages-for-subheaders/gke-cluster-configuration.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"><span class="theme-last-updated">Last updated<!-- --> on <b><time datetime="2022-10-29T00:09:06.000Z">Oct 29, 2022</time></b></span></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages navigation"><a class="pagination-nav__link pagination-nav__link--prev" href="/reference-guides/cluster-configuration/rancher-server-configuration/aks-cluster-configuration"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">AKS Cluster Configuration Reference</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/reference-guides/cluster-configuration/rancher-server-configuration/gke-cluster-configuration/gke-private-clusters"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Private Clusters</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#changes-in-rancher-v26" class="table-of-contents__link toc-highlight">Changes in Rancher v2.6</a></li><li><a href="#cluster-location" class="table-of-contents__link toc-highlight">Cluster Location</a></li><li><a href="#cluster-options" class="table-of-contents__link toc-highlight">Cluster Options</a><ul><li><a href="#kubernetes-version" class="table-of-contents__link toc-highlight">Kubernetes Version</a></li><li><a href="#container-address-range" class="table-of-contents__link toc-highlight">Container Address Range</a></li><li><a href="#network" class="table-of-contents__link toc-highlight">Network</a></li><li><a href="#node-subnet--subnet" class="table-of-contents__link toc-highlight">Node Subnet / Subnet</a></li><li><a href="#subnetwork-name" class="table-of-contents__link toc-highlight">Subnetwork Name</a></li><li><a href="#ip-aliases" class="table-of-contents__link toc-highlight">Ip Aliases</a></li><li><a href="#network-policy" class="table-of-contents__link toc-highlight">Network Policy</a></li><li><a href="#project-network-isolation" class="table-of-contents__link toc-highlight">Project Network Isolation</a></li><li><a href="#node-ipv4-cidr-block" class="table-of-contents__link toc-highlight">Node Ipv4 CIDR Block</a></li><li><a href="#cluster-secondary-range-name" class="table-of-contents__link toc-highlight">Cluster Secondary Range Name</a></li><li><a href="#cluster-pod-address-range" class="table-of-contents__link toc-highlight">Cluster Pod Address Range</a></li><li><a href="#services-secondary-range-name" class="table-of-contents__link toc-highlight">Services Secondary Range Name</a></li><li><a href="#service-address-range" class="table-of-contents__link toc-highlight">Service Address Range</a></li><li><a href="#private-cluster" class="table-of-contents__link toc-highlight">Private Cluster</a></li><li><a href="#enable-private-endpoint" class="table-of-contents__link toc-highlight">Enable Private Endpoint</a></li><li><a href="#master-ipv4-cidr-block" class="table-of-contents__link toc-highlight">Master IPV4 CIDR Block</a></li><li><a href="#master-authorized-network" class="table-of-contents__link toc-highlight">Master Authorized Network</a></li></ul></li><li><a href="#additional-options" class="table-of-contents__link toc-highlight">Additional Options</a><ul><li><a href="#cluster-addons" class="table-of-contents__link toc-highlight">Cluster Addons</a></li><li><a href="#cluster-features-alpha-features" class="table-of-contents__link toc-highlight">Cluster Features (Alpha Features)</a></li><li><a href="#logging-service" class="table-of-contents__link toc-highlight">Logging Service</a></li><li><a href="#monitoring-service" class="table-of-contents__link toc-highlight">Monitoring Service</a></li><li><a href="#maintenance-window" class="table-of-contents__link toc-highlight">Maintenance Window</a></li></ul></li><li><a href="#node-pools" class="table-of-contents__link toc-highlight">Node Pools</a><ul><li><a href="#kubernetes-version-1" class="table-of-contents__link toc-highlight">Kubernetes Version</a></li><li><a href="#image-type" class="table-of-contents__link toc-highlight">Image Type</a></li><li><a href="#machine-type" class="table-of-contents__link toc-highlight">Machine Type</a></li><li><a href="#root-disk-type" class="table-of-contents__link toc-highlight">Root Disk Type</a></li><li><a href="#local-ssd-disks" class="table-of-contents__link toc-highlight">Local SSD Disks</a></li><li><a href="#preemptible-nodes-beta" class="table-of-contents__link toc-highlight">Preemptible nodes (beta)</a></li><li><a href="#taints" class="table-of-contents__link toc-highlight">Taints</a></li><li><a href="#node-labels" class="table-of-contents__link toc-highlight">Node Labels</a></li><li><a href="#network-tags" class="table-of-contents__link toc-highlight">Network Tags</a></li></ul></li><li><a href="#group-details" class="table-of-contents__link toc-highlight">Group Details</a><ul><li><a href="#name" class="table-of-contents__link toc-highlight">Name</a></li><li><a href="#initial-node-count" class="table-of-contents__link toc-highlight">Initial Node Count</a></li><li><a href="#max-pod-per-node" class="table-of-contents__link toc-highlight">Max Pod Per Node</a></li><li><a href="#autoscaling" class="table-of-contents__link toc-highlight">Autoscaling</a></li><li><a href="#auto-repair" class="table-of-contents__link toc-highlight">Auto Repair</a></li><li><a href="#auto-upgrade" class="table-of-contents__link toc-highlight">Auto Upgrade</a></li><li><a href="#access-scopes" class="table-of-contents__link toc-highlight">Access Scopes</a></li><li><a href="#configuring-the-refresh-interval" class="table-of-contents__link toc-highlight">Configuring the Refresh Interval</a></li></ul></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2023 SUSE Rancher. All Rights Reserved.</div></div></div></footer></div>
<script src="/assets/js/runtime~main.b0c4bb1a.js"></script>
<script src="/assets/js/main.d8782442.js"></script>
</body>
</html>