Azure Stack Hub의 Linux에 AKS 엔진 설치

아티클
12/01/2023

Kubernetes 클러스터를 배포하고 관리하기 위해 Azure Stack Hub의 Linux 머신을 사용하여 AKS 엔진을 호스트할 수 있습니다. 이 문서에서는 연결 및 연결이 끊긴 Azure Stack Hub 인스턴스 모두에 대해 클러스터를 관리하도록 클라이언트 VM을 준비하고, 설치를 검사, ASDK에서 클라이언트 VM을 설정하는 방법을 살펴봅니다.

클라이언트 VM 준비

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

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

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

연결된 환경에 설치

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

Azure Stack Hub에서 Linux VM을 만듭니다. 자세한 내용은 빠른 시작: Azure Stack Hub 포털을 사용하여 Linux 서버 VM 만들기를 참조하세요.
VM에 연결합니다.
패키지 관리자를 사용하여 다음 도구가 설치되어 있는지 검사.
- jq JSON 프로세서.
- curl - 다양한 네트워크 프로토콜을 사용하여 파일을 전송하는 도구입니다.
- openssh ssh 클라이언트입니다.
- tar TAR 보관을 사용하는 데 사용되는 도구입니다.
Azure CLI를 설치합니다. Azure CLI용 패키지는 대부분의 배포에서 사용할 수 있습니다. Linux에 Azure CLI 설치에서 지침을 찾을 수 있습니다.
AKS 엔진 및 Azure Stack 버전 매핑 테이블 테이블에서 AKS 엔진 버전을 찾습니다. AKS 기본 이미지는 Azure Stack Hub Marketplace에서 사용할 수 있어야 합니다. 명령을 실행할 때 버전을 --version v0.xx.x지정해야 합니다. 버전을 지정하지 않으면 명령은 최신 버전을 설치하며, 마켓플레이스에서 사용할 수 없는 VHD 이미지가 필요할 수 있습니다.

참고

AKS 엔진 릴리스 정보에서 AKS 엔진 버전 번호에 대한 Azure Stack Hub 매핑을 찾을 수 있습니다.

다음 명령을 실행합니다.

AKS 엔진 버전 0.73.0 이하의 경우:

sudo apt update
sudo apt install jq
curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine/master/scripts/get-akse.sh
chmod 700 get-akse.sh
./get-akse.sh --version v0.xx.x

AKS 엔진 버전 0.75.3 이상의 경우:

sudo apt update
sudo apt install jq
curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine-azurestack/master/scripts/get-akse.sh
chmod 700 get-akse.sh
./get-akse.sh --version v0.xx.x

참고

설치 방법이 실패하면 연결이 끊긴 환경에서 단계를 시도합니다.

연결이 끊긴 환경에 설치

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

인터넷에 액세스할 수 있는 컴퓨터에서:

AKS 엔진 버전 0.73.0 이하의 경우 GitHub Azure/aks-engine으로 이동합니다. Linux 컴퓨터에 대한 보관 파일(*.tar.gz)을 다운로드합니다(예: aks-engine-v0.xx.x-linux-amd64.tar.gz).

AKS 엔진 버전 0.75.3 이상의 경우 GitHub Azure/aks-engine-azurestack으로 이동합니다. 예를 들어aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz Linux 컴퓨터에 대한 보관 파일(*.tar.gz)을 다운로드합니다.

지원되는 Kubernetes 버전 테이블에서 AKS 엔진의 버전을 찾습니다.
Azure Stack Hub instance 스토리지 계정을 만들어 AKS 엔진 이진 파일을 사용하여 보관 파일(*.tar.gz)을 업로드합니다. Azure Storage Explorer 사용에 대한 지침은 Azure Stack Hub를 사용한 Azure Storage Explorer 참조하세요.
Azure Stack Hub에서 Linux VM을 만듭니다. 자세한 내용은 빠른 시작: Azure Stack Hub 포털을 사용하여 Linux 서버 VM 만들기를 참조하세요.
보관 파일(*.tar.gz)을 업로드한 Azure Stack Hub 스토리지 계정 Blob URL에서 관리 VM에 파일을 다운로드합니다. 디렉터리에 보관 파일을 추출합니다 /usr/local/bin.
VM에 연결합니다.

다음 명령을 실행합니다.

AKS 엔진 버전 0.73.0 이하의 경우:

curl -o aks-engine-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-v0.xx.x-linux-amd64.tar.gz>
tar xvzf aks-engine-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin

AKS 엔진 버전 0.75.3 이상의 경우:

curl -o aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz>
tar xvzf aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin

설치 확인

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

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

참고

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

aks-engine version

Azure Resource Manager 엔드포인트가 자체 서명된 인증서를 사용하는 경우 컴퓨터의 신뢰할 수 있는 인증서 저장소에 루트 인증서를 명시적으로 추가해야 합니다. VM의 루트 인증서는 /var/lib/waagent/Certificates.pem 디렉터리에서 찾을 수 있습니다. 다음 명령을 사용하여 인증서 파일을 복사합니다.
```
sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt 
sudo update-ca-certificates
```

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

ASDK 설치

ASDK에서 AKS 엔진용 클라이언트 VM을 실행할 때 인증서를 추가해야 합니다.

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

다음 명령을 사용하여 인증서 파일을 복사합니다.

sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt

sudo update-ca-certificates

다음 단계

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