Mercure-Hub: 2. Gyvavimo ciklo scenarijus
Š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.
Žemiau pateiktas pilnas scenarijus, kuris valdo visą paslaugos gyvavimo ciklą. Matysite, kad reikia tik kelių komandų – galite kopijuoti paruoštą YAML savo platformai iš žemiau esančių skyrių.
#!/bin/bash
set -euo pipefail
# STACKHERO_TOKEN pateikiamas per CI slaptą kintamąjį, CLI jį automatiškai aptinka.
stackName="ci-mercure-hub-$$" # Unikalus stack pavadinimas kiekvienam paleidimui
serviceStore="mercure-hub" # Mercure Hub paslaugos store
instance="20G" # Pakeiskite jei reikia (žr. 3 žingsnį)
region="europe" # Regiono pavadinimas (žr. stackhero regions-list)
# 1. Įdiekite CLI runner'yje
curl -fsSL https://www.stackhero.io/install.sh | sh
# 2. Įdiekite klientą, reikalingą smoke testui (jq + curl yra baziniai)
apt-get update && apt-get install -y --no-install-recommends jq curl
# 3. Sukurkite dedikuotą stack šiam paleidimui
stackId=$(stackhero --format=script stack-create --name="$stackName")
echo "Stack sukurtas: $stackId"
# 4. Pridėkite Mercure Hub ir gaukite jo service id
serviceId=$(stackhero --format=script service-add \
--stack="$stackId" \
--service-store="$serviceStore" \
--instance="$instance" \
--region="$region")
echo "Paslauga pridėta: $serviceId"
# 5. Palaukite, kol paslauga bus paleista (gali užtrukti kelias minutes)
stackhero service-wait-for --service="$serviceId"
# 6. Perskaitykite konfigūraciją (joje yra sugeneruoti prisijungimo duomenys)
config=$(stackhero service-configuration-get --service="$serviceId" --format=json)
# 7. Ištraukite reikiamus prisijungimo duomenis
host=$(echo "$config" | jq -r '.configuration.domain')
# 8. Smoke testas: 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."
Teardown žingsnis, kuris ištrina paslaugą, laukia jos pašalinimo ir tada ištrina stack, aprašytas žemiau platformai skirtuose skyriuose. Tokiu būdu visada užtikrinamas išvalymas, net jei smoke testas nepavyksta.
Stack galima ištrinti tik tada, kai jis tuščias. Visada pirmiausia ištrinkite paslaugą ir palaukite jos pašalinimo, tada ištrinkite stack. Komanda
service-wait-foružtikrina, kad paslauga būtų arba paleista, arba jau ištrinta prieš tęsiant, todėl ji tinkama ir laukimui ištrinant.