Trigger.dev

1. W Trigger.dev otwórz stronę API Keys środowiska i utwórz klucz z presetem "No restrictions".
2. Wklej klucz w Polylane i naciśnij Connect. Klucz sam wskazuje swój projekt i środowisko, więc nie ma nic więcej do wpisania.

Polylane mapuje środowisko, jego wdrożenie, zadania, harmonogramy i kolejki. Zadanie widoczne w uruchomieniach, ale nieobecne w bieżącej wersji, pozostaje na mapie i jest oznaczane. Klucze są szyfrowane, a agent nigdy ich nie widzi.

Webhooki wdrożeń i alertów

Alerty webhook Trigger.dev otwierają zgłoszenie przy nieudanym uruchomieniu i zamykają alerty wdrożeniowe przy kolejnym sukcesie. Jeden alert na środowisko:

1. Na stronie Alerts środowiska dodaj alert webhook z adresem URL z Settings konta, w sekcji Webhooks, oraz zdarzeniami "Task run failure", "Deployment failure" i "Deployment success".
2. Wklej sekret podpisu, który Trigger.dev pokazuje raz, do tej samej karty Webhooks.

Rozwiązywanie problemów

"Polylane needs a key created with the 'No restrictions' preset"

• Kluczy Trigger only, Observer, Deploy only, Task operator i Variables only nie można użyć: Polylane odczytuje tożsamość projektu przez endpoint, który może wywołać tylko klucz "No restrictions". Utwórz klucz "No restrictions" na stronie API Keys środowiska i połącz go.

"Trigger.dev did not recognize this key"

• Sprawdź, czy klucz został skopiowany w całości i nie został unieważniony.

"Dev keys only work while trigger dev runs" i "Preview keys are per branch and not supported"

• Użyj klucza prod lub staging.

Brakujące zasoby

• "Sync" w nagłówku konta odświeża przed kolejnym przebiegiem co 15 minut.

Odłączanie

Odłącz w Polylane, a następnie usuń klucz na stronie API Keys środowiska.

Połączenie Trigger.dev nie potrzebuje przeglądarki: ten sam punkt końcowy, który wywołuje konsola, mieści się w zadaniu CI. Jeden uwierzytelniony POST tworzy połączenie i uruchamia pierwszą synchronizację.

Wymagania wstępne

• Klucz API Polylane z zakresami cloud_accounts:write i cloud_accounts:read. Zobacz Klucze API i OAuth.
• Identyfikator twojego obszaru roboczego, zaczynający się od ws_. Odczytaj go z GET /v1/workspaces tym samym kluczem.
• Sekretny klucz środowiska Trigger.dev (tr_prod_sk_… lub tr_stg_sk_…) ze środowiska prod lub staging twojego projektu, w sekcji API Keys. Utwórz go z presetem No restrictions: Polylane odczytuje tożsamość projektu przez endpoint, który może wywołać tylko klucz "No restrictions", więc klucze Trigger only, Observer, Deploy only, Task operator i Variables only są odrzucane, podobnie jak klucze dev i preview.

Utwórz połączenie

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "triggerdev",
    "workspaceId": "ws_0abc123",
    "apiKey": "<environment-secret-key>"
  }'

Klucz sam wskazuje swój projekt i środowisko, a klucz należy do dokładnie jednego środowiska, więc jedno wywołanie łączy jedno środowisko: klucz prod łączy produkcję, a klucz staging łączy staging, każde jako osobne konto. Wysłanie klucza dla środowiska, które jest już połączone, zastępuje klucz konta. Nie ma przełącznika środowiska do ustawienia. Połączenie środowiska to sposób, w jaki wybierasz jego obserwację.

Odpowiedź wymienia, co zostało połączone, z już działającą pierwszą synchronizacją. Przycięta do dwóch pól, które czyta reszta przepływu:

{
  "success": true,
  "result": {
    "provider": "triggerdev",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Klucz odrzucony przez API trafia do failures zamiast do accounts, z komunikatem mówiącym dlaczego, więc powtórzenie wywołania nigdy nie duplikuje połączenia.

Poczekaj na pierwszą synchronizację

Odpytuj każde zwrócone konto po jego id, aż status osiągnie ready (new po rejestracji, syncing w trakcie napływu zasobów):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Daj pętli termin, aby nieudane połączenie kończyło zadanie błędem zamiast je zawieszać. Gdy konto jest ready, jego zasoby są w topologii, a Polylane uruchomiło pierwszą kontrolę.

Odłącz przez API

Usunięcie połączenia zatrzymuje każdą synchronizację i kontrolę oraz usuwa poświadczenia, które Polylane przechowywało. Wywołanie wymaga zakresu cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Potem odwołaj klucz Trigger.dev po stronie dostawcy, jak opisano poniżej w sekcji Disconnect.