Azure Static Web Apps를 다른 지역으로 재배치

이 문서에서는 Azure Static Web Apps 리소스를 다른 Azure 지역으로 재배치하는 방법을 설명합니다.

기존 Azure 리소스를 한 지역에서 다른 지역으로 이동하려는 이유는 다양합니다. 다음을 수행하려고 할 수 있습니다.

• 새 Azure 지역 활용.
• 특정 지역에서만 사용할 수 있는 기능 또는 서비스 배포.
• 내부 정책 및 거버넌스 요구 사항 충족.
• 회사 인수 합병에 부합.
• 용량 계획 요구 사항 충족.

필수 조건

재배치를 준비하기 전에 다음 필수 조건을 검토합니다.

• 대상 지역에서 Azure Static Web Apps를 사용할 수 있는지 확인합니다.

• 대상 지역에 정적 웹앱 리소스를 만들 수 있는 권한이 있는지 확인합니다.

• 조직에 적용되는 Azure Policy 지역 제한이 있는지 확인합니다.

• Azure Functions에서 제공하는 통합 API 지원을 사용하는 경우:

  • 대상 지역에서 Azure Functions의 가용성을 확인합니다.
  • 함수 API 키가 사용되고 있는지 확인합니다. 예를 들어 Key Vault를 사용하고 있나요, 아니면 애플리케이션 구성 파일의 일부로 배포하고 있나요?
  • 대상 지역에서 API 지원에 대한 배포 모델 확인: Bring Your own 함수. 두 모델 간의 차이점을 이해합니다.

• 표준 호스팅 계획이 정적 웹앱을 호스트하는 데 사용되는지 확인합니다. 호스팅 계획에 대한 자세한 내용은 Azure Static Web Apps 호스팅 계획을 참조하세요.

• 재배치에 허용되는 가동 중지 시간을 결정합니다.

• Azure Static Web App 배포에 따라 다음 종속 리소스를 배포하고 이전 대상 지역에 배포하고 구성해야 할 수 있습니다.

  • Azure Functions.
  • Azure Virtual Network
  • Azure Front Door
  • 네트워크 보안 그룹
  • Azure Private Link 서비스
  • Azure Key Vault
  • Azure Storage Account
  • Azure Application Gateway

가동 중지 시간

Azure Static 웹 사이트를 재배치하면 애플리케이션에 가동 중지 시간이 발생합니다. 가동 중지 시간은 Azure Static 웹 사이트에 대해 구현한 고가용성 패턴의 영향을 받습니다. 일반적인 패턴은 다음과 같습니다.

• 콜드 대기: 워크로드 데이터는 요구 사항에 따라 정기적으로 백업됩니다. 재해가 발생하면 워크로드가 새 Azure 지역에 다시 배포되고 데이터가 복원됩니다.
• 웜 대기: 워크로드는 BCDR(비즈니스 연속성 및 재해 복구) 지역에 배포되고 데이터는 비동기적으로 또는 동기적으로 복제됩니다. 재해가 발생할 경우 DR(재해 복구) 지역의 배포가 확장 및 확장됩니다.
• 다중 지역: 워크로드가 두 지역에 배포되고 데이터가 동기적으로 복제됩니다. 두 지역 모두 데이터의 쓰기 가능한 복사본이 있습니다. 구현은 활성/수동 또는 활성/활성일 수 있습니다.

준비

프라이빗 엔드포인트를 사용하는 배포

Static Web Apps가 프라이빗 엔드포인트와 함께 배포되는 경우 다음을 확인합니다.

• 연결 엔드포인트의 호스트 이름을 업데이트합니다.
• DNS 프라이빗 영역 또는 사용자 지정 DNS 서버에서 호스트 이름을 업데이트합니다(Private Link에만 해당).

자세한 내용은 Azure Static Web Apps에 프라이빗 엔드포인트 구성을 참조하세요.

다른 모든 배포

다른 모든 배포 유형의 경우 다음을 수행해야 합니다.

• 해당하는 경우 새 지역의 Azure Functions에서 새 Function API 키를 검색합니다.

• Azure Function에 데이터베이스에 대한 종속성이 있는 경우 DATABASE_CONNECTION_STRING이(가) 업데이트되었는지 확인합니다. 이 데이터베이스는 지역 마이그레이션 범위에 있지 않을 수 있습니다.

• 정적 웹앱의 새 호스트 이름을 가리키도록 사용자 지정 도메인을 업데이트합니다.

• Key Vault를 사용하는 경우 대상 지역에 새 Key Vault를 프로비전합니다. 해당하는 경우 Key Vault에서 함수 API 키를 업데이트합니다. 코드 또는 구성 파일에 저장되지 않는 다른 중요한 데이터는 이 Key Vault에 저장해야 합니다.

템플릿 내보내기

정적 웹앱을 설명하는 설정이 포함된 Resource Manager 템플릿을 내보내려면 다음을 수행합니다.

1. Azure Portal에 로그인합니다.

2. 정적 웹앱으로 이동합니다.

3. 왼쪽 메뉴의 Automation에서 템플릿 내보내기를 선택합니다.

   템플릿을 생성하는 데 시간이 걸릴 수 있습니다.

4. 다운로드를 선택합니다.

5. 다운로드한 .zip 파일을 찾아 원하는 폴더에 엽니다.

   이 파일에는 템플릿을 배포할 템플릿 및 스크립트가 포함된 .json 파일이 포함되어 있습니다.

6. 대상 지역을 사용하여 위치를 업데이트하는 등 템플릿에 필요한 변경을 수행합니다.

재배치

다음 단계를 사용하여 정적 웹앱을 다른 지역으로 재배치합니다.

1. 프라이빗 엔드포인트를 사용하여 재배치하는 경우 Azure Private Link 서비스를 다른 지역에 재배치하기 지침을 따릅니다.

2. 기존 Azure Functions를 정적 웹앱에 제공한 경우 Azure Functions에 대한 재배치 절차를 따릅니다.

3. 이전 섹션에서 내보내고 구성한 템플릿을 사용하여 정적 웹앱을 다시 배포합니다.

   Important

   사용자 지정 도메인을 사용하지 않는 경우 대상 지역에서 애플리케이션의 URL이 변경됩니다. 이 시나리오에서는 사용자가 URL 변경에 대해 알 수 있도록 하세요.

4. 통합 API를 사용하는 경우 Azure Functions에서 지원하는 새 통합 API를 만듭니다.

5. 리포지토리(GitHub 또는 Azure DevOps)를 다시 구성하여 대상 지역의 새로 배포된 정적 웹앱에 배포합니다. GitHub 작업 또는 Azure Pipelines를 사용하여 애플리케이션 배포를 시작합니다.

6. 콜드 대기 배포를 사용하여 클라이언트에게 새 URL에 대해 알려야 합니다. 사용자 지정 DNS 도메인을 사용하는 경우 대상 지역을 가리키도록 DNS 항목을 변경하기만 하면 됩니다. 웜 대기 배포를 사용하면 Front Door 또는 Traffic Manager와 같은 부하 분산 장치가 원본 지역에서 대상 지역으로의 정적 웹앱 마이그레이션을 처리합니다.