고유의 Vercel 팀에 정적 사이트 배포하기

연결 기능의 장점

사용자 소유의 Vercel 계정을 연결하면 Zinn® 대시보드에서 귀하의 Vercel 계정으로 정적 사이트를 게시할 수 있습니다. 프로젝트와 청구서는 고객님이 소유하며, 배포, 커스텀 도메인 및 DNS 레코드는 당사에서 처리합니다.

시작하기 전에

Vercel 계정이 필요하며, 비즈니스 또는 수익 창출 사이트의 경우 유료 팀 계정이 필요합니다. Vercel의 무료 Hobby 요금제는 Vercel 측에서 상업적 용도가 아닌 개인용으로만 제한하고 있으므로, 당사에서는 고객의 사이트를 당사의 Vercel 계정에 배치하지 않습니다. Vercel은 오직 고객님의 개인 계정에서만 사용할 수 있습니다. 당사는 Vercel에서 요금제 정보를 읽어올 수 없으므로 Hobby 계정 연결은 기술적으로 가능하지만, 비즈니스 사이트에 이를 사용하는 것은 고객님 계정의 Vercel 약관 위반이 됩니다.

1. Vercel에서 키 생성

Vercel에서 개인 계정의 Account Settings → Tokens를 열고 Create를 선택합니다. 토큰의 이름을 입력하고, 범위(scope) 드롭다운에서 프로젝트를 소유한 팀을 선택합니다. 잘못된 팀으로 범위가 지정된 토큰은 프로젝트를 확인할 수 없습니다. 만료 기한을 선택하고 Create Token을 누릅니다. 토큰은 Vercel에 한 번만 표시되므로 반드시 복사해 두십시오.

2. 여기서 계정 연결하기

대시보드에서 Integrations를 열고 Connect an account를 선택합니다. 그룹으로 Static hosting (Netlify, Vercel)을, 계정으로 Vercel을 선택하고 API token을 입력한 뒤 Connect account를 누릅니다.

저장하기 전에 입력하신 내용을 테스트합니다. 작동하지 않는 키는 절대 저장되지 않으며, 문제의 원인이 무엇인지 메시지로 안내됩니다. 작동하는 키는 당사의 데이터베이스가 아닌 보안 비밀 금고(secrets vault)에 암호화되어 보관되며, 고객님을 포함하여 다시는 표시되지 않습니다.

다음 단계

• 정적 사이트를 생성하거나 이동할 때 이 계정이 배포 대상으로 표시됩니다. 이를 선택하면 사이트 빌드가 고객님 계정의 프로젝트로 게시됩니다.
• 커스텀 도메인이 자동으로 연결되며, 도메인이 새 호스트로 연결될 수 있도록 공급업체에서 요구하는 DNS 레코드가 도메인 페이지에 표시됩니다.
• 프로젝트, 사용량 및 청구서는 고객님 계정에 속하며, 모든 배포 내역은 공급업체 대시보드에서 직접 확인할 수 있습니다.
• Vercel은 각 프로젝트에 서브도메인용 DNS 타겟을 개별 부여하므로, 임의로 추정하지 않고 Vercel에서 직접 읽어와 도메인 페이지에 정확한 레코드로 표시합니다.

연결되지 않는 경우

프로젝트가 표시되지 않습니다. 토큰의 범위가 다른 팀이나 개인 계정으로 지정된 경우입니다. 프로젝트를 소유한 팀으로 범위가 지정된 토큰을 새로 생성하십시오.

배포가 당일 중단됩니다. Hobby 요금제는 하루 배포 횟수 제한이 있습니다. 유료 팀으로 업그레이드하면 이러한 제한과 비즈니스 용도 제한이 해제됩니다.

키가 거부되었다는 메시지가 나타납니다. 거의 다음 세 가지 중 하나입니다: 복사할 때 공백이나 줄 바꿈이 포함된 경우, 만료된 키인 경우, 또는 복사한 이후에 키가 취소(revoke)되었거나 재생성된 경우입니다. 새로운 키를 생성하여 다시 붙여넣으십시오.

연결은 되지만 나중에 특정 작업이 실패합니다. 키 인증은 되었지만 해당 작업에 필요한 권한이 부족한 경우입니다. 위에 나열된 권한을 포함하여 새 키를 생성한 후, 기존 연결을 해제하고 새 키를 연결하십시오.

연결 해제

Integrations를 열고 해당 계정을 찾아 Disconnect를 누릅니다. 즉시 저장된 키가 삭제됩니다. 해당 키를 사용하던 모든 항목은 다음 작업 시점에 중지되며, 조용히 실패하는 대신 이를 의존하던 화면에 관련 상태가 표시됩니다.

연결을 해제한다고 해서 이미 완료된 작업이 취소되지는 않습니다. 당사가 고객님 계정에서 변경한 레코드, 배포 또는 설정은 그대로 유지됩니다. 키 자체가 유출되었을 가능성이 있다고 판단되는 경우, 공급업체 측에서도 해당 키를 취소(revoke)하십시오. 연결 해제 시 삭제되는 것은 당사가 보유한 복사본일 뿐 공급업체의 복사본이 아닙니다.