How abhikdps/automation-portal-plugins works
This monorepo provides Ansible-focused Backstage experiences. A developer enters through the portal UI, explores catalogued AAP and source-control resources, then launches automation through self-service or scaffolder workflows; authentication and catalog synchronization support that journey. APME adds repository quality and activity features. Several product branches are documented or visible in the tree but lack sampled implementation details, so uncertain connections are omitted or marked unverified.
Main entry points: router.ts Catalog API · AAPClient.ts AAP API client · App.tsx Backstage portal · AAPService.ts AAP service
Components 22
Portal experience
- Backstage portal
workspaces/portal-core/packages/app/src/App.tsx - Ansible UI
workspaces/aap/plugins/backstage-rhaap/src/components/AnsiblePage/AnsiblePage.tsx - Self-service UI
workspaces/self-service/plugins/self-service/src/routes.ts - Repository details
workspaces/self-service/plugins/self-service/src/components/GitRepositories/RepositoryDetailsPage.tsx
AAP integration
- AAP auth provider
workspaces/aap/plugins/auth-backend-module-rhaap-provider/src/userJobTemplatesRouter.ts - AAP API client
workspaces/aap/plugins/backstage-rhaap-common/src/AAPClient/AAPClient.ts - AAP service
workspaces/aap/plugins/backstage-rhaap-common/src/AAPService/AAPService.ts
Catalog discovery
- Catalog API
workspaces/aap/plugins/catalog-backend-module-rhaap/src/router.ts - AAP entity sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/providers/AAPEntityProvider.ts - Job template sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/providers/AAPJobTemplateProvider.ts - Git contents sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/providers/AnsibleGitContentsProvider.ts - Collection sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/providers/PAHCollectionProvider.ts - Sync tracking
workspaces/aap/plugins/catalog-backend-module-rhaap/src/providers/SyncStateTracker.ts
Self-service automation
- AAP scaffolder actions
workspaces/aap/plugins/scaffolder-backend-module-backstage-rhaap/src/actions/index.ts - Execution environments
workspaces/self-service/plugins/self-service/src/components/ExecutionEnvironments/EERoutesPage.tsx
APME quality
- APME portal UI
workspaces/apme/plugins/backstage-apme/src/components/QualityTab/QualityTab.tsx - APME API
workspaces/apme/plugins/catalog-backend-module-apme/src/router.ts - APME service
workspaces/apme/plugins/backstage-apme-common/src/ApmeService/ApmeClient.ts
Other components
- Developer
- AAP instance
- GitHub / GitLab
- APME Gateway
Connections 22
- Developer → Backstage portal: uses
workspaces/portal-core/packages/app/src/App.tsx - Backstage portal → Ansible UI: routes to
workspaces/portal-core/packages/app/src/App.tsx - Backstage portal → Self-service UI: routes to
workspaces/portal-core/packages/app/src/App.tsx - Backstage portal → Repository details: renders
- Ansible UI → AAP service: uses
- AAP service → AAP API client: delegates to
- AAP API client → AAP instance: requests API
workspaces/aap/plugins/backstage-rhaap-common/src/AAPClient/AAPClient.ts - AAP auth provider → AAP API client: authenticates with
- Catalog API → AAP entity sync: dispatches sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/router.ts - Catalog API → Job template sync: dispatches sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/router.ts - Catalog API → Git contents sync: dispatches sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/router.ts - Catalog API → Collection sync: dispatches sync
workspaces/aap/plugins/catalog-backend-module-rhaap/src/router.ts - Catalog API → Sync tracking: tracks status
workspaces/aap/plugins/catalog-backend-module-rhaap/src/router.ts - AAP entity sync → AAP API client: reads resources
- Job template sync → AAP API client: reads resources
- Git contents sync → GitHub / GitLab: scans repositories
- AAP scaffolder actions → AAP service: runs AAP actions
- Self-service UI → Execution environments: opens EE routes
- Repository details → Catalog API: requests repository data
- APME portal UI → APME API: calls API
- APME API → APME service: uses service
- APME service → APME Gateway: requests operations