다음을 통해 공유


Visual Studio 연결된 서비스를 사용하여 Azure Storage 추가

Visual Studio를 사용하면 연결된 서비스 기능을 사용하여 Azure Storage에 다음을 연결할 수 있습니다.

  • .NET Framework 콘솔 앱
  • ASP.NET MVC(Model-View-Controller)(.NET Framework)
  • ASP.NET Core
  • .NET Core(콘솔 앱, WPF, Windows Forms, 클래스 라이브러리 포함)
  • .NET Core 작업자 역할
  • Azure Functions
  • 유니버설 Windows 플랫폼 앱
  • Xamarin
  • Cordova

연결된 서비스 기능은 필요한 모든 참조와 연결 코드를 프로젝트에 추가하고 구성 파일을 적절하게 수정합니다.

필수 조건

연결된 서비스를 사용하여 Azure Storage에 연결

  1. Visual Studio에서 새 프로젝트를 엽니다.

  2. 솔루션 탐색기에서 연결된 서비스 노드를 마우스 오른쪽 단추로 클릭하고 바로 가기 메뉴에서 연결된 서비스 추가를 선택합니다.

  3. 연결된 서비스 탭에서 서비스 종속성의 + 아이콘을 선택합니다.

  4. 종속성 추가 페이지에서 Azure Storage를 선택합니다.

    아직 로그인하지 않은 경우 Azure 계정에 로그인합니다. Azure 계정이 없으면 평가판에 등록할 수 있습니다.

  5. Azure Storage 구성 화면에서 기존 스토리지 계정을 선택하고 다음을 선택합니다.

    스토리지 계정을 만들어야 하는 경우 다음 단계로 이동합니다. 그렇지 않을 경우 6단계로 건너뜁니다.

  6. 스토리지 계정을 만들려면

    1. 대화 상자의 맨 아래쪽에 있는 스토리지 계정 만들기를 선택합니다.

    2. Azure Storage: 새로 만들기 대화 상자에 정보를 입력하고 만들기를 선택합니다.

    3. Azure Storage 대화 상자가 표시되면 새 스토리지 계정이 목록에 나타납니다. 목록에서 새 스토리지 계정을 선택하고 다음을 선택합니다.

  7. 연결 문자열 이름을 입력하고 연결 문자열을 로컬 비밀 파일에 저장할지, 아니면 Azure Key Vault에 저장할지 선택합니다.

  8. 변경 내용 요약 화면에는 프로세스를 완료할 경우 프로젝트에 적용되는 모든 수정 사항이 표시됩니다. 변경 내용이 맞으면 마침을 선택합니다.

  9. 연결된 스토리지 서비스가 프로젝트의 서비스 참조 노드 아래에 나타납니다.

  1. Visual Studio에서 새 프로젝트를 엽니다.

  2. Ctrl+Q를 누르거나 주 메뉴 모음 오른쪽에 있는 Visual Studio IDE의 검색 단추를 사용합니다.

  3. 기능 검색에서 Azure Storage를 입력하고 Azure Storage - 프로젝트 > 연결된 서비스 > 추가 > Azure Storage를 선택합니다.

    기능 검색을 사용하여 Azure Storage를 검색하는 스크린샷.

  4. 종속성에 연결 페이지에서 Azure Storage를 선택하고 다음을 선택합니다.

    종속성에 연결 - Azure Storage를 보여 주는 스크린샷.

    아직 로그인하지 않은 경우 Azure 계정에 로그인합니다. Azure 계정이 없으면 평가판에 등록할 수 있습니다.

  5. Azure Storage에 연결 화면에서 기존 스토리지 계정을 선택하고 다음을 선택합니다.

    스토리지 계정을 만들어야 하는 경우 다음 단계로 이동합니다. 그렇지 않으면 다음 단계로 건너뜁니다.

    프로젝트에 기존 스토리지 계정을 추가하는 것을 보여 주는 스크린샷.

  6. 스토리지 계정을 만들려면

    1. 녹색 더하기 기호로 새로 만들기를 선택합니다.

    2. Azure Storage: 새로 만들기 대화 상자에 정보를 입력하고 만들기를 선택합니다.

      새 Azure Storage 계정.

    3. Azure Storage 대화 상자가 표시되면 새 스토리지 계정이 목록에 나타납니다. 목록에서 새 스토리지 계정을 선택하고 다음을 선택합니다.

  7. 연결 문자열 설정 이름을 입력합니다. 설정 이름은 secrets.json 파일 또는 Azure Key Vault에 표시되는 연결 문자열 설정의 이름을 참조합니다.

    연결 스트링 지정 방법을 보여 주는 스크린샷

  8. 연결 문자열 로컬 비밀 파일, Azure Key Vault에 저장할지 또는 어디에도 저장하지 않을지 선택합니다.

    연결 설정을 저장하기 위한 선택 항목을 보여 주는 스크린샷

    주의

    Visual Studio 17.12 이전 버전의 Visual Studio를 사용하고 secrets.json 파일을 사용하도록 선택한 경우 로컬 secrets.json 파일의 연결 문자열 노출될 수 있으므로 보안 예방 조치를 취해야 합니다. Visual Studio 2022 버전 17.12 이상을 사용하는 경우 이 절차는 인증 자격 증명이 있는 연결 문자열 대신 연결 설정 값을 생성하므로 더 안전한 결과를 생성합니다.

  9. 변경 내용 요약 화면에는 프로세스를 완료할 경우 프로젝트에 적용되는 모든 수정 사항이 표시됩니다. 변경 내용이 맞으면 마침을 선택합니다.

  10. 연결된 스토리지 서비스가 프로젝트의 서비스 참조 노드 아래에 나타납니다.

인증 이해

이전 절차를 실행하면 앱이 인증을 사용하여 스토리지 계정에 액세스하도록 설정됩니다. 이 인증에 대한 연결 정보는 secrets.json 방법을 선택한 경우 로컬로 저장되거나 Azure Key Vault에 저장됩니다.

secrets.json 파일을 사용한 경우 연결된 서비스 탭의 Secrets.json 옆에 있는 세 개의 점을 사용하여 파일을 열고 메뉴를 열고 사용자 비밀 관리를 선택합니다. Visual Studio 2022 버전 17.12 이상에서는 이 파일에는 연결 문자열 자체가 아닌 보안 연결 문자열 얻기 위해 URI를 참조하는 설정이 포함되어 있습니다.

{
  "StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
  "StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
  "StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}

Visual Studio 17.12 이상에서 이러한 설정을 사용하면 인증이 자동적이고 유연합니다. Visual Studio에서 로컬로 실행하거나 디버그하는 경우 Visual Studio에서 저장한 Azure 자격 증명을 사용하여 Azure Storage 계정에 액세스합니다. 명령줄에서 앱을 시작하는 경우 먼저 Azure CLI를 사용하여 로그인해야 하며 해당 자격 증명이 자동으로 검색되고 사용됩니다. 그러나 앱이 Azure에 배포되고 Azure에서 실행되는 경우 코드 변경 없이 관리 ID를 사용합니다. 인증은 모든 호스팅 환경에서 작동합니다. Azure ID API는 연결된 모든 자격 증명을 순서대로 확인하고 검색할 때 사용하기 때문입니다. DefaultAzureCredential을 참조 하세요.

다음 단계

Azure Storage는 Blob 및 큐뿐만 아니라 다른 기능을 지원합니다.

Blob 작업에 대해 알아보려면 Blob Storage에 대한 빠른 시작을 계속 진행할 수 있지만 처음부터 시작하는 대신 Azure Blob 빠른 시작(.NET) - 코드 예제에서 시작할 수 있습니다.

큐 작업에 대해 알아보려면 Azure 큐 Strorage (.NET) - 코드 예시로 첫 걸음을 시작하세요.