QR-kódok a deploymentben: célok automatikus átállítása egy release után

Kinyomtatott QR-kódok és új címek

Egy release-nél az oldalak költöznek: a /sommerkarte helyett /karte lesz, a /produkt-a helyett /produkte/a. A weboldalon ezt átirányításokkal fogod fel. A kinyomtatott QR-kódok viszont tovább a régi címre mutatnak, az átirányítási láncok pedig minden release-zel hosszabbodnak. A Same-QR dinamikus QR-kódjainál ehelyett közvetlenül az új címre állítod át a célt.

1. lépés: hozzárendelés a repositoryban

Rögzítsd, melyik QR-kódnak hova kell mutatnia, például a qr-ziele.csv fájlban a QR-kódod mellett. Az azonosítókat egyszer kéred le a „sameqr qr list” paranccsal:

speisekarte-lx3k9a1b2;https://example.com/karte
flyer-herbst-q8w7e6r5;https://example.com/aktion/herbst

2. lépés: kulcs a pipeline-hoz

A dashboardon a Fiók, „Hozzáférés CLI-hez, szkriptekhez és ügynökökhöz” alatt hozz létre egy külön „teljes” kulcsot csak a deploymentnek, mert a célváltoztatásokhoz erre a szintre van szükség, megfelelő érvényességi idővel. Tárold titkos változóként SAMEQR_API_KEY néven a CI-dben. A CLI onnan olvassa be, anélkül hogy elmentené.

3. lépés: átállítás a release után

A sikeres deployment után egy rövid lépés fut le:

npm install -g sameqr
while IFS=";" read -r id url; do
  curl -fsS -o /dev/null "$url" || { echo "Ziel nicht erreichbar: $url"; exit 1; }
  sameqr qr update "$id" --url "$url" --yes --json || exit 1
done < qr-ziele.csv

A szkript először ellenőrzi, hogy az új cím válaszol-e, és csak utána állít át. Hiba esetén megszakad. Mivel a CI-ben senki sem ül a terminálnál, a --yes jóváhagyja a változtatást. A CLI ehhez előtte kiolvassa minden QR-kód aktuális állapotát. Fontos: az API-n keresztül óránként legfeljebb 10, naponta legfeljebb 30 célváltoztatás lehetséges. A lépés tehát egy maroknyi QR-kódhoz illik release-enként. Nagyobb átállításokhoz használd a dashboardot vagy az időzítést.

Az időzítés mint alternatíva

Ha az időpont előre rögzített, például egy hétfő reggel 9 órai launch, a Gastro Protól, illetve a Marketing Protól van időzítés: egy QR-kód egy dátumtól vagy meghatározott időpontokban másik célra irányít, a QR-kód időzónájában, legfeljebb 10 szabállyal. Ekkor a deploymentben egyáltalán nincs szükség lépésre.

Vissza, ha valami félremegy

Őrizd meg a régi hozzárendelést. A rollback ekkor ugyanaz a lépés az előző fájllal. Ezenfelül a Same-QR minden éjjel ellenőrzi az összes célt, és e-mailt küld, ha valamelyik nem érhető el.

Összegzés: miért a Same-QR

A Same-QR-rel a kinyomtatott QR-kódok a deploymented részévé válnak: egy CLI, amely minden pipeline-ba beleillik, védelem a párhuzamos felülírás ellen, időzítés a Gastro Protól, illetve a Marketing Protól, és egy éjszakai célellenőrzés hálóként. Egyetlen QR-kód sem vezet a semmibe egy release után.

Kezdj bele most: regisztrálj ingyen a sameqr.com oldalon, 20 dinamikus QR-kód tartósan ingyenes. API, CLI és MCP-szerver minden csomagban van, a dokumentáció a sameqr.com/entwickler címen található.

Gyakran ismételt kérdések