다음을 통해 공유

빠른 시작: Azure Cosmos DB for NoSQL 및 Azure Static Web Apps 데이터 API 작성기 사용

  • 아티클

이 빠른 시작에서는 AZD(Azure Developer CLI) 템플릿을 배포합니다. 템플릿은 데이터베이스 연결 기능을 사용하여 데이터 API 작성기를 호스트하는 Azure Static Web App을 배포합니다. 템플릿에는 솔루션의 시작점으로 사용할 수 있는 샘플 애플리케이션도 포함되어 있습니다.

사전 요구 사항

팁

또는 모든 개발자 필수 구성 요소가 이미 설치된 GitHub Codespaces에서 이 빠른 시작을 엽니다. 사용자 고유의 Azure 구독을 가져오면 됩니다. GitHub 계정에는 비용 없이 스토리지 및 코어 시간의 자격이 포함됩니다. 자세한 내용은 GitHub 계정의 포함된 스토리지 및 코어 시간을 참조하세요.

GitHub Codespaces에서 열기

템플릿 배포

먼저 AZD 템플릿을 사용하여 필요한 모든 서비스를 배포합니다.

  1. 프로젝트의 루트 디렉터리에서 터미널을 엽니다.

  2. 를 사용하여 azd auth loginAzure Developer CLI 인증합니다. 도구에서 지정한 단계에 따라 기본 Azure 자격 증명을 사용하여 CLI에 인증합니다.

    azd auth login

  3. 를 사용하여 azd init 프로젝트를 초기화합니다.

    azd init --template dab-azure-cosmos-db-nosql-quickstart

    중요

    GitHub Codespaces에서 실행하는 경우 코드가 사용자 환경에 이미 복제되었으므로 인수를 안전하게 생략 --template 할 수 있습니다.

  4. 초기화하는 동안 고유한 환경 이름을 구성합니다.

    팁

    환경 이름은 대상 리소스 그룹 이름으로도 사용됩니다. 이 빠른 시작에서는 를 사용하는 msdocs-swa-dab것이 좋습니다.

  5. 를 사용하여 Azure Static Web Apps 솔루션을 배포합니다azd up. Bicep 템플릿은 지원 스토리지, ID 및 호스트 서비스와 함께 NoSQL용 Azure Cosmos DB 계정을 배포합니다. 샘플 웹 애플리케이션이 웹 호스트에 배포됩니다.

    azd up

  6. 프로비전 프로세스 중에 구독 및 원하는 위치를 선택합니다. 프로비저닝 프로세스가 완료될 때까지 기다립니다. 프로세스는 약 5분이 걸릴 수 있습니다.

  7. Azure 리소스 프로비저닝이 완료되면 템플릿은 실행 기간과 함께 SUCCESS 메시지를 출력합니다.

    SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.

데이터베이스 연결 구성

이제 Azure Static Web Apps 데이터베이스 연결 기능을 사용하여 배포된 정적 웹앱과 배포된 데이터베이스 간에 연결을 만듭니다. 이 기능은 데이터 API 작성기를 원활하게 사용하여 지정한 자격 증명을 사용하여 실행 중인 Azure Cosmos DB for NoSQL 계정에 대한 연결을 만듭니다.

  1. Azure Portal Azure Static Web App 리소스로 이동합니다.

  2. 이러한 설정을 사용하여 Azure Cosmos DB for NoSQL 계정에 데이터베이스 연결을 추가하도록 정적 웹앱을 구성합니다. 그런 다음, 연결을 선택합니다.

    값
    데이터베이스 유형 Azure Cosmos DB for NoSQL
    구독 AZD 배포에 사용한 구독 선택
    리소스 그룹 AZD 배포에 사용한 리소스 그룹(환경)을 선택합니다.
    리소스 이름 접두사를 사용하여 NoSQL 리소스에 대한 유일한 Azure Cosmos DB 선택 nosql-*
    데이터베이스 이름 cosmicworks
    인증 유형 User-assigned managed identity
    사용자 할당 관리 ID *접두사를 가진 유일한 관리 ID 리소스 선택 ua-id-*

    Azure Portal 정적 웹앱에 대한 데이터베이스 연결 페이지의 스크린샷

  3. 이제 리소스 페이지에서 찾아보기 옵션을 선택하여 실행 중인 웹 애플리케이션을 관찰합니다.

    Azure Static Web Apps 실행 중인 웹 애플리케이션의 스크린샷

정리

샘플 애플리케이션 또는 리소스가 더 이상 필요하지 않은 경우 해당 배포 및 모든 리소스를 제거합니다.

  1. Azure 구독에서 배포를 제거합니다.

    azd down

  2. GitHub Codespaces를 사용하는 경우 실행 중인 codespace를 삭제하여 스토리지 및 핵심 자격을 최대화합니다.

다음 단계

GraphQL 엔드포인트