{"id":16878759,"url":"https://github.com/peterj/bookstageinfo","last_synced_at":"2025-04-11T11:36:08.042Z","repository":{"id":226510623,"uuid":"768894871","full_name":"peterj/bookstageinfo","owner":"peterj","description":"Backstage developer portal setup with Bookinfo application ","archived":false,"fork":false,"pushed_at":"2024-03-12T18:46:02.000Z","size":772,"stargazers_count":2,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-25T08:01:34.642Z","etag":null,"topics":["backstage","bookinfo","kubernetes"],"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/peterj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-07T23:39:22.000Z","updated_at":"2024-03-11T16:55:29.000Z","dependencies_parsed_at":"2024-03-12T19:52:54.288Z","dependency_job_id":"c566760a-4cdf-4bae-864b-9aebc5cb9922","html_url":"https://github.com/peterj/bookstageinfo","commit_stats":null,"previous_names":["peterj/bookstageinfo"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fbookstageinfo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fbookstageinfo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fbookstageinfo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fbookstageinfo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peterj","download_url":"https://codeload.github.com/peterj/bookstageinfo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248384669,"owners_count":21094753,"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","bookinfo","kubernetes"],"created_at":"2024-10-13T15:51:15.194Z","updated_at":"2025-04-11T11:36:08.014Z","avatar_url":"https://github.com/peterj.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bookstageinfo\n\nThis is repo used to showcase Backstage with the Bookinfo application (hence book-stage-info).\n\n![Bookinfo](./img/bookinfo.png)\n\nThe source for the bookinfo service is from the [Istio repo](https://github.com/istio/istio/).\n\nCheck out my YouTube channel for Backstage videos:\n\n-  [Part 1: What is Backstage?](https://youtube.com/live/5Vt9ixVGR0Q)\n    Getting familiar with Backstage, basic set up with database, Github integration and Kubernetes.\n\n- [Part 2: What is Backstage?](https://youtube.com/live/JsII4MXdCBw)\n    Building templates and plugins.\n\n## Backstage setup\n\nThe Backstage app is in the `backstage` folder. Before you run the app, make sure you set up the database and configure environment variables.\n\n### 1. Database setup\n\nBackstage is configured to use the local postgres database. You can run the database using docker:\n\n```shell\ndocker run --name some-postgres -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword -d postgres\n```\n\nIf you want to use a different database, you can change the database configuration in the `backstage/app-config.yaml` file.\n\n### 2. Environment variables\n\nBefore you run the app, you need to set the environment variables for Github integration (`GITHUB_TOKEN`) and auth (`GITHUB_CLIENT_ID` and `GITHUB_CLIENT_SECRET`).\n\n```shell\nexport GITHUB_TOKEN=your-github-token\nexport GITHUB_CLIENT_ID=your-github-client-id\nexport GITHUB_CLIENT_SECRET=your-github\n```\n\nCheck the `app-config.yaml` for links to the documentation on how to get these values.\n\n### 3. Run the app\n\nTo run the app, you can use the following commands:\n\n```shell\ncd backstage\nyarn dev\n```\n\nBefore you run the app for the first time, make sure you installed the dependencies (`yarn install`).\n\n## Setting up Kubernetes\n\nThe configuration (`app-config.yaml`) assumes you have a local Kubernetes cluster running (i.e. `kubectl proxy`) that Backstage app can access. Additionally, it's assumed you have deployed the [Bookinfo application to the cluster](https://raw.githubusercontent.com/istio/istio/release-1.20/samples/bookinfo/platform/kube/bookinfo.yaml). Alternatively, you can individually deploy services using the manfiests in the `/deploy` folder.\n\n\nOnce you have the Kubernetes cluster setup, Bookinfo deployed and the proxy running, you'll see a \"Kubernetes\" tab on the components page:\n\n![Kubernetes tab for the productpage](./img/k8stab.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterj%2Fbookstageinfo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterj%2Fbookstageinfo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterj%2Fbookstageinfo/lists"}