Mercure-Hub: 4. GitHub Actions

Ši dokumentacija yra GitHub Actions ir GitLab CI vadovo dalis. Visą vadovą rasite čia: Paleiskite tikrą Mercure Hub paslaugą iš savo GitHub Actions arba GitLab CI pipeline, vykdykite testus ir automatiškai viską uždarykite.

👋 Sveiki atvykę į Stackhero dokumentaciją!

Stackhero siūlo visiškai administruojamą Mercure-Hub cloud paslaugą, sukurtą tam, kad realaus laiko duomenų perdavimas būtų paprastas ir patikimas. Jūs gaunate:

  • Neriboti užklausų ir žinučių dydžiai visiškam lankstumui.
  • Individualus domenas su integruotu HTTPS saugumu (pavyzdžiui, https://real-time.jusu-imone.com).
  • Paprasti vieno paspaudimo atnaujinimai, kad jūsų hub visada būtų naujausias be jokių rūpesčių.
  • Aukšta sparta ir stipri apsauga naudojant privačią, dedikuotą infrastruktūrą.
  • Keli regionai: 🇪🇺 Europa ir 🇺🇸 USA užtikrina mažą delsą duomenų perdavimui.

Pradėkite greitai: užtenka vos 5 minučių, kad paleistumėte savo Mercure-Hub cloud hosting aplinką ir pradėtumėte siųsti realaus laiko atnaujinimus savo aplikacijoms.

Norėdami pradėti, išsaugokite žemiau pateiktą turinį kaip .github/workflows/ci.yml. Nuo šiol kiekvienas push ir pull request vykdys testus prieš tikrą Mercure Hub instanciją.

name: CI su Mercure Hub

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    env:
      STACKHERO_TOKEN: ${{ secrets.STACKHERO_TOKEN }}
      STACK_NAME: ci-mercure-hub-${{ github.run_id }}-${{ github.run_attempt }}
      INSTANCE: "20G"   # Pakeiskite jei reikia (žr. 3 žingsnį)
      REGION: europe
    steps:
      - uses: actions/checkout@v4

      - name: Įdiegti Stackhero CLI ir klientą
        run: |
          curl -fsSL https://www.stackhero.io/install.sh | sh
          apt-get update && apt-get install -y --no-install-recommends jq curl

      - name: Sukurti Mercure Hub paslaugą
        run: |
          set -euo pipefail
          STACK_ID=$(stackhero --format=script stack-create --name="$STACK_NAME")
          echo "STACK_ID=$STACK_ID" >> "$GITHUB_ENV"
          SERVICE_ID=$(stackhero --format=script service-add \
            --stack="$STACK_ID" \
            --service-store="mercure-hub" \
            --instance="$INSTANCE" \
            --region="$REGION")
          echo "SERVICE_ID=$SERVICE_ID" >> "$GITHUB_ENV"
          stackhero service-wait-for --service="$SERVICE_ID"

      - name: Vykdyti testus prieš Mercure Hub
        run: |
          set -euo pipefail
          config=$(stackhero service-configuration-get --service="$SERVICE_ID" --format=json)
          host=$(echo "$config" | jq -r '.configuration.domain')
          # Request the hub endpoint and check it answers.
          curl -fsS -o /dev/null -w "%{http_code}" "https://$host/.well-known/mercure?topic=test" | grep -qE "^(200|400|401)$"
          echo "✅ Mercure Hub pasiekiamas iš CI."
          # Čia galite paleisti savo testų rinkinį naudodami aukščiau gautus prisijungimo duomenis ...

      - name: Išvalymas (visada, net jei įvyksta klaida)
        if: always()
        run: |
          if [ -n "${SERVICE_ID:-}" ]; then
            stackhero service-delete --service="$SERVICE_ID" --confirm
            stackhero service-wait-for --service="$SERVICE_ID"
          fi
          if [ -n "${STACK_ID:-}" ]; then
            stackhero stack-delete --stack="$STACK_ID" --confirm
          fi

Teardown žingsnis naudoja if: always(), todėl jis bus vykdomas visada, užtikrinant, kad jūsų Mercure Hub instancija bus ištrinta ir jums nebus skaičiuojami mokesčiai už nenaudojamus resursus.