Convex

Convex, Convex panosunda oluşturulan bir ekip erişim tokenıyla bağlanır. Bir ekip erişim tokenı tam olarak tek bir ekiple kapsamlanır, bu yüzden bir token bir ekip bağlar. Tokenlar saklanmadan önce şifrelenir ve ajan onları asla görmez.

1. Convex panosunu aç, Team Settings → Access Tokens'a git.
2. Create access token'a tıkla ve token değerini kopyala.
3. Tokenı Polylane'e yapıştır.
4. Polylane tokenı doğrular ve eşitlemeye başlar.

Polylane projelerini ve her birinin içinde bulut dağıtımlarını keşfeder: üretim dağıtımı ve tüm önizleme, geliştirme ve özel dağıtımlar, bölgeleri, URL'leri ve dağıtım sınıflarıyla.

Ekip erişim tokenları ekibe yönetim erişimi verir. Eşitleme projelerini ve dağıtımlarını ekip tokenıyla okur. Ajan veya arka plan izleme bir dağıtımın işlev günlüklerini veya metriklerini okuduğunda Polylane yalnızca o okumayla (günlük görünümü veya metrik görünümü) kapsamlanmış kısa ömürlü bir deploy key basar, onu tek çağrı için kullanır ve hemen ardından siler; böylece her anahtar yalnızca hizmet ettiği okuma kadar yaşar. Polylane'in okuduğu her şey yönetim yüzeyinde durur: proje ve dağıtım listeleri, işlev günlükleri ve dağıtım metrikleri.

Sorun giderme

"Not a team access token" hatası

• Proje kapsamlı tokenlar ve deploy key'ler ekibin projelerini listeleyemez; tokenı Team Settings → Access Tokens altında oluştur.
• Tokenın Convex panosunda silinmediğini kontrol et.

Eksik kaynaklar

• Yerel dağıtımlar tekil geliştirici makinelerinde çalışır ve bilinçli olarak eşitlenmez.
• Dağıtım olmadan oluşturulan bir proje ilk dağıtıma kadar hiç dağıtım göstermez.
• Bir sonraki zamanlanmış geçişten daha erken yenilemek için elle bir eşitleme tetikle.

Denetim günlükleri

• Convex denetim günlüğü API'sini ücretli planların arkasına koyar. Ücretsiz bir ekipte denetim günlüğü okumaları net bir hata döndürür ve ajanlar işlev günlüklerine ve bağlam grafiğine geri düşer.

Bağlantıyı kesme

Hesabın Polylane ile bağlantısını kes, sonra erişim tokenını Convex ekip ayarlarından sil.

Convex'i bağlamak tarayıcı gerektirmez: konsolun çağırdığı aynı uç nokta bir CI işine sığar. Kimliği doğrulanmış tek bir POST bağlantıyı oluşturur ve ilk eşitlemeyi başlatır.

Ön koşullar

• cloud_accounts:write ve cloud_accounts:read kapsamlı bir Polylane API anahtarı. Bkz. API anahtarları ve OAuth.
• ws_ ile başlayan çalışma alanı kimliğin. Aynı anahtarla GET /v1/workspaces üzerinden oku.
• Team Settings → Access Tokens'dan bir Convex ekip erişim tokenı.

Bağlantıyı oluştur

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

Bir ekip erişim tokenı tam olarak tek bir ekiple kapsamlanır, bu yüzden bir çağrı bir ekip bağlar.

Yanıt, ilk eşitleme zaten çalışıyor halde neyin bağlandığını listeler. Akışın geri kalanının okuduğu iki alana kırpılmış hali:

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

Zaten bağlı olan bir hesap accounts yerine failures içine düşer, bu yüzden çağrıyı yinelemek asla bir bağlantıyı çoğaltmaz.

İlk eşitlemeyi bekle

Döndürülen her hesabı id değeriyle, status değeri ready olana kadar yokla (kayıtta new, kaynaklar akarken syncing):

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

Başarısız bir bağlama işi askıda bırakmak yerine başarısız kılsın diye döngüye bir son tarih ver. Hesap ready olduğunda kaynakları topolojidedir ve Polylane ilk kontrolünü başlatmıştır.

API'den bağlantıyı kes

Bağlantıyı silmek her eşitlemeyi ve kontrolü durdurur ve Polylane'in tuttuğu kimlik bilgilerini siler. Çağrı cloud_accounts:delete kapsamını gerektirir:

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

Sonra Convex kimlik bilgisini, aşağıda Bağlantıyı kesme altında anlatıldığı gibi sağlayıcı tarafında iptal et.