다음을 통해 공유


Azure Stack Hub의 Linux에 AKS 엔진 설치

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

클라이언트 VM 준비

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

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

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

연결된 환경에 설치

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

  1. Azure Stack Hub에서 Linux VM을 만듭니다. 자세한 내용은 빠른 시작: Azure Stack Hub 포털을 사용하여 Linux 서버 VM 만들기를 참조하세요.

  2. VM에 연결합니다.

  3. 패키지 관리자를 사용하여 다음 도구가 설치되어 있는지 검사.

    • jq JSON 프로세서.
    • curl - 다양한 네트워크 프로토콜을 사용하여 파일을 전송하는 도구입니다.
    • openssh ssh 클라이언트입니다.
    • tar TAR 보관을 사용하는 데 사용되는 도구입니다.
  4. Azure CLI를 설치합니다. Azure CLI용 패키지는 대부분의 배포에서 사용할 수 있습니다. Linux에 Azure CLI 설치에서 지침을 찾을 수 있습니다.

  5. AKS 엔진 및 Azure Stack 버전 매핑 테이블 테이블에서 AKS 엔진 버전을 찾습니다. AKS 기본 이미지는 Azure Stack Hub Marketplace에서 사용할 수 있어야 합니다. 명령을 실행할 때 버전을 --version v0.xx.x지정해야 합니다. 버전을 지정하지 않으면 명령은 최신 버전을 설치하며, 마켓플레이스에서 사용할 수 없는 VHD 이미지가 필요할 수 있습니다.

    참고

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

  6. 다음 명령을 실행합니다.

    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 클러스터를 관리할 수 있습니다.

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

    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 엔진의 버전을 찾습니다.

  2. Azure Stack Hub instance 스토리지 계정을 만들어 AKS 엔진 이진 파일을 사용하여 보관 파일(*.tar.gz)을 업로드합니다. Azure Storage Explorer 사용에 대한 지침은 Azure Stack Hub를 사용한 Azure Storage Explorer 참조하세요.

  3. Azure Stack Hub에서 Linux VM을 만듭니다. 자세한 내용은 빠른 시작: Azure Stack Hub 포털을 사용하여 Linux 서버 VM 만들기를 참조하세요.

  4. 보관 파일(*.tar.gz)을 업로드한 Azure Stack Hub 스토리지 계정 Blob URL에서 관리 VM에 파일을 다운로드합니다. 디렉터리에 보관 파일을 추출합니다 /usr/local/bin.

  5. VM에 연결합니다.

  6. 다음 명령을 실행합니다.

    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 엔진을 설치했는지 검사.

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

참고

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

aks-engine version
  1. 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

다음 단계