Connect your tools
An integration gives Astrolabe the address and the token of one of your tools. The administrator adds it once, in Administration › Company connections. Then the tool shows up where your teams look: on the page of each component, on their dashboard, in the catalog.
🧰 The tools
| Tool | What it brings | Start here |
|---|---|---|
| GitHub | Pipelines, pull requests, branches and releases of a component; dashboard cards | Add the integration |
| GitLab | Pipelines, merge requests, branches and releases of a component; dashboard cards | Add the integration |
| Jira | The open issues of a component's project, in a tab; dashboard cards | Connect Jira Cloud |
| Argo CD | A component's Argo CD application, its health and deployments | Add the integration |
| Jenkins | The builds of a component; dashboard cards | Add the integration |
| SonarQube | The code quality of a component | Add the integration |
| Codacy | A component's Codacy grade, and its issues in a tab | Add the integration |
| Grafana | A component's Grafana alerts and dashboards, in its Monitoring tab | Add the integration |
| Terraform Cloud | A component's workspaces and their last runs | Add the integration |
| LaunchDarkly | The feature flags of a component | Add the integration |
| Azure DevOps | Pipelines, pull requests and work items on your dashboard | Add the integration |
| Azure Cloud | A component's Azure resources and what they cost | Add the integration |
| Bitbucket Server, Bitbucket Cloud | Your repositories in the catalog | Bitbucket Server, Bitbucket Cloud |
| Confluence | The pages of your Confluence, found by the search | Add the integration |
| AWS | An AWS access key | Add the integration |
🔢 The steps, for every tool
-
Create a token in the tool. Each page says which rights it needs.
-
Add the integration in Administration › Company connections, and click Test connection.
-
Turn on its plugin, if it has one, in Administration › Plugins: see Turn on a plugin.
-
Annotate your components in their
catalog-info.yaml, so that their tab shows up. Each tool's page gives its annotation.
🔑 Two tokens: the company's, and yours
GitHub, GitLab, Jira and Azure DevOps read with the company's token for the component tabs, the catalog and Compass, and with your own account for your dashboard cards. See The company's token and your own account.
Each tool has its Common problems page. For the whole instance, start with Find and fix a problem.