1"use strict";(globalThis.webpackChunkopsworker_docs=globalThis.webpackChunkopsworker_docs||[]).push([[5099],{3763(e,s,r){r.r(s),r.d(s,{assets:()=>c,contentTitle:()=>i,default:()=>p,frontMatter:()=>a,metadata:()=>n,toc:()=>l});const n=JSON.parse('{"id":"core-concepts/workspaces","title":"Workspaces","description":"Workspaces in OpsWorker group clusters into logical boundaries within your organization, such as a team, environment, or business unit.","source":"@site/docs/core-concepts/workspaces.md","sourceDirName":"core-concepts","slug":"/core-concepts/workspaces","permalink":"/docs/core-concepts/workspaces","draft":false,"unlisted":false,"tags":[],"version":"current","frontMatter":{"description":"Workspaces in OpsWorker group clusters into logical boundaries within your organization, such as a team, environment, or business unit."},"sidebar":"docs","previous":{"title":"Quick Start","permalink":"/docs/get-started/quick-start"},"next":{"title":"Clusters","permalink":"/docs/core-concepts/clusters"}}');var o=r(4848),t=r(8453);const a={description:"Workspaces in OpsWorker group clusters into logical boundaries within your organization, such as a team, environment, or business unit."},i="Workspaces",c={},l=[{value:"What is a Workspace",id:"what-is-a-workspace",level:2},{value:"How Workspaces Organize Your Setup",id:"how-workspaces-organize-your-setup",level:2},{value:"What Belongs to a Workspace",id:"what-belongs-to-a-workspace",level:2},{value:"Common Patterns",id:"common-patterns",level:2},{value:"Managing Workspaces",id:"managing-workspaces",level:2}];function d(e){const s={a:"a",code:"code",h1:"h1",h2:"h2",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,t.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(s.header,{children:(0,o.jsx)(s.h1,{id:"workspaces",children:"Workspaces"})}),"\n",(0,o.jsx)(s.h2,{id:"what-is-a-workspace",children:"What is a Workspace"}),"\n",(0,o.jsxs)(s.p,{children:["A workspace is a grouping ",(0,o.jsx)(s.strong,{children:"within"})," your OpsWorker organization. The organization is the top-level tenant; a workspace organizes clusters into a logical boundary that represents a team, environment, or business unit."]}),"\n",(0,o.jsx)(s.p,{children:"Every OpsWorker organization starts with one default workspace. Admins can create additional workspaces to separate concerns, for example one workspace per team, per environment, or per business unit."}),"\n",(0,o.jsx)(s.h2,{id:"how-workspaces-organize-your-setup",children:"How Workspaces Organize Your Setup"}),"\n",(0,o.jsx)(s.pre,{children:(0,o.jsx)(s.code,{children:'Organization (your company)\n\u251c\u2500\u2500 Workspace: "Platform Team"\n\u2502 \u251c\u2500\u2500 Cluster: production-us-east\n\u2502 \u2514\u2500\u2500 Cluster: production-eu-west\n\u251c\u2500\u2500 Workspace: "Application Team"\n\u2502 \u2514\u2500\u2500 Cluster: staging\n'})}),"\n",(0,o.jsx)(s.p,{children:"Alert rules and notification routing are configured per cluster, not per workspace. A workspace is the boundary that owns the clusters."}),"\n",(0,o.jsx)(s.h2,{id:"what-belongs-to-a-workspace",children:"What Belongs to a Workspace"}),"\n",(0,o.jsxs)(s.table,{children:[(0,o.jsx)(s.thead,{children:(0,o.jsxs)(s.tr,{children:[(0,o.jsx)(s.th,{children:"Resource"}),(0,o.jsx)(s.th,{children:"Scoping"})]})}),(0,o.jsxs)(s.tbody,{children:[(0,o.jsxs)(s.tr,{children:[(0,o.jsx)(s.td,{children:(0,o.jsx)(s.strong,{children:"Clusters"})}),(0,o.jsx)(s.td,{children:"Each cluster belongs to one workspace"})]}),(0,o.jsxs)(s.tr,{children:[(0,o.jsx)(s.td,{children:(0,o.jsx)(s.strong,{children:"Users"})}),(0,o.jsx)(s.td,{children:"Each user belongs to exactly one workspace"})]}),(0,o.jsxs)(s.tr,{children:[(0,o.jsx)(s.td,{children:(0,o.jsx)(s.strong,{children:"Alert Rules"})}),(0,o.jsx)(s.td,{children:"Configured per cluster (within a workspace's clusters)"})]}),(0,o.jsxs)(s.tr,{children:[(0,o.jsx)(s.td,{children:(0,o.jsx)(s.strong,{children:"Notification Routing"})}
1),(0,o.jsx)(s.td,{children:"Configured per cluster and namespace"})]}),(0,o.jsxs)(s.tr,{children:[(0,o.jsx)(s.td,{children:(0,o.jsx)(s.strong,{children:"Investigations"})}),(0,o.jsx)(s.td,{children:"Visible to users in the organization"})]})]})]}),"\n",(0,o.jsx)(s.p,{children:"A user belongs to exactly one organization and one workspace. There is no multi-workspace membership and no per-workspace roles; roles (Admin, ReadOnly) are assigned at the user level."}),"\n",(0,o.jsx)(s.h2,{id:"common-patterns",children:"Common Patterns"}),"\n",(0,o.jsxs)(s.ul,{children:["\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.strong,{children:"By team"}),": each team gets a workspace with their clusters."]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.strong,{children:"By environment"}),": separate workspaces for production, staging, and development."]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.strong,{children:"Single workspace"}),": small teams often use one workspace for everything."]}),"\n"]}),"\n",(0,o.jsx)(s.h2,{id:"managing-workspaces",children:"Managing Workspaces"}),"\n",(0,o.jsxs)(s.p,{children:["Workspaces are created and managed in the OpsWorker portal. Admins can create, rename, and delete workspaces. See ",(0,o.jsx)(s.a,{href:"/docs/configuration/workspaces",children:"Manage Workspaces"})," for detailed instructions."]})]})}function p(e={}){const{wrapper:s}={...(0,t.R)(),...e.components};return s?(0,o.jsx)(s,{...e,children:(0,o.jsx)(d,{...e})}):d(e)}},8453(e,s,r){r.d(s,{R:()=>a,x:()=>i});var n=r(6540);const o={},t=n.createContext(o);function a(e){const s=n.useContext(t);return n.useMemo(function(){return"function"==typeof e?e(s):{...s,...e}},[s,e])}function i(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:a(e.components),n.createElement(t.Provider,{value:s},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.