github monorepo compass integration

Sridhar Ravula

Hi Team, 

we have 15 services in mono repo and  looking to integrate key development and operational metrics for each individual component within this mono repo into their respective representations in Compass.

i have added compass.yml file each service in monorepo, but not sure how it works for mono repo 

Could you please provide assistance or point us to relevant documentation/examples for the following:

Enrique Serrano Valle

Hi, @Sridhar Ravula !

For each of the individual components of the monorepo, you can mark them as such as part of the config as code file, as detailed in https://developer.atlassian.com/cloud/compass/config-as-code/manage-components-with-config-as-code/#managing-multiple-components-with-config-as-code-in-a-single-repository - this will ensure that the aggregated activity of the monorepo won't show up in each one of the individual monorepo components.

Then, for every one of the individual monorepo components, we recommend using the API to send events related to their builds and deployments from their related CI/CD tool, so that specific events for each component are tracked. The Compass REST API called from your CI/CD pipelines may be the most straightforward way to do so. Here's what something like that would look like from a Bamboo pipeline.

You can still create a separate Compass component that represents the whole monorepo (keeping the component of a monorepo toggle / value as `isMonorepoProject: false` for this one) and which would automatically receive the aggregated activity from all contained components based on the Compass repository app (e.g.: the installed Compass Bitbucket App). We recommend associating this whole monorepo representation with the individual components as dependencies (e.g.: the main monorepo may be the `Capability` and each individual component could be a `UI element` or `Service`) so they're easy to trace to each other as well.