Convex

Convex เชื่อมต่อด้วย team access token ที่สร้างในแดชบอร์ด Convex team access token มีขอบเขตที่ทีมเดียวพอดี หนึ่งโทเค็นจึงเชื่อมต่อหนึ่งทีม โทเค็นถูกเข้ารหัสก่อนจัดเก็บ และเอเจนต์ไม่มีทางเห็นมัน

1. เปิด Convex dashboard ไปที่ Team Settings → Access Tokens
2. คลิก Create access token และคัดลอกค่าโทเค็น
3. วางโทเค็นใน Polylane
4. Polylane ตรวจสอบโทเค็นและเริ่มซิงก์

Polylane ค้นหาโปรเจกต์ของคุณ และภายในแต่ละโปรเจกต์ cloud deployment ของมัน: deployment แบบ production รวมถึง deployment แบบ preview, development และแบบกำหนดเอง พร้อม region, URL และ deployment class

team access token ให้สิทธิ์การจัดการทีม การซิงก์อ่านโปรเจกต์และ deployment ของคุณด้วยโทเค็นของทีม เมื่อเอเจนต์หรือการมอนิเตอร์เบื้องหลังอ่าน log ของฟังก์ชันหรือเมตริกของ deployment Polylane จะสร้าง deploy key อายุสั้นที่มีขอบเขตเฉพาะการอ่านนั้น (log view หรือ metric view) ใช้มันสำหรับการเรียกครั้งเดียว และลบทันทีหลังจากนั้น แต่ละคีย์จึงมีอายุเท่ากับการอ่านที่มันให้บริการเท่านั้น ทุกสิ่งที่ Polylane อ่านอยู่บนพื้นผิวการจัดการ: รายการโปรเจกต์และ deployment, log ของฟังก์ชัน และเมตริกของ deployment

การแก้ปัญหา

ข้อผิดพลาด "Not a team access token"

• โทเค็นที่มีขอบเขตระดับโปรเจกต์และ deploy key แสดงรายการโปรเจกต์ของทีมไม่ได้ สร้างโทเค็นใต้ Team Settings → Access Tokens
• ตรวจว่าโทเค็นไม่ได้ถูกลบในแดชบอร์ด Convex

ทรัพยากรหายไป

• deployment แบบ local รันบนเครื่องของนักพัฒนาแต่ละคนและถูกละไม่ซิงก์โดยเจตนา
• โปรเจกต์ที่สร้างโดยไม่มี deployment จะไม่แสดง deployment จนกว่าจะ deploy ครั้งแรก
• สั่งซิงก์ด้วยตัวเองเพื่อรีเฟรชเร็วกว่ารอบถัดไปตามกำหนด

Audit log

• Convex จำกัด API ของ audit log ไว้สำหรับแผนแบบเสียเงิน บนทีมแบบฟรี การอ่าน audit log คืนข้อผิดพลาดที่ชัดเจนและเอเจนต์จะใช้ log ของฟังก์ชันและกราฟบริบทแทน

การยกเลิกการเชื่อมต่อ

ยกเลิกการเชื่อมต่อบัญชีใน Polylane แล้วลบ access token จากการตั้งค่าทีม Convex ของคุณ

การเชื่อมต่อ Convex ไม่ต้องใช้เบราว์เซอร์: endpoint เดียวกับที่คอนโซลเรียกอยู่ในงาน CI ได้ POST ที่ยืนยันตัวตนแล้วครั้งเดียวสร้างการเชื่อมต่อและเริ่มการซิงก์ครั้งแรก

สิ่งที่ต้องมีก่อน

• คีย์ API ของ Polylane ที่มีสโคป cloud_accounts:write และ cloud_accounts:read ดูคีย์ API และ OAuth
• ID ของ workspace ของคุณ ซึ่งเริ่มด้วย ws_ อ่านจาก GET /v1/workspaces ด้วยคีย์เดียวกัน
• team access token ของ Convex จาก Team Settings → Access Tokens

สร้างการเชื่อมต่อ

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>"
  }'

team access token มีขอบเขตที่ทีมเดียวพอดี การเรียกครั้งเดียวจึงเชื่อมต่อหนึ่งทีม

การตอบกลับแสดงรายการสิ่งที่เชื่อมต่อแล้ว พร้อมการซิงก์ครั้งแรกที่รันอยู่ ตัดให้เหลือสองฟิลด์ที่ขั้นตอนที่เหลืออ่าน:

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

บัญชีที่เชื่อมต่ออยู่แล้วจะไปอยู่ใน failures แทน accounts การเรียกซ้ำจึงไม่มีทางทำให้การเชื่อมต่อซ้ำ

รอการซิงก์ครั้งแรก

poll แต่ละบัญชีที่คืนมาด้วย id ของมันจนกว่า status จะถึง ready (new เมื่อลงทะเบียน 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

ให้ loop มีเส้นตายเพื่อให้การเชื่อมต่อที่ล้มเหลวทำให้งานล้มเหลวแทนที่จะค้าง เมื่อบัญชี ready แล้ว ทรัพยากรของมันอยู่ในโทโพโลยีและ Polylane เริ่มการตรวจสอบครั้งแรกแล้ว

ยกเลิกการเชื่อมต่อจาก API

การลบการเชื่อมต่อหยุดทุกการซิงก์และการตรวจสอบ และลบข้อมูลรับรองที่ Polylane เก็บไว้ การเรียกต้องใช้สโคป cloud_accounts:delete:

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

จากนั้นเพิกถอนข้อมูลรับรอง Convex ฝั่งผู้ให้บริการ ตามที่อธิบายใต้ Disconnect ด้านล่าง