Files
rancher-docs/zh/pages-for-subheaders/enable-experimental-features.html
T

26 lines
36 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.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="zh" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-pages-for-subheaders/enable-experimental-features">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v2.3.1">
<title data-rh="true">启用实验功能 | 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="https://ranchermanager.docs.rancher.com/zh/pages-for-subheaders/enable-experimental-features"><meta data-rh="true" name="docusaurus_locale" content="zh"><meta data-rh="true" name="docsearch:language" content="zh"><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="启用实验功能 | Rancher"><meta data-rh="true" name="description" content="Rancher 包含一些默认关闭的实验功能。在某些情况下,例如当你认为使用不支持的存储类型的好处大于使用未经测试的功能的风险时,你可能想要启用实验功能。为了让你能够试用这些默认关闭的功能,我们引入了功能开关(feature flag)。"><meta data-rh="true" property="og:description" content="Rancher 包含一些默认关闭的实验功能。在某些情况下,例如当你认为使用不支持的存储类型的好处大于使用未经测试的功能的风险时,你可能想要启用实验功能。为了让你能够试用这些默认关闭的功能,我们引入了功能开关(feature flag)。"><link data-rh="true" rel="icon" href="/zh/img/favicon.png"><link data-rh="true" rel="canonical" href="https://ranchermanager.docs.rancher.com/zh/pages-for-subheaders/enable-experimental-features"><link data-rh="true" rel="alternate" href="https://ranchermanager.docs.rancher.com/pages-for-subheaders/enable-experimental-features" hreflang="en"><link data-rh="true" rel="alternate" href="https://ranchermanager.docs.rancher.com/zh/pages-for-subheaders/enable-experimental-features" hreflang="zh"><link data-rh="true" rel="alternate" href="https://ranchermanager.docs.rancher.com/pages-for-subheaders/enable-experimental-features" 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="/zh/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="/zh/assets/css/styles.10402cb5.css">
<link rel="preload" href="/zh/assets/js/runtime~main.9a7dea44.js" as="script">
<link rel="preload" href="/zh/assets/js/main.50802f1f.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="跳到主要内容"><a class="skipToContent_fXgn" href="#docusaurus_skipToContent_fallback">跳到主要内容</a></div><nav aria-label="主导航" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="切换导航栏" 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="/zh/"><div class="navbar__logo"><img src="/zh/img/rancher-logo-horiz-color.svg" alt="logo" class="themedImage_ToTc themedImage--light_HNdA"><img src="/zh/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="/zh/">Latest</a><ul class="dropdown__menu"><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/zh/pages-for-subheaders/enable-experimental-features">Latest</a></li><li><a class="dropdown__link" href="/zh/v2.7/pages-for-subheaders/enable-experimental-features">v2.7</a></li><li><a class="dropdown__link" href="/zh/v2.6/pages-for-subheaders/enable-experimental-features">v2.6</a></li><li><a class="dropdown__link" href="/zh/v2.5/pages-for-subheaders/enable-experimental-features">v2.5</a></li><li><a class="dropdown__link" href="/zh/v2.0-v2.4/pages-for-subheaders/enable-experimental-features">v2.0-v2.4</a></li><li><a class="dropdown__link" href="/zh/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>简体中文</a><ul class="dropdown__menu"><li><a href="/pages-for-subheaders/enable-experimental-features" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="en">English</a></li><li><a href="/zh/pages-for-subheaders/enable-experimental-features" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" 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://www.rancher.com" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Rancher 主页<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="搜索"><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">搜索</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="回到顶部" 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="文档侧边栏" 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="/zh/">什么是 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="/zh/getting-started/overview">开始使用</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="/zh/pages-for-subheaders/new-user-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="/zh/pages-for-subheaders/new-user-guides">新用户指南</a><button aria-label="打开/收起侧边栏菜单「新用户指南」" 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="/zh/pages-for-subheaders/advanced-user-guides">高级用户指南</a><button aria-label="打开/收起侧边栏菜单「高级用户指南」" 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 menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/zh/pages-for-subheaders/manage-projects">管理项目</a><button aria-label="打开/收起侧边栏菜单「管理项目」" type="button" class="clean-btn menu__caret"></button></div></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="/zh/pages-for-subheaders/monitoring-alerting-guides">Monitoring/Alerting 指南</a><button aria-label="打开/收起侧边栏菜单「Monitoring/Alerting 指南」" type="button" class="clean-btn menu__caret"></button></div></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="/zh/pages-for-subheaders/monitoring-v2-configuration-guides">Monitoring V2 配置指南</a><button aria-label="打开/收起侧边栏菜单「Monitoring V2 配置指南」" type="button" class="clean-btn menu__caret"></button></div></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="/zh/pages-for-subheaders/istio-setup-guide">Istio 设置指南</a><button aria-label="打开/收起侧边栏菜单「Istio 设置指南」" type="button" class="clean-btn menu__caret"></button></div></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="/zh/pages-for-subheaders/cis-scan-guides">CIS 扫描指南</a><button aria-label="打开/收起侧边栏菜单「CIS 扫描指南」" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-3 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="/zh/pages-for-subheaders/enable-experimental-features">启用实验功能</a><button aria-label="打开/收起侧边栏菜单「启用实验功能」" 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="/zh/how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64">在 ARM64 上运行 Rancher(实验性)</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="/zh/how-to-guides/advanced-user-guides/enable-experimental-features/unsupported-storage-drivers">使用非默认支持的存储驱动</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="/zh/how-to-guides/advanced-user-guides/enable-experimental-features/istio-traffic-management-features">UI 管理 Istio 虚拟服务和目标规则</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="/zh/how-to-guides/advanced-user-guides/enable-experimental-features/continuous-delivery">持续交付</a></li></ul></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/zh/how-to-guides/advanced-user-guides/open-ports-with-firewalld">使用 firewalld 打开端口</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/zh/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs">为大型安装进行 etcd 调优</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/zh/how-to-guides/advanced-user-guides/enable-api-audit-log">启用 API 审计日志以记录系统事件</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/zh/how-to-guides/advanced-user-guides/configure-layer-7-nginx-load-balancer">7 层 NGINX 负载均衡器上的 TLS 终止(Docker 安装)</a></li></ul></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="/zh/pages-for-subheaders/best-practices">参考指南</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="/zh/pages-for-subheaders/cloud-marketplace">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="/zh/faq/general-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="/zh/troubleshooting/general-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="/zh/contribute-to-rancher">参与 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="页面路径"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="主页面" class="breadcrumbs__link" href="/zh/"><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">操作指南</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="/zh/pages-for-subheaders/advanced-user-guides"><span itemprop="name">高级用户指南</span></a><meta itemprop="position" content="2"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">启用实验功能</span><meta itemprop="position" content="3"></li></ul></nav><span class="theme-doc-version-badge badge badge--secondary">版本:Latest</span><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">本页总览</button></div><div class="theme-doc-markdown markdown"><header><h1>启用实验功能</h1></header><p>Rancher 包含一些默认关闭的实验功能。在某些情况下,例如当你认为使用<a href="/zh/how-to-guides/advanced-user-guides/enable-experimental-features/unsupported-storage-drivers">不支持的存储类型</a>的好处大于使用未经测试的功能的风险时,你可能想要启用实验功能。为了让你能够试用这些默认关闭的功能,我们引入了功能开关(feature flag)。</p><p>实验功能可以通过以下三种方式启用:</p><ul><li><a href="#%E5%90%AF%E5%8A%A8-rancher-%E6%97%B6%E5%90%AF%E7%94%A8%E5%8A%9F%E8%83%BD">使用 CLI</a>:在使用 CLI 安装 Rancher 时,使用功能开关默认启用某个功能。</li><li><a href="#%E4%BD%BF%E7%94%A8-rancher-ui-%E5%90%AF%E7%94%A8%E5%8A%9F%E8%83%BD">使用 Rancher UI</a>:在<strong>设置</strong>页面启用功能。</li><li><a href="#%E4%BD%BF%E7%94%A8-rancher-api-%E5%90%AF%E7%94%A8%E5%8A%9F%E8%83%BD">使用 Rancher API</a>:安装 Rancher 后启用功能。</li></ul><p>每个功能均有以下两个值:</p><ul><li>默认值:可以通过在命令行使用标志或环境变量进行配置。</li><li>设置值:可以通过 Rancher API 或 UI 进行配置。</li></ul><p>如果没有设置值,Rancher 会使用默认值。</p><p>设置值是通过 API 设置的,而默认值是通过命令行设置。因此,如果你使用 API 或 UI 启用或禁用某个功能,命令行中设置的值将被覆盖。</p><p>如果你安装 Rancher 后使用 Rancher API 将功能开关设置为 true,然后在使用命令升级 Rancher 时将功能开关设置为 false,在这种情况下,虽然默认值会是 false,但是该功能依然会被启用,因为它是通过 API 设置的。如果你随后使用 Rancher API 删除设置值(true)并将它设置为 NULL,则默认值(false)将生效。有关详细信息,请参阅<a href="/zh/getting-started/installation-and-upgrade/installation-references/feature-flags">功能开关页面</a>。</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="启动-rancher-时启用功能">启动 Rancher 时启用功能<a href="#启动-rancher-时启用功能" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h2><p>安装 Rancher 时,使用功能开关启用你所需的功能。通过单节点容器安装 Rancher,和在 Kubernetes 集群上安装 Rancher 对应的命令有所不同。</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="kubernetes-安装的情况下启用功能">Kubernetes 安装的情况下启用功能<a href="#kubernetes-安装的情况下启用功能" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h3><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>备注</div><div class="admonitionContent_S0QG"><p>通过 Rancher API 设置的值会覆盖命令行传入的值。</p></div></div><p>使用 Helm Chart 安装 Rancher 时,使用 <code>--set</code> 选项。下面的示例通过传递功能开关名称(用逗号分隔)来启用两个功能:</p><p>对于 Kubernetes v1.25 或更高版本,使用 Rancher v2.7.2-v2.7.4 时,将 <code>global.cattle.psp.enabled</code> 设置为 <code>false</code>。对于 Rancher v2.7.5 及更高版本来说,这不是必需的,但你仍然可以手动设置该选项。</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">helm install rancher rancher-latest/rancher \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --namespace cattle-system \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set hostname=rancher.my.org \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set &#x27;extraEnv[0].name=CATTLE_FEATURES&#x27;</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set &#x27;extraEnv[0].value=&lt;FEATURE-FLAG-NAME-1&gt;=true,&lt;FEATURE-FLAG-NAME-2&gt;=true&#x27;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></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>备注</div><div class="admonitionContent_S0QG"><p>如果你安装的是 alpha 版本,Helm 要求你在命令中添加 <code>--devel</code> 选项。</p></div></div><h3 class="anchor anchorWithStickyNavbar_LWe7" id="离线安装的情况下渲染-helm-chart">离线安装的情况下渲染 Helm Chart<a href="#离线安装的情况下渲染-helm-chart" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h3><p>如果你是在离线环境安装 Rancher 的,在使用 Helm 安装 Rancher 之前,你需要添加一个 Helm Chart 仓库并渲染一个 Helm 模板。详情请参见<a href="/zh/getting-started/installation-and-upgrade/other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha">离线安装文档</a>。</p><p>以下是在渲染 Helm 模板时传入功能开关名称的命令示例。下面的示例通过传递功能开关名称(用逗号分隔)来启用两个功能。</p><p>Helm 命令如下:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">helm template rancher ./rancher-&lt;VERSION&gt;.tgz --output-dir . \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --no-hooks \ # 避免生成 Helm 钩子文件</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --namespace cattle-system \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set hostname=&lt;RANCHER.YOURDOMAIN.COM&gt; \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set rancherImage=&lt;REGISTRY.YOURDOMAIN.COM:PORT&gt;/rancher/rancher \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set ingress.tls.source=secret \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set systemDefaultRegistry=&lt;REGISTRY.YOURDOMAIN.COM:PORT&gt; \ # 设置在 Rancher 中使用的默认私有镜像仓库</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set useBundledSystemChart=true # 使用打包的 Rancher System Chart</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set &#x27;extraEnv[0].name=CATTLE_FEATURES&#x27;</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --set &#x27;extraEnv[0].value=&lt;FEATURE-FLAG-NAME-1&gt;=true,&lt;FEATURE-FLAG-NAME-2&gt;=true&#x27;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><h3 class="anchor anchorWithStickyNavbar_LWe7" id="docker-安装的情况下启用功能">Docker 安装的情况下启用功能<a href="#docker-安装的情况下启用功能" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h3><p>如果 Rancher 是使用 Docker 安装的,请使用 <code>--features</code> 选项。下面的示例通过传递功能开关名称(用逗号分隔)来启用两个功能:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">docker run -d -p 80:80 -p 443:443 \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --restart=unless-stopped \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> rancher/rancher:rancher-latest \</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> --features=&lt;FEATURE-FLAG-NAME-1&gt;=true,&lt;FEATURE-FLAG-NAME-2&gt;=true</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><h2 class="anchor anchorWithStickyNavbar_LWe7" id="使用-rancher-ui-启用功能">使用 Rancher UI 启用功能<a href="#使用-rancher-ui-启用功能" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h2><ol><li>在左上角,单击 <strong>☰ &gt; 全局设置</strong>。</li><li>单击<strong>功能开关</strong>。</li><li>如需启用某个功能,找到该已禁用的功能,并点击<strong>⋮ &gt; 激活</strong>。</li></ol><p><strong>结果</strong>:该功能已启用。</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="使用-rancher-ui-禁用功能">使用 Rancher UI 禁用功能<a href="#使用-rancher-ui-禁用功能" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h3><ol><li>在左上角,单击 <strong>☰ &gt; 全局设置</strong>。</li><li>单击<strong>功能开关</strong>。你将看到实验功能列表。</li><li>如需禁用某个功能,找到该已启用的功能,并点击<strong>⋮ &gt; 停用</strong>。</li></ol><p><strong>结果</strong>:该功能已禁用。</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="使用-rancher-api-启用功能">使用 Rancher API 启用功能<a href="#使用-rancher-api-启用功能" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h2><ol><li>前往 <code>&lt;RANCHER-SERVER-URL&gt;/v3/features</code>。</li><li>在 <code>data</code> 中,你会看到一个数组,该数组包含所有能通过功能开关启用的功能。功能的名称在 <code>id</code> 字段中。单击要启用的功能的名称。</li><li>在左上角的 <strong>Operations</strong> 下,点击 <strong>Edit</strong>。</li><li>在 <strong>Value</strong> 下拉菜单中,单击 <strong>True</strong>。</li><li>单击 <strong>Show Request</strong>。</li><li>单击 <strong>Send Request</strong>。</li><li>点击 <strong>Close</strong>。</li></ol><p><strong>结果</strong>:该功能已启用。</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="使用-rancher-api-禁用功能">使用 Rancher API 禁用功能<a href="#使用-rancher-api-禁用功能" class="hash-link" aria-label="标题的直接链接" title="标题的直接链接">​</a></h3><ol><li>前往 <code>&lt;RANCHER-SERVER-URL&gt;/v3/features</code>。</li><li>在 <code>data</code> 中,你会看到一个数组,该数组包含所有能通过功能开关启用的功能。功能的名称在 <code>id</code> 字段中。单击要启用的功能的名称。</li><li>在左上角的 <strong>Operations</strong> 下,点击 <strong>Edit</strong>。</li><li>在 <strong>Value</strong> 下拉菜单中,单击 <strong>False</strong>。</li><li>单击 <strong>Show Request</strong>。</li><li>单击 <strong>Send Request</strong>。</li><li>点击 <strong>Close</strong>。</li></ol><p><strong>结果</strong>:该功能已禁用。</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/enable-experimental-features.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>编辑此页</a></div><div class="col lastUpdated_vwxv"><span class="theme-last-updated">最后<!-- -->于 <b><time datetime="2023-07-05T01:52:42.000Z">2023年7月5日</time></b> <!-- -->更新</span></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="文档分页导航"><a class="pagination-nav__link pagination-nav__link--prev" href="/zh/how-to-guides/advanced-user-guides/cis-scan-guides/create-a-custom-benchmark-version-to-run"><div class="pagination-nav__sublabel">上一页</div><div class="pagination-nav__label">为集群扫描创建自定义 Benchmark 版本</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/zh/how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64"><div class="pagination-nav__sublabel">下一页</div><div class="pagination-nav__label">在 ARM64 上运行 Rancher(实验性)</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="#启动-rancher-时启用功能" class="table-of-contents__link toc-highlight">启动 Rancher 时启用功能</a><ul><li><a href="#kubernetes-安装的情况下启用功能" class="table-of-contents__link toc-highlight">Kubernetes 安装的情况下启用功能</a></li><li><a href="#离线安装的情况下渲染-helm-chart" class="table-of-contents__link toc-highlight">离线安装的情况下渲染 Helm Chart</a></li><li><a href="#docker-安装的情况下启用功能" class="table-of-contents__link toc-highlight">Docker 安装的情况下启用功能</a></li></ul></li><li><a href="#使用-rancher-ui-启用功能" class="table-of-contents__link toc-highlight">使用 Rancher UI 启用功能</a><ul><li><a href="#使用-rancher-ui-禁用功能" class="table-of-contents__link toc-highlight">使用 Rancher UI 禁用功能</a></li></ul></li><li><a href="#使用-rancher-api-启用功能" class="table-of-contents__link toc-highlight">使用 Rancher API 启用功能</a><ul><li><a href="#使用-rancher-api-禁用功能" class="table-of-contents__link toc-highlight">使用 Rancher API 禁用功能</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="/zh/assets/js/runtime~main.9a7dea44.js"></script>
<script src="/zh/assets/js/main.50802f1f.js"></script>
</body>
</html>