https://github.com/grantbirki/link

https://github.com/grantbirki/link

actions config link sync

Last synced: 15 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/grantbirki/link
• Owner: GrantBirki
• License: mit
• Created: 2025-02-26T22:05:46.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-02-26T23:20:22.000Z (over 1 year ago)
• Last Synced: 2025-02-26T23:22:35.900Z (over 1 year ago)
• Topics: actions, config, link, sync
• Homepage:
• Size: 5.86 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          


   


  Logo by @malohff



# link

[![link](https://github.com/GrantBirki/link/actions/workflows/link.yml/badge.svg)](https://github.com/GrantBirki/link/actions/workflows/link.yml)

[![json-yaml-validate](https://github.com/GrantBirki/link/actions/workflows/json-yaml-validate.yml/badge.svg)](https://github.com/GrantBirki/link/actions/workflows/json-yaml-validate.yml)

My personal [`action-ln`](https://github.com/nobe4/action-ln) config for linking various files between repositories.

## Usage

Here is an example of linking a file from one repository to another:

```yaml

links:

  - from:

      repo: grantbirki/ruby-template

      path: script/bootstrap

    to:

      repo: grantbirki/ldap-api

      path: script/bootstrap

```

Now this will operate in a similar manner to dependabot. If a change takes place to the `script/bootstrap` file in the `grantbirki/ruby-template` repository, the next time the `nobe4/action-ln` workflow runs, it will open a pull request to update the `script/bootstrap` file in the `grantbirki/ldap-api` repository.

## Authentication

I am using a GitHub App to authenticate through the `nobe4/action-ln` Action. This GitHub App has the following permissions:

- Contents: **Read & Write**

- Pull Requests: **Read & Write**

I have it configured to only have permissions on certain repositories. If I want to add a new repository to this configuration (to have files synced **to** it), then I need to update the list of repositories that my GitHub App has access to. This can be done on the [GitHub App settings page](https://github.com/settings/installations/61743951) (by myself only of course).

If the repository that the file is being synced **from** is private, then the GitHub App will also need to be added to that repo as well. If it is public, then no further action is needed since the GitHub App requires no extra permissions to read public repositories.