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

• Run composer config repositories.bluehost composer https://bluehost.github.io/satis
• Head over to https://bluehost.github.io/satis/ to browse available packages.

Adding A Repo

• Clone this repository: git clone git@github.com: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.