https://archive-ce-3-20.netlify.app/assets/js/6c087f68.60aed07f.js

1"use strict";(self.webpackChunktigera_docs=self.webpackChunktigera_docs||[]).push([["536"],{78422(e,n,s){s.r(n),s.d(n,{metadata:()=>t,default:()=>h,frontMatter:()=>c,contentTitle:()=>d,toc:()=>l,assets:()=>a});var t=JSON.parse('{"id":"reference/resources/managedcluster","title":"Managed Cluster","description":"API for this Calico Enterprise resource.","source":"@site/calico-enterprise_versioned_docs/version-3.20-2/reference/resources/managedcluster.mdx","sourceDirName":"reference/resources","slug":"/reference/resources/managedcluster","permalink":"/calico-enterprise/3.20/reference/resources/managedcluster","draft":false,"unlisted":false,"editUrl":"https://github.com/tigera/docs/edit/main/calico-enterprise_versioned_docs/version-3.20-2/reference/resources/managedcluster.mdx","tags":[],"version":"3.20-2","frontMatter":{"description":"API for this Calico Enterprise resource."},"sidebar":"calicoEnterpriseSidebar","previous":{"title":"Kubernetes controllers configuration","permalink":"/calico-enterprise/3.20/reference/resources/kubecontrollersconfig"},"next":{"title":"Network policy","permalink":"/calico-enterprise/3.20/reference/resources/networkpolicy"}}'),r=s(70689),i=s(3413);let c={description:"API for this Calico Enterprise resource."},d="Managed Cluster",a={},l=[{value:"Sample YAML",id:"sample-yaml",level:2},{value:"Managed cluster definition",id:"managed-cluster-definition",level:2},{value:"Metadata",id:"metadata",level:3},{value:"Spec",id:"spec",level:3},{value:"Status",id:"status",level:3}];function o(e){let n={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,i.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(n.header,{children:(0,r.jsx)(n.h1,{id:"managed-cluster",children:"Managed Cluster"})}),"\n",(0,r.jsxs)(n.p,{children:["A Managed Cluster resource (",(0,r.jsx)(n.code,{children:"ManagedCluster"}),") represents a cluster managed by a centralized management plane with a shared Elasticsearch.\nThe management plane provides central control of the managed cluster and stores its logs."]}),"\n",(0,r.jsx)(n.p,{children:"Calico Enterprise supports connecting multiple Calico Enterprise clusters as describe in the [Multi-cluster management] installation guide."}),"\n",(0,r.jsxs)(n.p,{children:["For ",(0,r.jsx)(n.code,{children:"kubectl"})," commands, the following case-insensitive aliases may be used to specify the resource type on the CLI:\n",(0,r.jsx)(n.code,{children:"managedcluster"}),",",(0,r.jsx)(n.code,{children:"managedclusters"}),", ",(0,r.jsx)(n.code,{children:"managedcluster.projectcalico.org"}),", ",(0,r.jsx)(n.code,{children:"managedclusters.projectcalico.org"})," as well as\nabbreviations such as ",(0,r.jsx)(n.code,{children:"managedcluster.p"})," and ",(0,r.jsx)(n.code,{children:"managedclusters.p"}),"."]}),"\n",(0,r.jsx)(n.h2,{id:"sample-yaml",children:"Sample YAML"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-yaml",children:"apiVersion: projectcalico.org/v3\nkind: ManagedCluster\nmetadata:\n  name: managed-cluster\nspec:\n  operatorNamespace: tigera-operator\n"})}),"\n",(0,r.jsx)(n.h2,{id:"managed-cluster-definition",children:"Managed cluster definition"}),"\n",(0,r.jsx)(n.h3,{id:"metadata",children:"Metadata"}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Field"}),(0,r.jsx)(n.th,{children:"Description"}),(0,r.jsx)(n.th,{children:"Accepted Values"}),(0,r.jsx)(n.th,{children:"Schema"})]})}),(0,r.jsx)(n.tbody,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"name"}),(0,r.jsx)(n.td,{children:"Unique name to describe this resource instance. Required."}),(0,r.jsxs)(n.td,{children:["Alphanumeric string with optional ",(0,r.jsx)(n.code,{children:"."}),", ",(0,r.jsx)(n.code,{children:"_"}),", or ",(0,r.jsx)(n.code,{children:"-"}),"."]}),(0,r.jsx)(n.td,{children:"string"})]})})]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"cluster"})," is a reserved name for the management plane and is considered an invali

1d value"]}),"\n"]}),"\n",(0,r.jsx)(n.h3,{id:"spec",children:"Spec"}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Field"}),(0,r.jsx)(n.th,{children:"Description"}),(0,r.jsx)(n.th,{children:"Accepted Values"}),(0,r.jsx)(n.th,{children:"Schema"}),(0,r.jsx)(n.th,{children:"Default"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"installationManifest"}),(0,r.jsx)(n.td,{children:"Installation Manifest to be applied on a managed cluster infrastructure"}),(0,r.jsx)(n.td,{children:"None"}),(0,r.jsx)(n.td,{children:"string"}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"Empty"})})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"operatorNamespace"}),(0,r.jsx)(n.td,{children:"The namespace of the managed cluster's operator. This value is used in the generation of the InstallationManifest"}),(0,r.jsx)(n.td,{children:"None"}),(0,r.jsx)(n.td,{children:"string"}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"Empty"})})]})]})]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"installationManifest"})," field can be retrieved only once at creation time. Updates are not supported for this field."]}),"\n"]}),"\n",(0,r.jsxs)(n.p,{children:["To extract the installation manifest at creation time ",(0,r.jsx)(n.code,{children:'-o jsonpath="{.spec.installationManifest}"'})," parameters\ncan be used with a ",(0,r.jsx)(n.code,{children:"kubectl"})," command."]}),"\n",(0,r.jsx)(n.h3,{id:"status",children:"Status"}),"\n",(0,r.jsxs)(n.p,{children:["Status represents the latest observed status of Managed cluster. The ",(0,r.jsx)(n.code,{children:"status"})," is read-only for users and updated by the\nCalico Enterprise components."]}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Field"}),(0,r.jsx)(n.th,{children:"Description"}),(0,r.jsx)(n.th,{children:"Schema"})]})}),(0,r.jsx)(n.tbody,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"conditions"}),(0,r.jsx)(n.td,{children:"List of condition that describe the current status of the Managed cluster."}),(0,r.jsx)(n.td,{children:"List of ManagedClusterStatusConditions"})]})})]}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.strong,{children:"ManagedClusterStatusConditions"})}),"\n",(0,r.jsx)(n.p,{children:"Conditions represent the latest observed set of conditions for a Managed cluster. The connection between a management\nplane and managed plane will be reported as following:"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"Unknown"})," when no initial connection has been established"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"True"})," when both planes have an established connection"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"False"})," when neither planes have an established connection"]}),"\n"]}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Field"}),(0,r.jsx)(n.th,{children:"Description"}),(0,r.jsx)(n.th,{children:"Accepted Values"}),(0,r.jsx)(n.th,{children:"Schema"}),(0,r.jsx)(n.th,{children:"Default"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"type"}),(0,r.jsx)(n.td,{children:"Type of status that is being reported"}),(0,r.jsx)(n.td,{children:"-"}),(0,r.jsx)(n.td,{children:"string"}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"ManagedClusterConnected"})})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"status"}),(0,r.jsx)(n.td,{children:"Status of the connection between a Managed cluster and management cluster"}),(0,r.jsxs)(n.td,{children:[(0,r.jsx)(n.code,{children:"Unknown"}),", ",(0,r.jsx)(n.code,{children:"True"}),", ",(0,r.jsx)(n.code,{children:"False"})]}),(0,r.jsx)(n.td,{children:"string"}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"Unknown"})})]})]})]}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.a,{href:"/calico-enterprise/3.20/multicluster/set-up-multi-cluster-management/standard-install/create-a-management-cluster",children:"Multi-cluster management"})})]})}function h(e={}){let{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,r.jsx)(n,{...e,children:(0,r.jsx)(o,{...e})}):o(e)}},3413(e,n,s){s.d(n,{R:()=>c,x:()=>d});var t=s(16645);let r={},i=t.createContext(r);function c(e){let n=t.useContext(i);return t.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:c(e.components),t.createElement(i.Provider,{value:n},e.children)}}}]);