Render

Render는 계정 설정의 API 키로 연결합니다. 키는 저장 전에 암호화되며 에이전트는 이를 절대 보지 못합니다.

설정

1. Render Dashboard를 열고 Account Settings → API Keys로 이동합니다.
2. Create API Key를 클릭합니다.
3. 키를 복사해 Polylane에 붙여 넣습니다.
4. Polylane이 키를 검증하고 동기화를 시작합니다.

Polylane은 웹 서비스, 프라이빗 서비스, 백그라운드 워커, 크론 작업, 데이터베이스, 그리고 다른 Render 리소스를 발견합니다.

문제 해결

"Invalid API key" 오류

• 전체 키를 복사했는지 확인하세요(rnd_로 시작합니다).
• Render 대시보드에서 키가 취소되지 않았는지 확인하세요.
• 배포 훅 토큰이 아니라 API 키를 사용하고 있는지 확인하세요.

리소스 누락

• Render가 모든 것을 동기화하는 데 몇 분이 걸릴 수 있습니다.
• 계정 헤더에서 수동 Sync를 실행해 새로 고치세요.

연결 해제

Polylane에서 계정의 연결을 해제한 뒤, Render 대시보드에서 API 키를 취소하세요.

Render 연결에는 브라우저가 필요하지 않습니다: 콘솔이 호출하는 것과 같은 엔드포인트를 CI 작업에 담을 수 있습니다. 인증된 POST 하나가 연결을 만들고 첫 동기화를 시작합니다.

사전 요구 사항

• cloud_accounts:write와 cloud_accounts:read 스코프를 가진 Polylane API 키. API 키와 OAuth를 참고하세요.
• ws_로 시작하는 워크스페이스 ID. 같은 키로 GET /v1/workspaces에서 읽을 수 있습니다.
• Account Settings → API Keys의 Render API 키(rnd_로 시작).

연결 만들기

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

한 번의 호출로 키가 접근할 수 있는 모든 Render 워크스페이스가 연결됩니다. 하나만 연결하려면 선택적 ownerId(usr-… 또는 tea-…)를 전달하세요.

응답은 연결된 것을 나열하며, 첫 동기화는 이미 실행 중입니다. 나머지 흐름이 읽는 두 필드만 남기면:

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

이미 연결된 계정은 accounts 대신 failures에 들어가므로, 호출을 반복해도 연결이 중복되지 않습니다.

첫 동기화 기다리기

반환된 각 계정을 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

실패한 연결이 작업을 멈추게 하는 대신 실패시키도록 루프에 기한을 두세요. 계정이 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"

그 다음 아래 연결 해제에 설명된 대로 제공자 쪽에서 Render 자격 증명을 취소하세요.