Azure Stack Hub Marketplace에 AKS (Azure Kubernetes Services) 엔진 필수 구성 요소를 추가 합니다.Add the Azure Kubernetes Services (AKS) engine prerequisites to the Azure Stack Hub Marketplace

사용자에 대 한 AKS (Azure Kubernetes Services) 엔진을 설정할 수 있습니다.You can set up the Azure Kubernetes Services (AKS) Engine for your users. 이 문서에서 설명 하는 항목을 Azure Stack 허브에 추가 합니다.Add the items described in this article to your Azure Stack Hub. 그러면 사용자가 조정 된 단일 작업으로 Kubernetes 클러스터를 배포할 수 있습니다.Your users can then deploy a Kubernetes cluster in a single, coordinated operation. 이 문서에서는 연결 된 환경 및 연결이 끊어진 환경에서 사용자가 AKS 엔진을 사용할 수 있도록 하는 데 필요한 단계를 안내 합니다.This article walks you through the steps you need to make the AKS engine available to your users in both connected and disconnected environments. AKS 엔진은 서비스 사용자 id, marketplace, 사용자 지정 스크립트 확장 및 AKS 기본 이미지에 따라 달라 집니다.The AKS engine depends on a service principle identity, and in the marketplace, a Custom Script extension and the AKS Base Image. AKS 엔진을 사용 하려면 Azure Stack 허브 1910 이상을 실행 하 고 있어야 합니다.The AKS engine requires that you're running Azure Stack Hub 1910 or greater.

참고

AKS 엔진 릴리스 정보에서 Azure Stack 허브와 AKS 엔진 버전 번호의 매핑을 찾을 수 있습니다.You can find the mapping of Azure Stack Hub to AKS engine version number in the AKS engine release notes.

사용자의 서비스 제공 확인Check your user's service offering

사용자에 게 충분 한 공간이 있는 Azure Stack Hub에 대 한 계획, 제안 및 구독이 필요 합니다.Your users will need a plan, offer, and subscription to Azure Stack Hub with enough space. 사용자는 세 개의 마스터와 세 개의 작업자 노드로 구성 된 최대 6 대의 가상 컴퓨터 클러스터를 배포 하려는 경우가 많습니다.Users will often want to deploy clusters of up to six virtual machines, made of three masters and three worker nodes. 충분 한 할당량이 있는지 확인 하는 것이 좋습니다.You will want to make sure they have a large enough quota.

서비스 제공을 계획 하 고 설정 하는 방법에 대 한 자세한 내용은 Azure Stack 허브의 서비스 제공 개요 를 참조 하세요.If you need more information about planning and setting up a service offering, see Overview of offering services in Azure Stack Hub

서비스 사용자 및 자격 증명 만들기Create a service principal and credentials

Kubernetes 클러스터에는 Azure Stack Hub의 SPN (서비스 주체) 및 역할 기반 권한이 필요 합니다.The Kubernetes cluster will need service principal (SPN) and role-based permissions in Azure Stack Hub.

Azure AD에서 SPN 만들기Create an SPN in Azure AD

Id 관리 서비스에 Azure Active Directory (Azure AD)를 사용 하는 경우 Kubernetes 클러스터를 배포 하는 사용자에 대 한 서비스 주체를 만들어야 합니다.If you use Azure Active Directory (Azure AD) for your identity management service, you will need to create a service principal for users deploying a Kubernetes cluster. 클라이언트 암호를 사용 하 여 서비스 주체를 만듭니다.Create a service principal using a client secret. 지침은 클라이언트 암호 자격 증명을 사용 하는 서비스 주체 만들기를 참조 하세요.For instructions, see Create a service principal that uses a client secret credential.

AD FS에서 SPN 만들기Create an SPN in AD FS

Id 관리 서비스에 대해 AD FS (Active Directory 페더레이션된 서비스)를 사용 하는 경우 Kubernetes 클러스터를 배포 하는 사용자에 대 한 서비스 주체를 만들어야 합니다.If you use Active Directory Federated Services (AD FS) for your identity management service, you will need to create a service principal for users deploying a Kubernetes cluster. 클라이언트 암호를 사용 하 여 서비스 주체를 만듭니다.Create a service principal using a client secret. 지침은 클라이언트 암호를 사용 하 여 서비스 주체 만들기를 참조 하세요.For instructions, see Create a service principal using a client secret.

AKS 기본 이미지 추가Add the AKS Base Image

Azure에서 항목을 가져와 AKS 기본 이미지를 marketplace에 추가할 수 있습니다.You can add the AKS Base Image to the marketplace by getting the item from Azure. 그러나 Azure Stack 허브의 연결이 끊어지면 이러한 지침에 따라 Azure에서 marketplace 항목을 다운로드 하 여 항목을 추가 합니다.However, if your Azure Stack Hub is disconnected, use these instructions Download marketplace items from Azure to add the item. 5 단계에서 지정 된 항목을 추가 합니다.Add the item specified in step 5.

Marketplace에 다음 항목을 추가 합니다.Add the following item to the marketplace:

  1. 관리 포털에 로그인 https://adminportal.local.azurestack.external 합니다.Sign in to the Administration portal https://adminportal.local.azurestack.external.

  2. 모든 서비스를 선택 하 고 관리 범주에서 Marketplace 관리를 선택 합니다.Select All services, and then under the ADMINISTRATION category, select Marketplace management.

  3. + Azure에서 추가를선택 합니다.Select + Add from Azure.

  4. AKS Base을 입력합니다.Enter AKS Base.

  5. AKS 엔진의 버전과 일치 하는 이미지 버전을 선택 합니다.Select the image version that matches the version of the AKS engine. 지원 되는 Kubernetes 버전에서 AKS 엔진 버전에 대 한 AKS 기본 이미지의 목록을 찾을 수 있습니다.You can find listing of AKS Base Image to AKS engine version at Supported Kubernetes Versions.

    목록에서 다음을 선택 합니다.In the list, select:

    • 게시자: Azure Kubernetes 서비스Publisher: Azure Kubernetes Service
    • 제안: aksOffer: aks
    • 이름: AKS Base Ubuntu 16.04-Lts Image 배포판, 8 월 2020 (2020.09.14 또는 AKS engine에 매핑되는 버전)Name: AKS Base Ubuntu 16.04-LTS Image Distro, August 2020 (2020.09.14 or version that maps to AKS engine)
    • 버전: 2020.09.14Version: 2020.09.14
  6. 다운로드를 선택 합니다.Select Download.

사용자 지정 스크립트 확장 추가Add a Custom Script extension

Azure에서 항목을 가져와서 사용자 지정 스크립트를 marketplace에 추가할 수 있습니다.You can add the custom script to the marketplace by getting the item from Azure. 그러나 Azure Stack 허브의 연결이 끊어지면 Azure에서 marketplace 항목 다운로드 지침을 사용 하 여 항목을 추가 합니다.However, if your Azure Stack Hub is disconnected, use the instructions Download marketplace items from Azure to add the item. 5 단계에서 지정 된 항목을 추가 합니다.Add the item specified in step 5.

  1. 관리 포털을 엽니다 https://adminportal.local.azurestack.external .Open the Administration portal https://adminportal.local.azurestack.external.

  2. 모든 서비스 를 선택한 다음 관리 범주 아래에서 Marketplace 관리를 선택 합니다.Select ALL services and then under the ADMINISTRATION category, select Marketplace Management.

  3. + Azure에서 추가를선택 합니다.Select + Add from Azure.

  4. Custom Script for Linux을 입력합니다.Enter Custom Script for Linux.

  5. 다음 프로필을 사용 하 여 스크립트를 선택 합니다.Select the script with the following profile:

    • 제품: Linux 2.0에 대 한 사용자 지정 스크립트Offer: Custom Script for Linux 2.0

    • 버전: 2.0.6 (또는 최신 버전)Version: 2.0.6 (or latest version)

    • 게시자: Microsoft CorpPublisher: Microsoft Corp

      참고

      Linux 용 사용자 지정 스크립트 버전이 두 개 이상 나열 될 수 있습니다.More than one version of the Custom Script for Linux may be listed. 항목의 마지막 버전을 추가 해야 합니다.You will need to add the last version of the item.

  6. 다운로드를 선택 합니다.Select Download.

다음 단계Next steps

Azure Stack Hub의 AKS 엔진은 무엇 인가요?What is the AKS engine on Azure Stack Hub?

Azure Stack Hub의 서비스 제공 개요Overview of offering services in Azure Stack Hub