고객님의 Azure Static Web Apps 계정에 정적 사이트 배포하기

연결 시 제공되는 기능

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

시작하기 전

Azure 구독, 사이트용 리소스 그룹, 그리고 코드가 저장된 연결된 GitHub, GitLab 또는 Bitbucket 계정이 필요합니다. Azure Static Web Apps는 저장소에서 빌드되기 때문입니다. Azure의 무료 플랜은 상업적 사용 및 앱당 두 개의 커스텀 도메인을 허용합니다.

1. Azure Static Web Apps에서 키 생성

Azure에서는 이를 서비스 주체라고 부릅니다. Microsoft Entra 관리 센터에서 Entra ID → 앱 등록 → 새 등록을 열고, 이름을 지정한 다음 등록합니다. 앱의 개요 페이지에서 응용 프로그램(클라이언트) ID와 디렉터리(테넌트) ID를 복사합니다. 그런 다음 인증서 및 비밀 → 클라이언트 비밀 → 새 클라이언트 비밀을 열고, 기간을 선택한 후 추가합니다. 비밀 값은 한 번만 표시되므로 즉시 복사하십시오.

Azure 포털에서 사용할 리소스 그룹을 연 다음, 접근 제어(IAM) → 추가 → 역할 할당 추가로 이동합니다. 기여자 역할을 선택하고 사용자, 그룹 또는 서비스 주체에 할당한 후, 이름으로 앱을 검색하여 검토 + 할당합니다. 리소스 그룹의 이름과 해당 그룹이 속한 구독 ID를 기록해 둡니다(포털에서 구독 검색).

2. 여기에 연결

대시보드에서 통합을 열고 계정 연결을 선택합니다. 그룹으로 정적 호스팅(Netlify, Vercel)을, 계정으로 Azure Static Web Apps를 선택한 후, 클라이언트 ID, Client secret, 테넌트 ID, 구독 ID 및 리소스 그룹을 입력하고 계정 연결을 누릅니다.

저장하기 전에 입력한 내용을 테스트합니다. 작동하지 않는 키는 절대 저장되지 않으며, 문제 원인이 메시지로 표시됩니다. 작동하는 키는 데이터베이스가 아닌 보안 비밀 볼트에 암호화되어 보관되며, 귀하를 포함하여 다시는 표시되지 않습니다.

다음 단계

• 정적 사이트를 생성하거나 이동할 때 이 계정이 배포 대상으로 표시됩니다.

Azure Static Web Apps는 저장소에서 빌드되므로 업로드된 빌드를 수락할 수 없습니다. 따라서 사이트 코드는 연결된 GitHub, GitLab 또는 Bitbucket 저장소에서 와야 합니다. 아직 연결하지 않은 경우 먼저 연결하십시오.

• 계정에 서비스를 생성하고, 저장소를 지정하며, 커스텀 도메인을 연결하고 배포를 트리거합니다. 도메인 페이지에는 Azure Static Web Apps에 필요한 DNS 레코드가 표시됩니다.
• 사용량과 청구는 공급업체 대시보드에서 확인할 수 있는 고객님 계정에서 관리됩니다.
• 루트 도메인은 TXT 레코드로, 서브도메인은 CNAME으로 인증되며, 도메인 페이지에 필요한 레코드가 표시됩니다.

연결되지 않는 경우

Azure에서 서비스 주체를 거부했습니다. 클라이언트 비밀이 만료되었거나(선택한 기간에 따라 항상 만료됨), 앱에 리소스 그룹에 대한 기여자 권한이 더 이상 없는 경우입니다. 두 메시지가 비슷하게 보이므로 새 비밀을 만들기 전에 역할 할당을 확인하십시오.

아무것도 찾을 수 없습니다. 구독 ID와 리소스 그룹이 역할을 할당한 대상이 맞는지, 그리고 테넌트 ID가 앱이 등록된 디렉터리인지 확인하십시오.

키가 거부되었다고 표시됩니다. 거의 다음 세 가지 중 하나입니다. 공백이나 줄 바꿈이 함께 복사된 경우, 만료된 키, 또는 복사한 후에 취소되거나 재생성된 키입니다. 새 키를 생성하여 다시 붙여넣으십시오.

연결은 되지만 나중에 문제가 발생하는 경우. 키 인증은 되지만 작업에 필요한 권한이 부족한 경우입니다. 위에 나열된 권한으로 새 키를 생성한 후, 기존 연결을 해제하고 새 키를 연결하십시오.

연결 해제

Integrations을 열고 계정을 찾아 연결 해제를 누릅니다. 그러면 저장된 키가 즉시 삭제됩니다. 이를 사용하던 항목들은 다음 작업 시 중단되며, 조용히 실패하는 대신 이에 대한 화면 메시지가 표시됩니다.

연결을 해제해도 이미 수행된 작업(계정에 변경한 레코드, 배포 또는 설정)은 취소되지 않습니다. 키 자체가 유출되었을 수 있다고 생각되는 경우 공급업체에서도 취소하십시오. 연결 해제 시 당사 사본만 제거되며 공급업체 사본은 제거되지 않습니다.