Azure Stack 허브에 Marketplace 항목 다운로드Download Marketplace items to Azure Stack Hub

클라우드 운영자는 Marketplace에서 Azure Stack 허브에 항목을 다운로드 하 고 Azure Stack 허브 환경을 사용 하 여 모든 사용자가 사용할 수 있도록 설정할 수 있습니다.As a cloud operator, you can download items to Azure Stack Hub from the Marketplace and make them available to all users using the Azure Stack Hub environment. 선택할 수 있는 항목은 미리 테스트 되 고 Azure Stack 허브를 사용할 수 있도록 지원 되는 Azure Marketplace 항목의 목록에서 큐 레이트 합니다.The items you can choose are from a curated list of Azure Marketplace items that are pre-tested and supported to work with Azure Stack Hub. 추가 항목이이 목록에 자주 추가 되므로 새 콘텐츠를 계속 다시 확인 하세요.Additional items are frequently added to this list, so continue to check back for new content.

Marketplace 제품을 다운로드 하는 데는 두 가지 시나리오가 있습니다.There are two scenarios for downloading Marketplace products:

  • 연결이 끊어졌거나 부분적으로 연결 된 시나리오: marketplace 항목을 다운로드 하려면 marketplace 배포 도구를 사용 하 여 인터넷에 액세스 해야 합니다.Disconnected or partially connected scenario: Requires you to access the internet using the Marketplace syndication tool to download Marketplace items. 그런 다음, 연결 되지 않은 Azure Stack Hub 설치로 다운로드를 전송 합니다.Then, you transfer your downloads to your disconnected Azure Stack Hub installation. 이 시나리오에서는 PowerShell을 사용 합니다.This scenario uses PowerShell.
  • 연결 된 시나리오: Azure Stack 허브 환경을 인터넷에 연결 해야 합니다.Connected scenario: Requires your Azure Stack Hub environment to be connected to the internet. Azure Stack 허브 관리자 포털을 사용 하 여 항목을 찾아서 다운로드 합니다.You use the Azure Stack Hub administrator portal to locate and download items.

다운로드할 수 있는 Marketplace 항목의 전체 목록은 Azure Stack 허브 Azure Marketplace 항목 을 참조 하세요.See Azure Marketplace items for Azure Stack Hub for a complete list of the marketplace items you can download. Azure Stack Hub Marketplace에 대 한 최근 추가, 삭제 및 업데이트 목록은 Azure Stack Hub marketplace 변경 내용 문서를 참조 하세요.See the Azure Stack Hub Marketplace changes article for a list of recent additions, deletions, and updates to Azure Stack Hub Marketplace.

참고

카탈로그는 Azure Stack 허브 시스템이 연결 된 클라우드에 따라 달라 집니다.The catalog will be different based on the cloud your Azure Stack Hub system is connected to. 클라우드 환경은 Azure Stack 허브를 등록 하는 데 사용 하는 Azure 구독에 따라 결정 됩니다.The cloud environment is determined by the Azure subscription you use for registering your Azure Stack Hub.

참고

또한 OAW (Operator Access Workstation)를 사용 하 여 권한 있는 끝점 (PEP), 지원 시나리오에 대 한 관리자 포털 및 Azure Stack 허브 GitHub 도구에 액세스할 수 있습니다.You can also use the The Operator Access Workstation (OAW) to access the privileged endpoint (PEP), the Administrator portal for support scenarios, and Azure Stack Hub GitHub Tools. 자세한 내용은 Azure Stack 허브 운영자 액세스 워크스테이션을 참조 하세요.For more information see Azure Stack Hub Operator Access Workstation.

연결 된 배포를 사용 하면 관리자 포털을 사용 하 여 marketplace 항목을 다운로드할 수 있습니다.A connected deployment allows you to use the administrator portal to download marketplace items.

전제 조건Prerequisites

Azure Stack 허브 배포는 인터넷에 연결 되어 있고 Azure에 등록 되어 있어야 합니다.Your Azure Stack Hub deployment must have internet connectivity and be registered with Azure.

포털을 사용 하 여 marketplace 항목 다운로드Use the portal to download marketplace items

  1. Azure Stack Hub 관리자 포털에 로그인 합니다.Sign into the Azure Stack Hub administrator portal.

  2. Marketplace 항목을 다운로드 하기 전에 사용 가능한 저장소 공간을 검토 합니다.Review the available storage space before downloading marketplace items. 나중에 다운로드할 항목을 선택 하면 다운로드 크기를 사용 가능한 저장소 용량과 비교할 수 있습니다.Later, when you select items for download, you can compare the download size to your available storage capacity. 용량이 제한 된 경우 사용 가능한 공간을 관리하는 옵션을 고려 합니다.If capacity is limited, consider options for managing available space.

    사용 가능한 공간을 검토 하려면 영역 관리 에서 탐색할 지역을 선택 하 고 리소스 공급자 > 저장소 로 이동 합니다.To review available space: in Region management, select the region you want to explore and then go to Resource Providers > Storage:

    Azure Stack Hub 관리자 포털에서 저장소 공간을 검토 합니다.

  3. Azure Stack Hub Marketplace를 열고 Azure에 연결 합니다.Open Azure Stack Hub Marketplace and connect to Azure. 이렇게 하려면 marketplace 관리 서비스를 선택 하 고 marketplace 항목 을 선택한 다음, Azure에서 추가 를 선택 합니다.To do so, select the Marketplace management service, select Marketplace items, and then select Add from Azure:

    Azure에서 marketplace 항목 추가

  4. 각 줄 항목에는 현재 사용 가능한 버전만 표시 됩니다.Each line item also shows the currently available version. Marketplace 항목의 버전을 두 개 이상 사용할 수 있는 경우 버전 열에 여러 가지 버전이 표시 됩니다.If more than one version of a Marketplace item is available, the Version column shows Multiple. 각 항목을 클릭 하 여 해당 설명 및 다운로드 크기를 비롯 한 추가 정보를 볼 수 있습니다.You can click on each item to view its description and additional information, including its download size:

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

  5. 항목의 버전이 여러 개 표시 되는 경우 해당 항목을 선택 하 고 결과 버전 선택기 드롭다운에서 특정 버전을 선택할 수 있습니다.If the version of an item is shown as Multiple, you can select that item and then choose a specific version from the resulting version selector dropdown. 이제 Microsoft는 Azure Stack 버전 또는 청구 모델 등의 다양 한 속성으로 인해 관리자가 Azure Stack와 호환 되지 않는 marketplace 제품을 다운로드 하지 못하도록 차단 하는 특성을 추가할 수 있습니다.Note that Microsoft now has the ability to add attributes that block administrators from downloading marketplace products that are incompatible with their Azure Stack, due to various properties, such as the Azure Stack version or billing model. Microsoft만 다음 특성을 추가할 수 있습니다.Only Microsoft can add these attributes:

    Azure에서 추가Add from Azure

  6. 원하는 항목을 선택 하 고 다운로드 를 선택 합니다.Select the item you want, and then select Download. 다운로드 시간은 네트워크 연결에 따라 달라 집니다.Download times vary and depends on the network connectivity. 다운로드가 완료 되 면 새 마켓플레이스 항목을 Azure Stack Hub 운영자 또는 사용자로 배포할 수 있습니다.After the download completes, you can deploy the new marketplace item as either an Azure Stack Hub operator or a user.

  7. 다운로드 한 항목을 배포 하려면 + 리소스 만들기 를 선택 하 고 새 마켓플레이스 항목의 범주를 검색 합니다.To deploy the downloaded item, select + Create a resource, and then search among the categories for the new marketplace item. 그런 다음 항목을 선택 하 여 배포 프로세스를 시작 합니다.Next, select the item to begin the deployment process. 프로세스는 marketplace 항목 마다 다릅니다.The process varies for different marketplace items.

Azure Stack 허브가 제한 되거나 인터넷에 연결 되지 않은 경우 PowerShell 및 marketplace 배포 도구 를 사용 하 여 인터넷에 연결 된 컴퓨터에 marketplace 항목을 다운로드 합니다.When Azure Stack Hub has limited or no internet connectivity, you use PowerShell and the marketplace syndication tool to download the marketplace items to a machine with internet connectivity. 그런 다음 Azure Stack 허브 환경으로 항목을 전송 합니다.You then transfer the items to your Azure Stack Hub environment. 연결 되지 않은 환경에서는 Azure Stack 허브 포털을 사용 하 여 marketplace 항목을 다운로드할 수 없습니다.In a disconnected environment, you can't download marketplace items by using the Azure Stack Hub portal.

Marketplace 배포 도구는 연결 된 시나리오 에서도 사용할 수 있습니다.The marketplace syndication tool can also be used in a connected scenario.

이 시나리오는 두 부분으로 분류됩니다.There are two parts to this scenario:

  • 1 부: Marketplace 항목에서 다운로드 합니다.Part 1: Download from Marketplace items. 인터넷에 액세스할 수 있는 컴퓨터에서 PowerShell을 구성 하 고, 배포 도구를 다운로드 한 다음 Azure Marketplace에서 항목을 다운로드 합니다.On the computer with internet access, you configure PowerShell, download the syndication tool, and then download items from Azure Marketplace.
  • 2 부: Azure Stack Hub Marketplace에 업로드 및 게시 합니다.Part 2: Upload and publish to Azure Stack Hub Marketplace. 다운로드 한 파일을 Azure Stack 허브 환경으로 이동한 후 Azure Stack Hub Marketplace에 게시 합니다.You move the files you downloaded to your Azure Stack Hub environment and then publish them to Azure Stack Hub Marketplace.

전제 조건Prerequisites

  • 연결 된 환경 (Azure Stack 허브가 될 필요는 없음).A connected environment (does not have to be Azure Stack Hub). Azure에서 세부 정보를 사용 하 여 제품 목록을 가져오고 모든 항목을 로컬에서 다운로드 하려면 연결이 필요 합니다.You need connectivity to get the list of products from Azure with their details, and to download everything locally. 이 작업이 완료 되 면 프로시저의 나머지 부분에는 인터넷 연결이 필요 하지 않습니다.Once this is done, the rest of the procedure does not require internet connectivity. 이전에 오프 라인 환경에서 사용할 수 있도록 이전에 다운로드 한 항목의 카탈로그를 만듭니다.It creates a catalog of items you've previously downloaded for you to use in your disconnected environment.

  • 연결이 끊어진 환경에 연결 하 고 필요한 모든 아티팩트를 전송 하기 위한 이동식 미디어입니다.Removable media to connect to your disconnected environment and transfer all the necessary artifacts.

  • 다음 필수 구성 요소를 포함 하는 Azure Stack 허브 환경에서 분리 됨:A disconnected Azure Stack Hub environment with the following prerequisites:

다음 명령을 사용 하 여 PowerShell 갤러리에서 Azs 모듈을 다운로드 합니다.Download the Azs.Syndication.Admin module from the PowerShell Gallery using the following command:

Install-Module -Name Azs.Syndication.Admin -AllowPrerelease -PassThru

Azure Stack를 등록 한 후에는 Marketplace 관리 블레이드에 표시 되는 다음과 같은 메시지를 무시할 수 있습니다 .이는 연결이 끊어진 사용 사례와 관련이 없기 때문입니다.Once you have registered your Azure Stack, you can disregard the following message that appears on the Marketplace management blade, as this is not relevant for the disconnected use case:

Marketplace 관리

Marketplace 배포 도구를 사용 하 여 marketplace 항목 다운로드Use the marketplace syndication tool to download marketplace items

중요

연결 되지 않은 시나리오에서 marketplace 항목을 다운로드할 때마다 marketplace 배포 도구를 다운로드 해야 합니다.Be sure to download the marketplace syndication tool each time you download marketplace items in a disconnected scenario. 이 도구를 자주 변경 하 고 각 다운로드에 최신 버전을 사용 해야 합니다.Frequent changes are made to this tool and the most current version should be used for each download.

  1. 인터넷에 연결 된 컴퓨터에서 관리자 권한으로 PowerShell 콘솔을 엽니다.On a computer with an Internet connection, open a PowerShell console as an administrator.

  2. Azure Stack 허브를 등록 하는 데 사용한 Azure 계정을 사용 하 여 적절 한 Azure 클라우드 및 AzureAD directory 테 넌 트에 로그인 합니다.Sign in to the appropriate Azure cloud and AzureAD directory tenant using the Azure account that you've used to register Azure Stack Hub. 계정을 추가 하려면 PowerShell 실행에서 다음을 실행 합니다 Connect-AzAccount .To add the account, in PowerShell run Connect-AzAccount:

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

    Azure 계정 자격 증명을 입력 하 라는 메시지가 표시 되며 계정 구성에 따라 2 단계 인증을 사용 해야 할 수도 있습니다.You are prompted to enter your Azure account credentials and you might have to use two-factor authentication, depending on your account configuration.

    참고

    세션이 만료 되거나 암호가 변경 되었거나 계정을 전환 하려면를 사용 하 여 로그인 하기 전에 다음 cmdlet을 실행 합니다 Connect-AzAccount Remove-AzAccount -Scope Process .If your session expires, your password has changed, or you want to switch accounts, run the following cmdlet before you sign in using Connect-AzAccount: Remove-AzAccount -Scope Process.

  3. 구독이 여러 개인 경우 다음 명령을 실행 하 여 등록에 사용한 항목을 선택 합니다.If you have multiple subscriptions, run the following command to select the one you used for registration:

    Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscription
    
  4. 필수 조건 단계에서 아직 수행 하지 않은 경우 Marketplace 배포 도구의 최신 버전을 다운로드 합니다.If you haven't done it in the pre-requisites step already, download the latest version of the Marketplace syndication tool:

    Install-Module -Name Azs.Syndication.Admin -AllowPrerelease -PassThru
    
  5. 다운로드할 VM 이미지, 확장 또는 솔루션 템플릿과 같은 Marketplace 항목을 선택 하려면 다음 명령을 실행 합니다.To select the Marketplace items such as VM images, extensions, or solution templates to download, run the following command:

    $products = Select-AzsMarketplaceItem
    

    그러면 선택한 구독에서 사용할 수 있는 모든 Azure Stack 등록을 나열 하는 테이블이 표시 됩니다.This displays a table that lists all the Azure Stack registrations available in the selected subscription. Marketplace 항목을 다운로드 하는 Azure Stack 환경과 일치 하는 등록을 선택 하 고 확인 을 선택 합니다.Choose the registration that matches the Azure Stack environment you're downloading the marketplace items for, and select OK.

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

    이제 다운로드할 수 있는 모든 marketplace 항목을 나열 하는 두 번째 테이블이 표시 됩니다.You should now see a second table listing all the marketplace items available for download. 다운로드 하려는 항목을 선택 하 고 버전 을 기록해 둡니다.Select the item that you want to download and make a note of the Version. Ctrl 키를 눌러 여러 이미지를 선택할 수 있습니다.You can hold the Ctrl key to select multiple images. 선택한 구독에서 사용할 수 있는 모든 Azure Stack 등록의 다른 목록을 보여 주는 스크린샷Screenshot that shows another list of all the Azure Stack registrations available in the selected subscription.

    조건 추가 옵션을 사용 하 여 이미지 목록을 필터링 할 수도 있습니다.You can also filter the list of images by using the Add criteria option. Azure Stack 등록 선택Select Azure Stack Registrations

    항목을 선택 했으면 확인을 선택 합니다.Once you've made your selections, select OK.

  6. 다운로드 하도록 선택한 Marketplace 항목의 Id는 변수에 저장 됩니다 $products .The IDs for the Marketplace items you've selected for download are saved in the $products variable. 다음 명령을 사용 하 여 선택한 항목의 다운로드를 시작 합니다.Use the command below to begin downloading the selected items. 대상 폴더 경로를 Azure Marketplace에서 다운로드 한 파일을 저장할 위치로 바꿉니다.Replace the destination folder path with a location to store the files you download from Azure Marketplace:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  7. 다운로드를 수행 하는 시간은 항목의 크기에 따라 달라 집니다.The time that the download takes depends on the size of the item. 다운로드가 완료 되 면 스크립트에 지정 된 폴더에서 항목을 사용할 수 있습니다.After the download completes, the item is available in the folder that you specified in the script. 다운로드에는 VHD 파일 (가상 컴퓨터용) 또는 .zip 파일 (가상 머신 확장 및 리소스 공급자 용)이 포함 됩니다.The download includes a VHD file (for virtual machines), or a .zip file (for virtual machine extensions and resource providers). Azpkg 형식의 갤러리 패키지 (.zip 파일)도 포함 될 수 있습니다.It might also include a gallery package in the .azpkg format, which is a .zip file.

  8. 다운로드에 실패 하면 다음 PowerShell cmdlet을 다시 실행 하 여 다시 시도할 수 있습니다.If the download fails, you can try again by re-running the following PowerShell cmdlet:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  9. 또한 Azure Stack 허브로 Marketplace 항목을 가져올 컴퓨터에 복사할 수 있도록 Azs 모듈을 로컬에 내보내야 합니다.You should also export the Azs.Syndication.Admin module locally so that you can copy it over to the machine from which you are importing Marketplace items to Azure Stack Hub.

    참고

    이 모듈을 내보낼 대상 폴더는 marketplace 항목을 내보낸 위치와 달라 야 합니다.The destination folder for exporting this module should be different from the location to which you have exported the marketplace items.

    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에 게시를 가져옵니다.Import the download and publish to Azure Stack Hub Marketplace using PowerShell

  1. 이전에 로컬로 다운로드 한 파일을 Azure Stack 허브 환경에 연결 된 컴퓨터로 이동 해야 합니다.You must move the files that you have previously downloaded locally to a machine that has connectivity to your Azure Stack Hub environment. 도구를 사용 하 여 가져오기 작업을 수행 해야 하므로 Azure Stack 허브 환경 에서도 marketplace 배포 도구를 사용할 수 있어야 합니다.The marketplace syndication tool must also be available to your Azure Stack Hub environment because you need to use the tool to perform the import operation.

    다음 그림은 폴더 구조 예를 보여 줍니다.The following image shows a folder structure example. D:\downloadfolder 에는 다운로드 한 모든 marketplace 항목이 포함 되어 있습니다.D:\downloadfolder contains all the downloaded marketplace items. 각 하위 폴더는 제품 ID로 명명 된 마켓플레이스 항목 (예: 2.0.3 라이브러리가)입니다.Each subfolder is a marketplace item (for example, microsoft.custom-script-linux-arm-2.0.3), named by the product ID. 각 하위 폴더 내에는 marketplace 항목의 다운로드 된 콘텐츠가 있습니다.Inside each subfolder is the marketplace item's downloaded content.

    Marketplace 다운로드 디렉터리 구조

  2. 이 문서의 지침에 따라 Azure Stack Hub Operator PowerShell 세션을 구성 합니다.Follow the instructions in this article to configure the Azure Stack Hub Operator PowerShell session.

  3. 소유자가 "기본 공급자 구독"에 액세스할 수 있는 id를 사용 하 여 Azure Stack Hub에 로그인 합니다.Sign in to your Azure Stack Hub with an identity that has owner access to the "Default Provider Subscription".

  4. 배포 모듈을 가져온 후 다음 스크립트를 실행 하 여 marketplace 배포 도구를 시작 합니다.Import the syndication module and then launch the marketplace syndication tool by running the following script:

    Import-AzsMarketplaceItem -RepositoryDir "Source folder path in quotes"
    
  5. 스크립트가 성공적으로 완료 되 면 마켓플레이스 항목을 Azure Stack Hub Marketplace에서 사용할 수 있어야 합니다.After the script successfully completes, the marketplace items should be available in Azure Stack Hub Marketplace.