You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
The Atlassian Community can help you and your team get more value out of Atlassian products and practices.
Welcome to the Compass community! Compass is a developer experience platform that provides a unified representation of the engineering output in one place.
Compass helps you track the things your engineering teams build and rely on — we call these components. The following are some concepts that are core to Compass:
Compass provides a component catalog where all your services, libraries, applications, and other components are tracked and managed.
Manage components manually in Compass or via config-as-code (YAML configuration file) with an external component manager like Bitbucket Cloud.
Compass also brings your team into one place to manage the components they own and to understand the dependencies and information about other team’s components.
Scorecards help you establish best practices without slowing down your team. Build and use scorecards to give teams autonomy to create new components while ensuring best practices are followed. For example, the service readiness scorecard helps you prepare services to be tracked in a production environment. Create different scorecards and apply them to different components.
Apps and integrations
Manage your components with config-as-code, a compass.yml file managed by an app like Bitbucket Cloud. More apps are coming soon to help you sync your existing components with Compass.
If you haven't signed up already, go ahead and do so via our signup form.
Getting started with Compass is simple, and starts with creating your first components.
Select Create in the top navigation to add components. You can also add components via the API. Once a component is added, it’s managed in the Compass UI or, optionally, via a compass.yml file which is managed alongside the component and syncs with Compass.
Learn more about how to add a component or how to use config-as-code in Compass.
Set up your team
A team in Compass is a collection of Atlassian accounts – an Atlassian team. Atlassian teams have members, a profile, work, and resources. The team members collectively work towards achieving a common goal.
Start a team to get your teammates into Compass to share component information and ownership. Teams should take ownership of components their team owns so that there’s a defined way for others to get more information or help with a particular component. Owner teams are defined on each individual component, or teams can assign components from their team’s dashboard. Learn more about what you can do on a team’s dashboard.
A component is an output artifact of your engineering team. It could be a service, a library, an application, or something else.
A component’s catalog listing in Compass is the unified view of all information about the component.
Browse the component catalog to see what components your organization has already added to Compass. The component catalog is organized by component type, so be sure to explore the different component types using the left side menu.
Use the Compass search bar to search for components by name, team, or description. When you begin typing in the search field, you’ll see results organized by component type.
Teams can add different information to their components, such as defining an owner team for that component, chat channels, on-call schedules, and details like the relevant repository, documentation, dashboards, projects, and other links.
Get started with config-as-code
Configuration as code (config-as-code) is an automated method of maintaining Compass component data in a Git repository. You can choose to declare component details in a YAML file that sits alongside the source code for the component itself.
Config-as-code enables Compass to be the single source of truth for your component management because your YAML files will automatically sync with Compass when updates are made to a component’s data. Learn more about managing components via config-as-code.
Get started with scorecards
Check out the Readiness scorecard under Settings to get an idea of how a scorecard can help build organizational best practices. This scorecard is used for preparing services to be tracked in a production environment. You can edit this scorecard to address your specific readiness requirements for service components or create new scorecards.
Custom scorecards enable you to:
Define company-wide standards and policies. Ensure that your teams are aiming for the same standards when it comes to things like security, etc.
Define team standards. Apply scorecards to the components that your team owns, besides the company-wide standards.
Apply your scorecards to components and you’ll see your scorecard and the current percentage of completion displayed on a component’s details page. Learn more about scorecards and how you can use them in your organization.
Have a question, found a bug, or need help? Support will be provided via this group. Simply ask a question here and we’ll help you out as best as we can!
3 accepted answers