{"id":17774034,"url":"https://github.com/dirien/backstage-demo","last_synced_at":"2025-04-13T10:56:01.646Z","repository":{"id":259130929,"uuid":"869161256","full_name":"dirien/backstage-demo","owner":"dirien","description":"Build Your Developer Platform in 90 Minutes - Backstage + ArgoCD + K8s Workshop","archived":false,"fork":false,"pushed_at":"2024-11-24T13:23:06.000Z","size":48,"stargazers_count":2,"open_issues_count":0,"forks_count":69,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T14:08:24.340Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","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/dirien.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-10-07T20:25:59.000Z","updated_at":"2024-12-07T21:23:31.000Z","dependencies_parsed_at":"2024-11-24T14:22:16.025Z","dependency_job_id":null,"html_url":"https://github.com/dirien/backstage-demo","commit_stats":null,"previous_names":["dirien/backstage-demo"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fbackstage-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fbackstage-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fbackstage-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fbackstage-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dirien","download_url":"https://codeload.github.com/dirien/backstage-demo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245767351,"owners_count":20668826,"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":[],"created_at":"2024-10-26T21:48:03.583Z","updated_at":"2025-03-27T02:11:10.870Z","avatar_url":"https://github.com/dirien.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Build Your Developer Platform in 90 Minutes - Backstage + ArgoCD + K8s\n\nThis repository contains everything you need to follow along with the \"Build Your Developer Platform in 90 Minutes -\nBackstage + ArgoCD + K8s\" workshop.\n\nThe main goal of this workshop is to show how to build a developer platform using `Backstage`, `ArgoCD`, and\n`Kubernetes` and give you a glimpse of how this tools work and how you can use these tools to build your own developer\nplatform.\n\n## Repository\n\nPlease fork this repository to your own GitHub account to follow along with the workshop. You can do this by clicking on\nthis link:\n\n[![Fork this repository](https://img.shields.io/badge/Fork-this%20repository-orange?logo=github\u0026style=for-the-badge)](https://github.com/dirien/backstage-demo/fork)\n\nThis repository contains all the resources that are needed to follow along with the workshop. Additionally, it contains\na `.devcontainer` configuration that allows you to run the workshop in a containerized environment. You can choose from\nseveral options to run the workshop:\n\n1. **Local Environment**: You can run the workshop on your local machine.\n1. **GitHub Codespaces**: You can run the workshop in a GitHub Codespace.\n\n### `.devcontainer` Configuration\n\nThe `.devcontainer` configuration is used to create a containerized environment for the workshop. It contains all the\ntools and dependencies that are needed to run the workshop.\n\nAll you need to do is, after forking the repository, decide what remote environment you want to use.\n\n#### GitHub Codespaces\n\nIf you prefer to use `GitHub Codespaces` you can click on the `Code` button in the top right corner of the repository\nand select `Open with Codespaces`. If you prefer to use a local environment you can follow the instructions below.\n\n\u003cimg src=\"img/codespace.png\"\u003e\n\n#### Local Environment\n\nFirst, you need to clone the repository to your local machine:\n\n```bash\ngit clone \u003cyour-forked-repository URL\u003e\n```\n\nAnd you need to have on your local machine Visual Studio Code and\nthe [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)\nfrom the Visual Studio Code Marketplace installed.\n\n## Prerequisites\n\nBefore you start the workshop, make sure you have the following tools installed on your machine:\n\n\u003e **Note**: We highly recommend using the `.devcontainer` configuration to run the workshop as you do not need to\n\u003e install any of the tools below.\n\n| Name       | Required | More info                                                  |\n|------------|----------|------------------------------------------------------------|\n| Pulumi CLI | Yes      | https://www.pulumi.com/docs/iac/download-install/\\         |\n| gitHub CLI | Yes      | https://cli.github.com/                                    |\n| yq         | Yes      | https://github.com/mikefarah/yq#install                    |\n| kubeseal   | Yes      | https://github.com/bitnami-labs/sealed-secrets#kubeseal    |\n| Helm       | Yes      | https://github.com/helm/helm#install                       |\n| kubectl    | Yes      | https://github.com/kubernetes/kubectl                      |\n| argocd-cli | Yes      | https://argo-cd.readthedocs.io/en/stable/cli_installation/ |\n\n### Pulumi Account\n\nAs part of the Pulumi CLI installation, you will need to create a free Pulumi account to host your state files. Please\nhead over to [Pulumi](https://app.pulumi.com/signup) and create your free personal account.\n\n### DigitalOcean Account (Optional)\n\nWe will be using [DigitalOcean](https://digitalOcean.com/) as our Kubernetes provider. \n\nOtherwise, we will provider you an API key to use for the workshop, this will be provided during the workshop.\n\n\u003e **Note**: After the workshop, we will delete all the resources created during the workshop to avoid any charges. If\n\u003e you want to keep the resources please use your own DigitalOcean account.\n\n## Workshop\n\nThe workshop is divided into several steps. For each step, we created separate shell scripts that you can run to get the\ndesired result. The steps are as follows:\n\n### Create Cluster\n\nHere we will create a Kubernetes cluster using DigitalOcean. Don't worry, we will provide you with an API key to use for the\nworkshop.\n\nRun this command and follow the instructions inside the terminal:\n\n```bash\n./clusters.sh\n```\n\nIf you are done with the cluster creation, you can move on to the next step.\n\n### Set up the Environment\n\nIn this step we will set up ArgoCD so it can be used to point to your forked repository and is accessible from the\ninternet.\n\nRun this command and follow the instructions inside the terminal:\n\n```bash\n./setup.sh\n```\n\n### Run the actual demo\n\nIn this step we will install all the required components to run Backstage on the Kubernetes cluster. This will be not an\none-click script, because we want to show you how to install the components step by step and what they are doing and\ninteracting.\n\nSo head to the [demo.md](demo.md) file and follow the instructions there.\n\n### Cleanup\n\nAfter the workshop, you can run the cleanup script to remove all the resources created during the workshop.\n\n```bash\n./cleanup.sh\n```\n\n### זמן למסיבה \n\nCongratulations! You have successfully completed the workshop. We hope you enjoyed it and learned something new.\n\n## Troubleshooting Tips\n\nIf you encounter any challenges during the workshops, consider the following steps in order:\n\n1. Don't hesitate to reach out to us! We are here to assist and get you back on track.\n1. Review the example code available [here](https://github.com/dirien/backstage-demo.git).\n1. Search for the error on Google. Honestly, this method often provides the most insightful solutions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirien%2Fbackstage-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdirien%2Fbackstage-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirien%2Fbackstage-demo/lists"}