{"id":13574505,"url":"https://github.com/weaveworks/weaveworks-backstage","last_synced_at":"2025-10-28T00:12:16.005Z","repository":{"id":190596269,"uuid":"642713348","full_name":"weaveworks/weaveworks-backstage","owner":"weaveworks","description":"Backstage app and Plugins for WeaveWorks and Flux.","archived":false,"fork":false,"pushed_at":"2023-12-28T12:44:32.000Z","size":3084,"stargazers_count":33,"open_issues_count":10,"forks_count":10,"subscribers_count":10,"default_branch":"main","last_synced_at":"2024-11-09T23:37:53.550Z","etag":null,"topics":["backstage","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/weaveworks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-05-19T07:22:59.000Z","updated_at":"2024-08-27T16:55:55.000Z","dependencies_parsed_at":"2024-01-15T15:47:42.556Z","dependency_job_id":"b4662421-5111-42ac-8c1b-f320bbe91444","html_url":"https://github.com/weaveworks/weaveworks-backstage","commit_stats":null,"previous_names":["weaveworks/weaveworks-backstage"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaveworks%2Fweaveworks-backstage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaveworks%2Fweaveworks-backstage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaveworks%2Fweaveworks-backstage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaveworks%2Fweaveworks-backstage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weaveworks","download_url":"https://codeload.github.com/weaveworks/weaveworks-backstage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225144684,"owners_count":17427852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backstage","typescript"],"created_at":"2024-08-01T15:00:52.183Z","updated_at":"2025-10-28T00:12:16.000Z","avatar_url":"https://github.com/weaveworks.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","typescript"],"sub_categories":[],"readme":"# DEPRECATION NOTICE\n\nThe plugin within this repository has been migrated to backstage/community-repos. You can find the code under the new [flux workspace](https://github.com/backstage/community-plugins/tree/main/workspaces/flux).\n\nthe new package is available at the following locations:\n\n* [@backstage-community/plugin-flux](https://www.npmjs.com/package/@backstage-community/plugin-flux)\n\nLooking to contribute or help maintain? Check out the contributing guide in the community plugins repository.\n\n---\n\nThis repo contains the [Backstage](https://backstage.io) plugins created and maintained by [Weaveworks](https://www.weave.works/).\n\nThe following plugins can be found within this repo:\n\n- [FluxPlugin](https://github.com/weaveworks/weaveworks-backstage/blob/main/plugins/backstage-plugin-flux/)\n\nInstallation instructions for the plugins can be found in their individual README files.\n\n## Getting Started\n\nTo get up and running with this repository, you will need to set up:\n\n- a Github OAuth app and\n- a local kubernetes cluster.\n\n### Configure Github OAuth\n\nFollow the [Backstage instructions to create a Github OAuth app](https://backstage.io/docs/auth/github/provider#create-an-oauth-app-on-github), relevant bit here:\n\n\u003e To add GitHub authentication create an OAuth App from the GitHub [developer settings](https://github.com/settings/developers). The Homepage URL should point to Backstage's frontend, while the Authorization callback URL will point to the auth backend.\n\u003e\n\u003e - **Application name**: Backstage\n\u003e - **Homepage URL**: http://localhost:3000\n\u003e - **Authorization callback URL**: http://localhost:7007/api/auth/github/handler/frame\n\nSave the **clientId** and **clientSecret** that Github generates into a `.env` file or your `~/.bashrc` / `~/.zshrc`:\n\n```bash\nexport AUTH_GITHUB_CLIENT_ID=abc123\nexport AUTH_GITHUB_CLIENT_SECRET=abc123\n```\n\nThey're referenced in the `app-config.kubernetes.yaml` file.\n\n### Start a local kubernetes cluster\n\nTo start the app, run:\n\n```sh\n# create a cluster\nkind create cluster\n\n# install flux\nflux install\n\n# setup cluster auth and create an example podinfo helmrelease\nkubectl apply -k ./demo\n\n# install deps (node version 14 || \u003e=16.14 required)\nyarn install\n\n# (Optional) Provide the base URL to the weave-gitops app to link through from resources displayed in Backstage.\nexport WEAVE_GITOPS_URL=http://localhost:9001\n\n# start the app\n./startup.sh\n```\n\n## _(optional)_ Install `weave-gitops` to demonstrate linking through to resources details\n\nBackstage shows the important information about each resource, you can click through to the weave-gitops UI to see even more details. The URL is provided by the `WEAVE_GITOPS_URL` environment variable as shown above.\n\nFollow the weave-gitops [installation instructions](https://docs.gitops.weave.works/docs/next/open-source/getting-started/install-OSS/).\n\nIn short:\n\n\u003e ```sh\n\u003e brew tap weaveworks/tap\n\u003e brew install weaveworks/tap/gitops\n\u003e gitops create dashboard ww-gitops --password=\"some-password\"\n\u003e kubectl port-forward svc/ww-gitops-weave-gitops -n flux-system 9001:9001\n\u003e ```\n\nLogin to http://localhost:9001 with the username `admin` and the password you provided when creating the dashboard.\n\n## Community\n\nFor more details on how to contribute to the plugins, have a look at [Contributing](https://github.com/weaveworks/weaveworks-backstage/blob/main/CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweaveworks%2Fweaveworks-backstage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweaveworks%2Fweaveworks-backstage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweaveworks%2Fweaveworks-backstage/lists"}