Azure Stack Hub에 Marketplace 항목 다운로드

클라우드 운영자는 Marketplace에서 Azure Stack Hub로 항목을 다운로드하고 Azure Stack Hub 환경을 사용하여 모든 사용자가 사용할 수 있도록 할 수 있습니다. 미리 테스트되고 Azure Stack Hub에서 사용할 수 있도록 지원되는 큐레이팅된 Azure Marketplace 항목 목록에 있는 항목을 선택할 수 있습니다. 이 목록에 추가 항목이 자주 추가되므로 새 콘텐츠에 대해 계속 검사.

Marketplace 제품을 다운로드하는 데는 다음과 같은 두 가지 시나리오가 있습니다.

  • 연결이 끊어지거나 부분적으로 연결된 시나리오: Marketplace 배포 도구를 사용하여 Marketplace 항목을 다운로드하려면 인터넷에 연결되어야 합니다. 그런 다음, 연결이 끊긴 Azure Stack Hub 설치로 다운로드를 전송합니다. 이 시나리오에서는 PowerShell을 사용합니다.
  • 연결된 시나리오: Azure Stack Hub 환경이 인터넷에 연결되어 있어야 합니다. Azure Stack Hub 관리자 포털을 사용하여 항목을 찾아 다운로드합니다.

다운로드할 수 있는 마켓플레이스 항목의 전체 목록은 Azure Stack Hub에 대한 Azure Marketplace 항목을 참조하세요. Azure Stack Hub Marketplace에 대한 최근 추가, 삭제 및 업데이트 목록은 Azure Stack Hub Marketplace 변경 문서를 참조하세요.

참고

카탈로그는 Azure Stack Hub 시스템이 연결된 클라우드에 따라 달라집니다. 클라우드 환경은 Azure Stack Hub를 등록하는 데 사용하는 Azure 구독에 의해 결정됩니다.

참고

OAW(운영자 액세스 워크스테이션)를 사용하여 PEP(권한 있는 엔드포인트), 지원 시나리오를 위한 관리자 포털 및 Azure Stack Hub GitHub Tools에 액세스할 수도 있습니다. 자세한 내용은 Azure Stack Hub 운영자 액세스 워크스테이션을 참조하세요.

연결된 배포를 사용하면 관리자 포털을 사용하여 Marketplace 항목을 다운로드할 수 있습니다.

사전 요구 사항

Azure Stack Hub 배포는 인터넷에 연결되어 있어야 하며 Azure에 등록되어야 합니다.

포털을 사용하여 마켓플레이스 항목 다운로드

  1. Azure Stack Hub 관리자 포털에 로그인합니다.

  2. Marketplace 항목을 다운로드하기 전에 사용 가능한 스토리지 공간을 검토합니다. 나중에 다운로드할 항목을 선택하면 다운로드 크기를 사용 가능한 스토리지 용량과 비교할 수 있습니다. 용량이 제한된 경우 사용 가능한 공간을 관리하기 위한 옵션을 고려합니다.

    사용 가능한 공간을 검토하려면 지역 관리에서 탐색할 지역을 선택한 다음 , 리소스 공급자>스토리지로 이동합니다.

    Azure Stack Hub 관리자 포털에서 스토리지 공간 검토

  3. Azure Stack Hub Marketplace를 열고 Azure에 연결합니다. 이렇게 하려면 Marketplace 관리 서비스를 선택하고 Marketplace 항목을 선택한 다음 , Azure에서 추가를 선택합니다.

    Azure에서 마켓플레이스 항목 추가

  4. 각 품목에는 현재 사용 가능한 버전도 표시됩니다. Marketplace 항목을 둘 이상 사용할 수 있는 경우 버전 열에 다중 항목이 표시됩니다. 각 항목을 클릭하여 해당 설명 및 다운로드 크기를 포함한 추가 정보를 볼 수 있습니다.

    Marketplace 항목의 사용 가능한 버전을 보여 주는 스크린샷

  5. 항목의 버전이 다중으로 표시되는 경우 해당 항목을 선택한 다음 결과 버전 선택기 드롭다운에서 특정 버전을 선택할 수 있습니다. 이제 Microsoft는 Azure Stack 버전 또는 청구 모델과 같은 다양한 속성으로 인해 관리자가 Azure Stack과 호환되지 않는 마켓플레이스 제품을 다운로드하지 못하도록 차단하는 특성을 추가할 수 있습니다. Microsoft만 다음 특성을 추가할 수 있습니다.

    다중 버전Azure

  6. 원하는 항목을 선택하고 다운로드를 선택합니다. 다운로드 시간은 네트워크 연결에 따라 다릅니다. 다운로드가 완료되면 새 Marketplace 항목을 Azure Stack Hub 운영자 또는 사용자로 배포할 수 있습니다.

  7. 다운로드한 항목을 배포하려면 + 리소스 만들기를 선택한 다음, 범주에서 새 Marketplace 항목을 검색합니다. 다음으로, 배포 프로세스를 시작할 항목을 선택합니다. 프로세스는 마켓플레이스 항목마다 다릅니다.

Azure Stack Hub가 인터넷 연결이 제한되거나 인터넷에 연결되지 않은 경우 PowerShell 및 Marketplace 배포 도구를 사용하여 인터넷에 연결된 머신으로 Marketplace 항목을 다운로드합니다. 그런 다음, 항목을 Azure Stack Hub 환경으로 전송합니다. 연결이 끊긴 환경에서는 Azure Stack Hub 포털을 사용하여 Marketplace 항목을 다운로드할 수 없습니다.

Marketplace 배포 도구는 연결된 시나리오에서도 사용할 수 있습니다.

이 시나리오는 두 부분으로 분류됩니다.

  • 1부: Marketplace 항목에서 다운로드합니다. 인터넷에 연결된 컴퓨터에서 PowerShell을 구성하고, 배포 도구를 다운로드한 다음, Azure Marketplace에서 항목을 다운로드합니다.
  • 2부: Azure Stack Hub Marketplace에 업로드하고 게시합니다. 다운로드한 파일을 Azure Stack Hub 환경으로 이동한 후 Azure Stack Hub Marketplace에 게시합니다.

사전 요구 사항

  • 연결된 환경(Azure Stack Hub일 필요는 없음). Azure에서 제품 목록과 세부 정보를 가져오고 모든 제품을 로컬로 다운로드하려면 연결이 필요합니다. 이 작업이 완료되면 나머지 절차에서는 인터넷 연결이 필요하지 않습니다. 연결이 끊긴 환경에서 사용할 수 있도록 이전에 다운로드한 항목의 카탈로그를 만듭니다.

  • 연결이 끊긴 환경에 연결하고 필요한 모든 아티팩트를 전송하기 위한 이동식 미디어

  • 다음 필수 구성 요소를 사용하여 연결이 끊긴 Azure Stack Hub 환경:

다음 명령을 사용하여 PowerShell 갤러리 Azs.Syndication.관리 모듈을 다운로드합니다.

Install-Module -Name Azs.Syndication.Admin
Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease

Azure Stack을 등록한 후에는 Marketplace 관리 블레이드에 표시되는 다음과 같은 메시지를 무시해도 됩니다. 이러한 메시지는 연결이 끊어진 사용 사례와는 관련이 없기 때문입니다.

Marketplace 관리

Marketplace 배포 도구를 사용하여 Marketplace 항목 다운로드

연결이 끊긴 시나리오에서 Marketplace 항목을 다운로드할 때마다 Marketplace 배포 도구를 다운로드해야 합니다. 이 도구는 자주 변경되며 다운로드할 때마다 최신 버전을 사용해야 합니다.

중요

AzureRM 대신 Az 모듈을 사용하는 것이 좋습니다. 다음 예를 참조하십시오.

  1. 인터넷에 연결된 컴퓨터에서 관리자 권한으로 PowerShell 콘솔을 엽니다.

  2. Azure Stack Hub를 등록하는 데 사용한 Azure 계정을 사용하여 적절한 Azure 클라우드 및 AzureAD 디렉터리 테넌트에 로그인합니다. 계정을 추가하려면 PowerShell에서 Connect-AzAccount를 실행합니다.

    Connect-AzAccount -Environment AzureCloud -Tenant '<mydirectory>.onmicrosoft.com'
    

    Azure 계정 자격 증명을 입력하라는 메시지가 표시되고 계정 구성에 따라 2단계 인증을 사용해야 할 수 있습니다.

    참고

    세션이 만료되거나 암호가 변경되었거나 계정을 전환하려는 경우 를 사용하여 Connect-AzAccountRemove-AzAccount -Scope Process로그인하기 전에 다음 cmdlet을 실행합니다.

  3. 구독이 여러 개인 경우 다음 명령을 실행하여 등록에 사용한 구독을 선택합니다.

    Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscription
    
  4. 필수 구성 요소 단계에서 아직 수행하지 않은 경우 최신 버전의 Azure Stack Hub를 사용하는 경우 최신 버전의 Marketplace 배포 도구를 다운로드합니다.

Install-Module -Name Azs.Syndication.Admin
Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease
  1. 다운로드할 VM 이미지, 확장 또는 솔루션 템플릿과 같은 Marketplace 항목을 선택하려면 다음 명령을 실행합니다.

    $products = Select-AzsMarketplaceItem
    

    그러면 선택한 구독에서 사용할 수 있는 모든 Azure Stack 등록을 나열하는 표가 표시됩니다. Marketplace 항목을 다운로드하는 Azure Stack 환경과 일치하는 등록을 선택하고 확인을 선택합니다.

    선택한 구독에서 사용할 수 있는 모든 Azure Stack 등록 목록을 보여 주는 스크린샷

    이제 다운로드할 수 있는 모든 Marketplace 항목을 나열하는 두 번째 표가 표시됩니다. 다운로드할 항목을 선택하고 버전을 기록해 둡다. Ctrl 키를 눌러 여러 이미지를 선택할 수 있습니다. 선택한 구독에서 사용할 수 있는 모든 Azure Stack 등록의 다른 목록을 보여 주는 스크린샷

    조건 추가 옵션을 사용하여 이미지 목록을 필터링할 수도 있습니다. Azure Stack 등록 선택

    일단 선택한 후에는 확인을 선택합니다.

  2. 다운로드를 위해 선택한 Marketplace 항목의 ID가 변수에 $products 저장됩니다. 다음 명령을 사용하여 선택한 항목의 다운로드를 시작합니다. 대상 폴더 경로를 Azure Marketplace에서 다운로드한 파일을 저장할 위치로 바꿉니다.

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  3. 다운로드에 걸리는 시간은 항목의 크기에 따라 달라집니다. 다운로드가 완료되면 스크립트에 지정된 폴더에서 항목을 사용할 수 있습니다. 다운로드에는 VHD 파일(가상 머신용) 또는 .zip 파일(가상 머신 확장명 및 리소스 공급자용)이 포함됩니다. .zip 파일인 .azpkg 형식의 갤러리 패키지도 포함될 수 있습니다.

  4. 다운로드에 실패하면 다음 PowerShell cmdlet을 다시 실행하여 다시 시도할 수 있습니다.

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  5. 또한 Marketplace 항목을 Azure Stack Hub로 가져오는 컴퓨터에 복사할 수 있도록 Azs.Syndication.관리 모듈을 로컬로 내보내야 합니다.

    참고

    이 모듈을 내보내기 위한 대상 폴더는 마켓플레이스 항목을 내보낸 위치와 달라야 합니다.

    Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Azs.Syndication.Admin -Path "Destination folder path in quotes" -Force
    

PowerShell을 사용하여 다운로드 가져오기 및 Azure Stack Hub Marketplace에 게시

  1. 이전에 로컬로 다운로드한 파일을 Azure Stack Hub 환경에 연결된 컴퓨터로 이동해야 합니다. 가져오기 작업을 수행할 때는 Marketplace 배포 도구를 사용해야 하므로 Azure Stack Hub 환경에서도 이 도구를 사용할 수 있어야 합니다.

    다음 이미지는 폴더 구조 예를 보여 줍니다. D:\downloadfolder는 다운로드한 모든 Marketplace 항목을 포함합니다. 각 하위 폴더는 제품 ID로 명명된 마켓플레이스 항목(예: microsoft.custom-script-linux-arm-2.0.3)입니다. 각 하위 폴더 내에는 마켓플레이스 항목의 다운로드된 콘텐츠가 있습니다.

    Marketplace 다운로드 디렉터리 구조

  2. PowerShell을 사용하여 Azure Stack Hub에 연결의 지침에 따라 Azure Stack Hub 운영자 PowerShell 세션을 구성합니다.

  3. 기본 공급자 구독에 대한 소유자 액세스 권한이 있는 ID를 사용하여 Azure Stack Hub에 로그인합니다.

  4. 폴더의 이름을 복사합니다. 예를 들어 microsoft.dsc-arm-2.77.0과 같은 이름을 가진 폴더를 만듭니다.

  5. 다운로드한 폴더를 해당 폴더로 이동합니다. 이 시점에서 C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\original-sub-folders-are-hereC:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\productDetails.json이 있습니다.

  6. 배포 모듈을 가져온 다음, 다음 cmdlet을 실행하여 마켓플레이스 배포 도구를 시작합니다.

    Import-AzsMarketplaceItem -RepositoryDir "C:\microsoft.dsc-arm-2.77.0"
    
  7. cmdlet이 성공적으로 완료되면 Azure Stack Hub Marketplace에서 마켓플레이스 항목을 사용할 수 있어야 합니다.

다음 단계

PowerShell을 사용하여 Azure Stack Hub에 연결