{"id":13678939,"url":"https://github.com/devxp-tech/backstage","last_synced_at":"2025-04-29T16:30:35.135Z","repository":{"id":37831441,"uuid":"487874649","full_name":"devxp-tech/backstage","owner":"devxp-tech","description":"⚙️ Backstage System","archived":false,"fork":false,"pushed_at":"2025-04-25T21:14:57.000Z","size":348636,"stargazers_count":49,"open_issues_count":41,"forks_count":34,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-25T22:23:09.590Z","etag":null,"topics":["backstage","backstage-backend","backstage-include","backstage-system","developer-experience","devexp","devxp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devxp-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-05-02T14:26:18.000Z","updated_at":"2025-04-23T04:45:09.000Z","dependencies_parsed_at":"2023-12-25T16:01:26.822Z","dependency_job_id":"23927366-6a16-42a0-9c49-5005c00ffc30","html_url":"https://github.com/devxp-tech/backstage","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxp-tech%2Fbackstage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxp-tech%2Fbackstage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxp-tech%2Fbackstage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxp-tech%2Fbackstage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devxp-tech","download_url":"https://codeload.github.com/devxp-tech/backstage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251540019,"owners_count":21605831,"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","backstage-backend","backstage-include","backstage-system","developer-experience","devexp","devxp"],"created_at":"2024-08-02T13:01:00.039Z","updated_at":"2025-04-29T16:30:34.448Z","avatar_url":"https://github.com/devxp-tech.png","language":"TypeScript","readme":"# Backstage\n\n[![main](https://github.com/devxp-tech/backstage/actions/workflows/main.yaml/badge.svg)](https://github.com/devxp-tech/backstage/actions/workflows/main.yaml)\n[![Quality Gate Status](https://sonar.devxp-tech.io/api/project_badges/measure?project=backstage\u0026metric=alert_status\u0026token=sqb_75874b86dd51377e19e0a63680ce408a315f5327)](https://sonar.devxp-tech.io/dashboard?id=backstage)\n[![App Status](https://argocd.devxp-tech.io/api/badge?name=backstage-prd\u0026revision=true)](https://argocd.devxp-tech.io/applications/backstage-prd)\n\n## Backstage - IDP\n\n## Environments you need before start\n\n| Name                      | Where to get?                                                                                                   |\n| :------------------------ | :-------------------------------------------------------------------------------------------------------------- |\n| GITHUB_ACCESS_TOKEN       | Generate a new personal access token in [GIthub Secure page](https://github.com/settings/tokens)                |\n| AUTH_GITHUB_CLIENT_ID     | Get in [Github app ID](https://github.com/organizations/devxp-tech/settings/applications/1927877)               |\n| AUTH_GITHUB_CLIENT_SECRET | Open a tiket to Devxp to share this value                                                                       |\n| SONARQUBE_TOKEN           | Create a `Sonarqube` token using this [documentation](https://docs.sonarqube.org/latest/user-guide/user-token/) |\n\nAll environments above `MUST` be exported in your bash context like below:\n\n```sh\n# .bashrc or .zshrc\nexport GITHUB_ACCESS_TOKEN='YOUR-TOKEN-HERE'\nexport AUTH_GITHUB_CLIENT_ID='YOUR-TOKEN-HERE'\nexport AUTH_GITHUB_CLIENT_SECRET='YOUR-TOKEN-HERE'\nexport SONARQUBE_TOKEN='YOUR-TOKEN-HERE'\n```\n\n## Setup your hosts\n\nYou'll need to create an entry to your `/etc/hosts` to specify `backstage.local` like below:\n\n```sh\n# /etc/hosts\n\n# ...\n127.0.0.1 backstage.local\n#...\n\n```\n\n## 🚀 Start project\n\nYou'll need `Docker` and `docker-compose` installed before you continue!\n\nOnce all you need is in your bash context, just run the commands below:\n\n```sh\ndocker-compose run --rm app yarn # to install node_modules\ndocker-compose up -d app # to up the backstage application\n```\n\nBackstage in develop mode will be available in \u003chttp://backstage.local:3000\u003e and it's using `GitHub SSO integration`\n\n## 🆙 Backstage Update\n\n```sh\ndocker-compose run --rm app bash\nyarn backstage-cli versions:bump\n```\n\n## 🚦 Work Flux\n\n```mermaid\ngraph TD;\n    Dev--\u003eBackstage;\n    Backstage--create--\u003edevxp-app;\n    devxp-app--\u003egolang;\n    devxp-app--\u003epython;\n    devxp-app--\u003enode;\n    golang--new-app--\u003ebackstage-catalog;\n    backstage-catalog--fetch--\u003egithub/devxp-tech/template-golang;\n    backstage-catalog--fetch--\u003ekubernetes-skelleton;\n    backstage-catalog--push--\u003egithub/devxp-tech/new-app;\n    kubernetes-skelleton--PullRequest--\u003eArgoCD;\n    github/devxp-tech/new-app--workflow--\u003edevxp-tech/.github/workflows;\n    ArgoCD--pull--\u003ehelm-charts/devxp-app;\n    ArgoCD--deploy--\u003eKubernetes;\n    devxp-tech/.github/workflows--push/docker-image--\u003eghcr.github.com/devxp-tech;\n    Kubernetes--pull/docker-image--\u003eghcr.github.com/devxp-tech;\n    Kubernetes--\u003enew-app;\n```\n\n## 🧩 References \n\n- [ArgoCD](https://github.com/devxp-tech/gitops)\n- [helm-charts](https://github.com/devxp-tech/helm-charts)\n- [Backstage](https://github.com/devxp-tech/backstage)\n- [backstage-catalog:](https://github.com/devxp-tech/backstage-catalog)\n- [template-golang](https://github.com/devxp-tech/template-golang)\n- [github-workflows](https://github.com/devxp-tech/.github)\n\n\n## ✨ Contributions\n\nWe ❤️ contributions big or small. [See our guide](contributing.md) on how to get started.\n\n### Thanks to all our contributors!\n\n\u003ca href=\"https://github.com/devxp-tech/backstage/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=devxp-tech/backstage\" /\u003e\n\u003c/a\u003e\n\nMade with 💜 by DevXP-Tech.\n\n\n","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevxp-tech%2Fbackstage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevxp-tech%2Fbackstage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevxp-tech%2Fbackstage/lists"}