Ownership in Backstage Entities
Published on May 11th, 2023Ownership of an entity should be a single reference to a person or team primarily responsible for that entity.
It is represented in Backstage by the spec.owner
field using a user or team entity reference in the following pattern [<kind>:][<namespace>/]<name>
like so:
group:roadiehq/engineering-team
user:default/davidtuite
The kind and namespace are both optional and default to the kind of the entity itself, and the default
namespace.
Compound entity refs can be specified if special characters are in any of the three references like so:
spec:
owner:
kind: Group
namespace: default
name: finance:international/legal
Using a Code Owners file
Code Owners is an approach to defining ownership of a repository or section of code by using a file that lives alongside that code.
This CODEOWNERS
file can be used by Roadie Backstage to decorate ownership automatically on entities rather than manually defining ownership in the entity spec definition. This is achieved through the CodeOwnersProcessor in Backstage.
Most major SCM providers will look for a file at ./CODEOWNERS
, ./docs/CODEOWNERS
, or ./.<scm-name>/CODEOWNERS
. See Github and Gitlab docs here.
This approach to defining ownership of an entity in Backstage is preferable only if your CODEOWNERS file is kept up to date and is accurate. Otherwise it may be better to define ownership in the entity definition so users can know where to go to update it. Codeowners decoration is opaque in Backstage currently so it may be difficult to know where the source of an Entity’s ownership is coming from unless you are aware of the CODEOWNERS file.