Skip to content

Latest commit

 

History

History
61 lines (47 loc) · 2.02 KB

README.md

File metadata and controls

61 lines (47 loc) · 2.02 KB
Bluehost Logo

Bluehost Satis Repository

Satis is an open-source Composer repository generator. This repository serves as Bluehost's static file-based version of Packagist and hosts the metadata of Bluehost's packages.

Usage

Adding A Repo

  • Clone this repository: git clone [email protected]:bluehost/satis.git
  • Run composer install
  • Run composer satis add <url> where <url> is the URL for the Git repo.
  • Commit changes and push.
  • In the remote repo, setup the following GitHub Action so that new releases will trigger Satis to rebuild.
name: Trigger Satis Build

on:
  release:
    types:
      - created

jobs:
  webhook:
    name: Send Webhook
    runs-on: ubuntu-latest
    steps:

    - name: Set Package
      id: package
      env:
        REPO: ${{ github.repository }}
      run: echo ::set-output name=PACKAGE::${REPO##*/}

    - name: Set Version
      id: tag
      run: echo ::set-output name=VERSION::${GITHUB_REF##*/}

    - name: Repository Dispatch
      uses: peter-evans/repository-dispatch@v1
      with:
        token: ${{ secrets.WEBHOOK_TOKEN }}
        repository: bluehost/satis
        event-type: 'Trigger Satis Build'
        client-payload: >-
          {
            "vendor": "${{ github.repository_owner }}",
            "package": "${{ steps.package.outputs.PACKAGE }}",
            "version": "${{ steps.tag.outputs.VERSION }}"
          }

You must create a personal access token with repo access and set it as the WEBHOOK_TOKEN secret on the remote repository. Also, make sure that GitHub Actions is enabled for the repository.