Azure Stack Hub의 Windows에 AKS 엔진 설치

아티클
12/01/2023

최신 버전의 AKS 엔진에 대한 이진 다운로드는 Github에서 사용할 수 있습니다. 운영 체제용 패키지를 다운로드하고 AKS 엔진 버전 0.73.0 이하의 aks-engine 파일을 추출합니다. AKS 엔진 버전 0.75.3 이상의 경우 aks-engine-azurestack 파일을 추출하고 필요에 따라 보다 편리한 CLI 사용을 위해 환경 변수에 추가합니다 $PATH .

클라이언트 VM 준비

AKS 엔진은 Kubernetes 클러스터를 배포하고 관리하는 데 사용되는 명령줄 도구입니다. Azure Stack Hub의 컴퓨터에서 엔진을 실행할 수 있습니다. 이 컴퓨터에서 AKS 엔진을 실행하여 클러스터를 실행하는 데 필요한 IaaS 리소스 및 소프트웨어를 배포합니다. 그런 다음, 엔진을 실행하는 컴퓨터를 사용하여 클러스터에서 관리 작업을 수행할 수 있습니다.

클라이언트 컴퓨터를 선택할 때 다음을 고려합니다.

재해에서 클라이언트 머신을 복구할 수 있는지 여부입니다.
클라이언트 컴퓨터에 연결하는 방법 및 컴퓨터가 클러스터와 상호 작용하는 방법

연결된 환경에 AKS 엔진 설치

클라이언트 VM을 설치하여 인터넷에 연결된 Azure Stack Hub에서 Kubernetes 클러스터를 관리할 수 있습니다.

Azure Stack Hub에서 Windows VM을 만듭니다. 자세한 내용은 빠른 시작: Azure Stack Hub 포털을 사용하여 Windows 서버 VM 만들기를 참조하세요.
VM에 연결합니다.
PowerShell 지침을 사용하여 Chocolatey를 설치합니다.

Chocolatey 웹 사이트에 따르면: Chocolatey는 apt-get 또는 yum과 같이 Windows용 패키지 관리자이지만 Windows용 패키지 관리자입니다. 필요한 애플리케이션 및 도구를 신속하게 설치하기 위한 탈중앙화 프레임워크로 설계되었습니다. 현재 PowerShell을 사용하여 배포판에서 문, 오류, 컴퓨터로 패키지를 배달하는 데 중점을 둔 NuGet 인프라를 기반으로 합니다.
Azure CLI를 설치합니다. 다운로드 링크를 선택하고 "실행"을 선택합니다. 필요에 따라 설정 단계를 선택합니다.
AKS 엔진 및 Azure Stack 버전 매핑 테이블 테이블에서 AKS 엔진 버전을 찾습니다. AKS 기본 엔진은 Azure Stack Hub Marketplace에서 사용할 수 있어야 합니다. 명령을 실행할 때 버전을 --version v0.xx.x지정해야 합니다. 버전을 지정하지 않으면 명령은 최신 버전을 설치하며, 마켓플레이스에서 사용할 수 없는 VHD 이미지가 필요할 수 있습니다.

참고

AKS 엔진 릴리스 정보에서 AKS 엔진 버전 번호에 대한 Azure Stack Hub 매핑을 찾을 수 있습니다.
관리자 권한 프롬프트에서 다음 명령을 실행하고 버전 번호를 포함합니다.

참고

AKSe 버전 0.75.3 이상의 경우 AKS 엔진을 설치하는 명령은 입니다 choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```
참고

이 설치 방법이 실패하면 아래의 연결이 끊긴 환경에 대한 단계를 시도할 수 있습니다.

연결이 끊긴 환경에서 AKS 엔진 설치

클라이언트 VM을 설치하여 인터넷에서 연결이 끊긴 Azure Stack Hub에서 Kubernetes 클러스터를 관리할 수 있습니다.

인터넷에 액세스할 수 있는 컴퓨터에서 GitHub Azure/aks-engine으로 이동합니다. Windows 컴퓨터에 대한 보관 파일(*.tar.gz)을 다운로드합니다(예: aks-engine-v0.xx.x-windows-amd64.tar.gz). 지원되는 Kubernetes 버전 테이블에서 AKS 엔진의 버전을 찾습니다.
Azure Stack Hub instance 스토리지 계정을 만들어 AKS 엔진 이진 파일을 사용하여 보관 파일(*.tar.gz)을 업로드합니다. Azure Storage Explorer 사용에 대한 지침은 Azure Stack Hub를 사용한 Azure Storage Explorer 참조하세요.
Azure Stack Hub에서 Windows VM을 만듭니다. 자세한 내용은 빠른 시작: Azure Stack Hub 포털을 사용하여 Windows 서버 VM 만들기를 참조하세요.
보관 파일(*.tar.gz)을 업로드한 Azure Stack Hub 스토리지 계정 Blob URL에서 관리 VM에 파일을 다운로드합니다. 명령 프롬프트에서 액세스할 수 있는 디렉터리에 보관 파일을 추출합니다.
VM에 연결합니다.
PowerShell 지침을 사용하여 Chocolatey를 설치합니다.
관리자 권한 프롬프트에서 다음 명령을 실행합니다. 올바른 버전 번호를 포함합니다.

참고

AKSe 버전 0.75.3 이상의 경우 AKS 엔진을 설치하는 명령은 입니다 choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```

설치 확인

클라이언트 VM이 설정되면 AKS 엔진을 설치했는지 검사.

클라이언트 VM에 연결합니다.
다음 명령을 실행합니다.

참고

AKSe 버전 0.75.3 이상의 경우 AKS 엔진의 현재 버전을 검사 명령은 입니다aks-engine-azurestack version.
```
aks-engine version
```

클라이언트 VM에 AKS 엔진을 설치했는지 확인할 수 없는 경우 AKS 엔진 설치 문제 해결을 참조하세요.

ASDK 설치

ASDK 외부 컴퓨터의 ASDK에서 AKS 엔진용 클라이언트 VM을 실행할 때 인증서를 추가해야 합니다. ASDK 환경 자체 내에서 Windows VM을 사용하는 경우 컴퓨터는 이미 ASDK 인증서를 신뢰합니다. 클라이언트 컴퓨터가 ASDK 외부에 있는 경우 ASDK에서 인증서를 추출하고 Windows 컴퓨터에 추가해야 합니다.

ASDK를 사용하는 경우 Azure Resource Manager 엔드포인트에서 자체 서명된 인증서를 사용하는 경우 이 인증서를 컴퓨터의 신뢰할 수 있는 인증서 저장소에 명시적으로 추가해야 합니다. ASDK에 배포하는 모든 VM에서 ASDK 루트 인증서를 찾을 수 있습니다.

CA 루트 인증서를 내보냅니다. 자세한 내용은 Azure Stack Hub CA 루트 인증서 내보내기를 참조하세요.
Azure Stack Hub CA 루트 인증서를 신뢰합니다. 자세한 내용은 Azure Stack Hub CA 루트 인증서 신뢰를 참조하세요.

다음 단계

Azure Stack Hub에서 AKS 엔진을 사용하여 Kubernetes 클러스터 배포