catalog model: introduce the System, Domain, and Resource kinds
See original GitHub issueFeature Suggestion
Before removing the alpha label on the catalog, I think it would be sensible to have at least the System
and Domain
kinds in place, and preferably also an outline of Resource
, as defined in the system model RFC.
Possible Implementation
I would argue that there is value in adding these in a very barebones manner, and iterate. What we need is:
- The skeleton of the kinds themselves
- Adding
system
anddomain
fields in the relevantspec
s of various kinds where appropriate, such asComponent
- Defining the relations that the
system
anddomain
fields translate to, probably new ones along the lines ofpartOf
, since the existing ones don’t seem like a great match.
Context
See the following RFCs:
Issue Analytics
- State:
- Created 3 years ago
- Reactions:8
- Comments:12 (9 by maintainers)
Top Results From Across the Web
System Model · Backstage Software Catalog and Developer ...
System Model. We believe that a strong shared understanding and terminology around software and resources leads to a better Backstage experience.
Read more >71. Defining and Scoping the Organizing System Domain
The most fundamental decision for an organizing system is defining its domain, the set or type of resources that are being organized.
Read more >Domain Model and Domain Modeling - GitHub Pages
Domain Modeling. • Resources: Craig Larman; Applying UML and Patterns: An Introduction ... The domain model is also called conceptual model, domain.
Read more >Domain Model | Mendix Documentation
1 Introduction ; Annotation, A comment explaining an aspect of the domain model ; Entity Name, How the entity will be referred to...
Read more >IAM Identity Domain Types - Oracle Help Center
Use this domain type to start to use and understand IAM, and to manage access to OCI Infrastructure as a Service and PaaS...
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
I think we’ve moved beyond the point that this discussion is directly related to this issue so I’ve raised https://github.com/backstage/backstage/issues/3815 as a strawman proposal specifically focused on modelling monolithic apps.
@mbruggmann Right.
does that risk weakening the Component concept? See the discussion above of a website starting its life as a component and ending up as an application when it grows. This changes its kind/namespace/name identifier, and hence urls and references everywhere.
Or do we dive head first into applications and choose to always model websites, services and client apps as applications from the get-go? If we do, and that’s OK if we do, I think we need to clearly adjust messaging and docs etc.