개인 Netlify 계정에 정적 사이트 배포하기

연동이 제공하는 기능

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

시작하기 전에

Netlify 계정. Netlify의 무료 플랜을 사용할 수 있으며, 제한 사항은 Netlify의 정책에 따릅니다. 트래픽이 많은 계정에서 가장 먼저 도달하는 제한은 대개 배포 횟수입니다. Netlify는 분당 몇 회, 하루에 약 100회의 배포를 허용합니다.

1. Netlify에서 키 생성하기

Netlify에서 Applications → Personal access tokens를 열고 New access token을 선택합니다. 이름을 입력하고 Expiration을 선택한 다음 Generate token을 누릅니다. 팀에서 SAML 싱글 사인온으로 로그인하는 경우 Allow access to my SAML-based Netlify team에 체크하고 해당 방식으로 로그인되어 있어야 합니다. 토큰을 복사하세요. Netlify는 이를 한 번만 표시합니다. 별도로 선택해야 할 권한(스코프)은 없습니다.

2. 여기서 연동하기

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

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

다음 단계

• 정적 사이트를 생성하거나 이동할 때 이 계정이 배포 타겟으로 표시됩니다. 이를 선택하면 사이트 빌드가 고객님 계정의 프로젝트로 배포됩니다.
• 커스텀 도메인이 자동으로 연결되며, 도메인 페이지에는 도메인이 새 호스트로 연결되도록 벤더에서 요구하는 DNS 레코드가 표시됩니다.
• 프로젝트, 사용량 및 비용은 고객님의 계정에 귀속되며, 벤더 대시보드에서 모든 배포 내역을 확인할 수 있습니다.

연동에 실패하는 경우

정상 작동하다가 중단된 경우. Netlify 비밀번호를 재설정하면 재설정 전에 생성된 모든 개인 액세스 토큰이 무효화되며, 토큰은 선택하신 만료일에도 만료됩니다. 새 토큰을 생성하여 연동하세요.

속도 제한(rate-limited)으로 인해 배포가 거부되는 경우. Netlify는 계정의 배포 빈도를 제한합니다. 몇 분 정도 기다리세요. 배포되지 않은 사이트는 기존 상태 그대로 유지됩니다.

키가 거부되었다는 메시지가 나오는 경우. 대개 다음 세 가지 중 하나입니다. 복사할 때 공백이나 줄 바꿈이 함께 포함된 경우, 만료된 키, 또는 복사한 후에 취소(revoked)되거나 재생성된 키. 새로 생성하여 다시 붙여넣으세요.

연동은 되지만 나중에 특정 작업이 실패하는 경우. 키 인증은 되지만 작업에 필요한 권한이 부족한 경우입니다. 위에 나열된 권한으로 새 키를 생성한 다음, 기존 연동을 해제하고 새 키로 연동하세요.

연동 해제하기

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

연동을 해제한다고 해서 이미 완료된 작업이 취소되지는 않습니다. 당사가 고객님 계정에서 변경한 레코드, 배포 또는 설정은 그대로 유지됩니다. 키 자체가 유출되었을 가능성이 있다고 생각되는 경우 벤더 쪽에서도 해당 키를 취소(revoke)하세요. 연동을 해제하면 당사가 보유한 복사본만 삭제되고 벤더 측 복사본은 삭제되지 않습니다.