Cookie Consent by Free Privacy Policy Generator 📌 GitHub: Create your own repository landscape ⭐️


✅ GitHub: Create your own repository landscape ⭐️


💡 Newskategorie: Programmierung
🔗 Quelle: dev.to

Overview 👋

Do you want to create a central repository to showcase all your highlighted repositories with descriptions and stars? Something like this:
example.3.repo

I've created the repository landscape template tungbq/repos that can help you build your own repository landscape.
This blog post will describe the features and guide you on how to use this repository template to create your own repository landscape.

Key Features 🚀

The tungbq/repos repository template provides some features that help you create your repo landscape content automatically:

  • Supports defining the list of repositories to be shown in the landscape, file repository_list.txt.
  • Automated script to generate content from the repository_list.txt.
  • A GitHub Action CI pipeline to generate new repository landscape content:
    • Triggers the automated generation script.
    • Creates a pull request to propose the new content.
  • The repository landscape format provides:
    • Indexing with repo name title
    • Repo URL
    • Repo description
    • A GitHub stars badge

Quick start 📖

This is optional; you can skip this section and jump into Configure and use the template 📘 to create your own repo.
If you want to generate the content locally, update the repository_list.txt and run this script:

git clone https://github.com/tungbq/repos.git
cd repos
./generate_content.sh repository_list.txt

Result will be similar to:

➜  repos git:(main) ✗ ./generate_content.sh repository_list.txt
Working on repo: tungbq/devops-basics, with index: 1
Working on repo: tungbq/AWSHub, with index: 2
Working on repo: tungbq/devops-toolkit, with index: 3
Working on repo: tungbq/devops-project, with index: 4
Working on repo: tungbq/aws-lab-with-terraform, with index: 5
Working on repo: tungbq/awesome-workflow, with index: 6
Working on repo: tungbq/k8sHub, with index: 7
Working on repo: tungbq/Azure-DevOps-Pipeline, with index: 8
Working on repo: tungbq/find-github-issue, with index: 9
Working on repo: tungbq/challenges, with index: 10
Working on repo: tungbq/devops-dockerfiles, with index: 11
Working on repo: tungbq/terraform-sample-project, with index: 12
Working on repo: tungbq/repos, with index: 13

Now check the README.md and you would find your repository landscape content

Configure and use the template 📘

Below are the steps to help you create and configure your own landscape repository.
In short we only need to do 4 major steps: Create new repo from template > Set up PAT > Update repository list > Merge the automated PR.
Let's dive into the detailed as below:

1. Create a new repo from the template

create-repo-from-template

  • Input your repository name to create and add a description if needed, then select Create repository.

create-repo

  • Wait for a few seconds, and your repository will be created.

2. Configure Personal Access Token (PAT) for the new repo

There is a CI workflow to automatically generate content and open a new Pull Request for your repository landscape, so setting up a PAT is required.

2.1. Generate the token

pat-generate

  • Set the expiration date (my personal choice is 90 days; you can set it to whatever you want).
  • Select only the repo scope for better security.

pat-setup

  • Then click Generate token.
  • Finally, copy or note the newly created token somewhere for later use.

2.2. Create the PAT token variable

  • Go to Settings > Secrets and variables > Actions
  • Visit: https://github.com///settings/secrets/actions
  • In the New repository secrets section, input the PAT as the name and the token.

secret-action-create

  • Once completed, you will see a result similar to this:

secret-completed

Now we are ready to trigger the CI workflow to update the repo landscape.

3. Update your repository list

  • Add your repository list to the file repository_list.txt in your repository and merge it into the main branch, for example:
tungbq/devops-basics
tungbq/AWSHub
tungbq/devops-toolkit
tungbq/devops-project
tungbq/aws-lab-with-terraform
tungbq/awesome-workflow

4. Trigger the CI pipeline

Automatically trigger on merge event to main

  • Once the repository_list.txt is merged into the main branch, the CI pipeline Update content will be triggered automatically.

ci-main-trigger

  • The CI pipeline will read the repository list and generate your new README.md content.
  • Then, it will check and create a Pull Request to propose the new repository landscape content.

pr-automated

Manual trigger (Optional)

  • You can also trigger that CI at any moment you want.
  • Go to Actions and select Update content.
  • Select "Run workflow" to trigger the CI:

action-run

5. Review and merge the PR

Once the PR is raised automatically, you just need to review and merge, and that's it! You will have your own landscape content in README.md.

pr-merge

Congratulations 🎉, you've successfully created your own repo landscape! Now check the README.md for the final result.

Advance CI configuration (Optional)

  • In the previous section, we triggered the CI pipeline to run on a merge event to main branch or manual event. You could improve that by changing the trigger event to run on a timer basis. For example, once a week or once a month. This would help us regularly check and update the landscape, keeping it up to date.
  • To do so, add your desired cron trigger to repos/.github/workflows/generate_content.yaml
on:
  schedule:
    - cron: '0 0 * * 6' # Run every Saturday at midnight
  workflow_dispatch:
  # other events as needed

If you find this repository template helpful, feel free to use it, kindly consider showing your appreciation by giving it a star ⭐️. Any star you can give me will help me grow it even more ❤️

Thank you and happy coding! 🔥

...

✅ GitHub: Create your own repository landscape ⭐️


📈 47.07 Punkte

✅ How to Initialize a Git Repository and Create a GitHub Repository Using the GitHub CLI


📈 39.84 Punkte

✅ How you can create your own custom chatbot with your own custom data using Google Gemini API all for free


📈 29.8 Punkte

✅ Use Beat Saber's Level Editor to create your own tracks with your own music


📈 29.8 Punkte

✅ Hosting your own PPA repository on GitHub


📈 28.06 Punkte

✅ 📚 How to Fork Your Own Repository on GitHub


📈 28.06 Punkte

✅ Showcase Your GitHub Profile: Contribute to the "Cool GitHub Profile README" Repository!


📈 26.47 Punkte

✅ Pong in my own language in my own graphics library in my own game


📈 25.15 Punkte

✅ Huawei releases it's own desktop PC with their own OS based on Linux and their own ARM CPU.


📈 25.15 Punkte

✅ TIL: You can create your own GitHub Actions workflow templates


📈 25.08 Punkte

✅ How to Create Your Personalized GitHub Profile Page – GitHub Profile README Guide


📈 23.49 Punkte

✅ Creating a GitHub Repository Collection Using GitHub Lists ✨


📈 23.33 Punkte

✅ Efficient GitHub Operations: Simplifying Repository Management using Github CLI


📈 23.33 Punkte

✅ Creating a GitHub Repository Collection Using GitHub Lists ✨


📈 23.33 Punkte

✅ How To Create a Repository in GitHub


📈 23.3 Punkte

✅ Create a simple Django app from scratch with PyCharm IDE and use a GitHub repository


📈 23.3 Punkte

✅ Create a C# QR Code Generator (Easy) + GitHub Repository✨


📈 23.3 Punkte

✅ How to Create a Discord Bot to Get GitHub Repository Issues


📈 23.3 Punkte

✅ Microsoft wants to let you dub videos using your own voice in your own language, new patent reveals


📈 23.04 Punkte

✅ Using Stickers on Your iPhone and How To Create Your Own


📈 21.42 Punkte

✅ Maximizing Your Music Library: How to Download YouTube Music and Create Your Own Collection


📈 21.42 Punkte

✅ Create your own ChatGPT by scraping your website


📈 21.42 Punkte

✅ Creating and using your own deb repository (not mirroring)


📈 21.26 Punkte

✅ How to set up your very own local APT repository in Ubuntu


📈 21.26 Punkte

✅ Deploying a Vite app on GitHub Pages using GitHub Actions with GitHub Secrets


📈 20.39 Punkte

✅ GitHub announces the preview of GitHub Copilot Enterprise and general availability of GitHub Copilot Chat


📈 20.39 Punkte

✅ GitHub Honors Class of 2021 with 'GitHub Yearbook' and 'GitHub Graduation' Ceremony


📈 20.39 Punkte

✅ No, GitHub's source code wasn't hacked and posted on GitHub, says GitHub CEO


📈 20.39 Punkte

✅ How to Create a GitHub Profile Readme with GitHub Actions, Profile Trophy, and Custom Icons Badges


📈 20.35 Punkte

✅ Creating your first GitHub repository: A beginner's guide


📈 19.68 Punkte

✅ Creating Your First GitHub Repository


📈 19.68 Punkte











matomo

Datei nicht gefunden!