Rework catalog configuration; add integrations documentation

Signed-off-by: Tim Hansen <timbonicus@gmail.com>
2021-03-23 14:34:52 -06:00
parent 5da3fddb42
commit cc3dca079e
9 changed files with 320 additions and 106 deletions
@@ -0,0 +1,30 @@
+---
+id: locations
+title: Azure DevOps Locations
+sidebar_label: Locations
+description: Documentation on Azure DevOps location integration
+---
+
+The Azure integration supports loading catalog entities from Azure DevOps.
+Components can be added to
+[static catalog configuration](../../features/software-catalog/configuration.md),
+or registered with the
+[catalog-import](https://github.com/backstage/backstage/tree/master/plugins/catalog-import)
+plugin.
+
+```yaml
+integrations:
+  azure:
+    - host: dev.azure.com
+      token:
+        $env: AZURE_TOKEN
+```
+
+> Note: An Azure DevOps provider is added automatically at startup for
+> convenience, so you only need to list it if you want to supply a
+> [token](https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate).
+
+The configuration is a structure with two elements:
+
+- `host`: The DevOps host; only `dev.azure.com` is supported.
+- `token` (optional): An personal access token as expected by Azure DevOps.