ClickHouse

ClickHouse Cloud łączy się kluczem API utworzonym w ustawieniach organizacji. Klucz API należy do dokładnie jednej organizacji, więc jeden klucz łączy jedną organizację, a każda organizacja łączy się z obszarem roboczym raz. Klucze są szyfrowane przed zapisaniem, a agent nigdy ich nie widzi.

1. Otwórz ClickHouse Cloud, przejdź do API Keys swojej organizacji.
2. Kliknij New API key i wybierz rolę Developer (tylko do odczytu): Polylane podczas synchronizacji tylko czyta.
3. Skopiuj zarówno identyfikator klucza, jak i sekret klucza; sekret jest pokazywany tylko raz.
4. Wklej obie wartości do Polylane.
5. Polylane weryfikuje klucz i zaczyna synchronizację.

Polylane odkrywa twoje usługi, łącznie ze stanem, poziomem, regionem, dostawcą chmury, wersją ClickHouse, rozmiarem replik i punktami końcowymi połączeń. Nazwy hostów połączeń są używane do powiązań między chmurami, więc aplikacje, które sięgają do usługi przez zmienną środowiskową, łączą się z nią na mapie.

Monitorowanie zgłasza problem, gdy usługi pozostają zdegradowane, w stanie awarii, zatrzymane lub częściowo działające; usługi bezczynne i budzące się to zwykły cykl życia usług skalowanych do bezczynności i pozostają zdrowe. Płaszczyzna sterowania ClickHouse Cloud raportuje metryki jako bieżący snapshot bez historii, więc agenci czytają aktualne wartości na żądanie, a usługi nie mają wykresów metryk.

Rozwiązywanie problemów

Błąd "Invalid API key"

• Wymagane są zarówno identyfikator klucza, jak i sekret klucza; żaden z nich sam nie uwierzytelnia.
• Sprawdź, czy klucz nie został usunięty lub wyłączony w ustawieniach kluczy API ClickHouse Cloud.
• Klucze z datą wygaśnięcia przestają działać po jej upływie; utwórz nowy klucz i zrotuj go w Polylane.

Brakujące zasoby

• ClickHouse Cloud może potrzebować kilku minut, aby zsynchronizować wszystko.
• Wywołaj ręczną Sync z nagłówka konta, aby odświeżyć.

Limity żądań

• ClickHouse Cloud pozwala na 10 żądań API na 10 sekund na klucz. Dedykowany klucz dla Polylane pozwala nie dzielić tego budżetu z innymi narzędziami.

Odłączanie

Odłącz konto w Polylane, a potem usuń klucz API w ustawieniach organizacji ClickHouse Cloud.

Połączenie ClickHouse Cloud 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.
• Identyfikator i sekret klucza API ClickHouse Cloud z API Keys twojej organizacji, utworzone z rolą Developer (tylko do odczytu).

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": "clickhouse",
    "workspaceId": "ws_0abc123",
    "keyId": "<key-id>",
    "keySecret": "<key-secret>"
  }'

Klucz API należy do dokładnie jednej organizacji, więc jedno wywołanie łączy jedną organizację.

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": "clickhouse",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Konto, które jest już połączone, trafia do failures zamiast do accounts, 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 poświadczenie ClickHouse Cloud po stronie dostawcy, jak opisano poniżej w sekcji Disconnect.