AKS Edge Essentials 빠른 시작 가이드

아티클
10/16/2024

이 빠른 시작에서는 AKS(Azure Kubernetes Service) Edge Essentials 단일 컴퓨터 K3S Linux 전용 클러스터를 설정하는 방법을 설명합니다.

참고 항목

이 빠른 시작 스크립트의 목적은 평가 프로세스를 용이하게 하는 것입니다. 이 스크립트는 Azure 구독의 일회성 설정에 대해 더 높은 수준의 자격 증명이 필요합니다. 프로덕션용이 아닙니다.

필수 조건

시스템 요구 사항을 참조하세요. 이 빠른 시작에서는 최소 4.5GB RAM 무료, 4개의 vCPU 및 20GB의 사용 가능한 디스크 공간이 있는지 확인합니다.
OS 요구 사항: 컴퓨터에 Windows 10/11 IoT Enterprise/Enterprise/Pro를 설치하고 Windows를 활성화합니다. 최신 클라이언트 버전 22H2(OS 빌드 19045) 또는 Server 2022(OS 빌드 20348)를 사용하는 것이 좋습니다. 여기에서 Windows 10 또는 Windows 11 버전을 다운로드할 수 있습니다.
소프트웨어 사용에 적용되는 Microsoft 소프트웨어 사용 약관을 참조하세요. 스크립트를 AksEdgeQuickStart 사용하면 Microsoft 소프트웨어 사용 조건에 동의하고 AcceptEULA 플래그는 사용 조건에 동의함을 나타내도록 true 설정됩니다.
Azure 구독 매개 변수 가져오기: 클러스터를 Azure Arc에 연결하려면 이러한 매개 변수를 제공해야 합니다. 이러한 매개 변수를 건너뛰면 Arc 연결은 건너뛰지만 클러스터는 여전히 배포됩니다.
- 로그인 자격 증명: Azure CLI를 사용하여 Azure에 대화형으로 로그인하는 데 필요합니다. 계정에는 이러한 역할 Owner 또는 Contributor Administrator.
- 구독 ID<subscription-id>: Azure Portal에서 사용 중인 구독을 선택하고 GUID(구독 ID)를 찾습니다.
- 테넌트 ID<tenant-id>: Azure Portal에서 기본 디렉터리 페이지로 이동해야 하는 Microsoft Entra ID를 검색합니다. 테넌트 ID(GUID)를 찾습니다.
- 위치(Azure 지역) <location>: 리소스를 만들 위치입니다. 지원되는 Azure Arc enabled servers 위치 및 Azure Arc enabled Kubernetes 서비스에 대한 Azure Arc by Region을 참조하세요. 둘 다 지원되는 지역을 선택합니다.

1단계: 쉽게 배포할 수 있는 스크립트 다운로드

스크립트를 AksEdgeQuickStart.ps1 작업 폴더에 다운로드합니다. 컴퓨터의 정책 설정에 따라 스크립트 실행을 허용하기 위해 실행 및 실행 Set-ExecutionPolicy 하기 전에 파일 차단을 해제해야 할 수 있습니다.

관리자 권한 PowerShell 창을 열고 디렉터리를 작업 폴더로 변경합니다.

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStart.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStart.ps1
Unblock-File .\AksEdgeQuickStart.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force

이 스크립트는 다음 단계를 자동화합니다.

작업 폴더에서 스크립트는 Azure/AKS-Edge의 GitHub 보관 파일을 다운로드하고 AKS-Edge-main(또는 AKS-Edge-tag<>) 폴더에 압축을 풉니다. 기본적으로 현재 주 분기를 다운로드합니다.
AksEdgeAzureSetup 스크립트를 사용하여 사용자에게 Azure 자격 증명을 사용하여 Azure Portal에 로그인하라는 메시지를 표시하고 다음 작업을 수행합니다.
- Azure CLI를 설치합니다.
- 리소스 그룹 aksedge-rp를 만듭니다.
- aksedge-rp 리소스 그룹 범위로 제한된 기여자 역할을 사용하여 서비스 주체 aksedge-sp를 만듭니다. 서비스 주체가 이미 있는 경우 해당 암호를 다시 설정합니다. 이 서비스 주체는 Azure Arc에 연결하는 데 사용됩니다.
- 리소스 공급자 Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration 및 Microsoft.ExtendedLocation을 등록합니다.
다음 작업을 수행하는 Start-AideWorkflow 함수를 호출합니다.
- AKS Edge Essentials MSI를 다운로드하고 설치합니다.
- 필요한 호스트 OS 기능(Install-AksEdgeHostFeatures)을 설치합니다. Hyper-V를 사용하도록 설정하면 컴퓨터가 다시 부팅될 수 있으며 스크립트를 다시 시작해야 합니다.
- 내부 스위치를 사용하여 단일 컴퓨터 클러스터를 배포합니다(Linux 노드에만 해당).
Azure 매개 변수가 Connect-AideArc 제공되는 경우 함수를 호출합니다. 이 함수는 다음 작업을 수행합니다.
- Azure Connected Machine Agent를 설치하고 호스트 컴퓨터를 Arc for Servers에 연결합니다.
- 연결된 Kubernetes를 위해 배포된 클러스터를 Arc에 연결합니다.

팁

추가 옵션에 $aksedgeConfig 대한 스크립트의 AksEdgeQuickStart json 콘텐츠를 수정할 수 있습니다. 사용 가능한 옵션은 배포 JSON 구성을 참조하세요.

2단계: AKS Edge Essentials 배포

관리자 권한 PowerShell 프롬프트에서 스크립트를 실행합니다 AksEdgeQuickStart.ps1 . 그러면 K3s 클러스터가 표시됩니다.

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>"

K8s 버전을 설치하려면 플래그를 지정합니다 -UseK8s .

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>" -UseK8s

이 스크립트는 AKS Edge Essentials를 설치하고 Azure Arc를 사용하여 클러스터를 Azure에 연결합니다.

팁

컴퓨터에서 Hyper-V를 사용하도록 설정하지 않은 경우 빠른 시작 스크립트는 Hyper-V를 사용하도록 설정하고 컴퓨터를 다시 시작합니다. 다시 부팅한 AksEdgeQuickStart 후 스크립트를 다시 실행합니다.

3단계: 배포 확인

다음을 실행하여 배포가 성공했는지 확인합니다.
```
kubectl get nodes -o wide
kubectl get pods -A -o wide
```
다음 이미지는 K3S 클러스터의 Pod를 보여 줍니다.
리소스 그룹으로 이동하는 경우 Azure Portal에서 클러스터를 볼 수 있습니다.
왼쪽 패널에서 Kubernetes 리소스(미리 보기)에서 네임스페이스를 선택합니다.
Kubernetes 리소스를 보려면 전달자 토큰이 필요합니다.
서비스 토큰을 검색하기 위해 실행할 Get-AksEdgeManagedServiceToken 수 있습니다.
이제 클러스터에서 리소스를 볼 수 있습니다. 워크로드는 클러스터에서 실행되는 Pod를 보여 줍니다.
```
kubectl get pods --all-namespaces
```