Bicep을 사용하여 Kubernetes 클러스터 만들기
이 문서에서는 Bicep을 사용하여 Azure Local에서 Kubernetes 클러스터를 만드는 방법을 설명합니다. 워크플로는 다음과 같습니다.
- SSH 키 쌍 만들기
- Bicep을 사용하여 Azure Local 버전 23H2에서 Kubernetes 클러스터를 만듭니다. 기본적으로 클러스터는 Azure Arc에 연결됩니다.
- 배포의 유효성을 검사하고 클러스터에 연결합니다.
시작하기 전에
시작하기 전에 다음 필수 조건을 갖추고 있는지 확인합니다.
온-프레미스 인프라 관리자로부터 다음 세부 정보를 가져옵니다.
- Azure 구독 ID: 배포 및 등록에 Azure Local을 사용하는 Azure 구독 ID입니다.
- 사용자 지정 위치 이름 또는 ID: 사용자 지정 위치의 Azure Resource Manager ID입니다. 사용자 지정 위치는 Azure 로컬 클러스터 배포 중에 구성됩니다. 인프라 관리자는 사용자 지정 위치의 Resource Manager ID를 제공해야 합니다. Kubernetes 클러스터를 만들려면 이 매개 변수가 필요합니다. 인프라 관리자가 사용자 지정 위치 이름 및 리소스 그룹 이름을 제공하는 경우 리소스 관리자 ID를 가져올
az customlocation show --name "<custom location name>" --resource-group <azure resource group> --query "id" -o tsv수도 있습니다. - 논리 네트워크 이름 또는 ID: 다음 단계에 따라 생성된 Azure 로컬 논리 네트워크의 Azure Resource Manager ID입니다. 관리자는 논리 네트워크의 ID를 제공해야 합니다. Kubernetes 클러스터를 만들려면 이 매개 변수가 필요합니다. 논리 네트워크가 만들어진 리소스 그룹을 알고 있는 경우 Azure
az stack-hci-vm network lnet show --name "<lnet name>" --resource-group <azure resource group> --query "id" -o tsvResource Manager ID를 가져올 수도 있습니다.
개발 머신에 최신 버전의 Azure CLI 가 있는지 확인합니다. 을 사용하여
az upgradeAzure CLI 버전을 업그레이드할 수도 있습니다.개발 머신에 kubectl을 다운로드하고 설치합니다. Kubernetes 명령줄 도구인 kubectl을 사용하면 Kubernetes 클러스터에 대해 명령을 실행할 수 있습니다. kubectl을 사용하여 애플리케이션을 배포하고, 클러스터 리소스를 검사 및 관리하고, 로그를 볼 수 있습니다.
SSH 키 쌍 만들기
SSH 키 쌍(Azure AKS와 동일)을 만들려면 다음 절차를 사용합니다.
브라우저에서 Cloud Shell 세션 열거나 로컬 컴퓨터에서 터미널을 엽니다.
az sshkey create사용하여 SSH 키 쌍을 만듭니다.az sshkey create --name <Public_SSH_Key> --resource-group <Resource_Group_Name>또는
ssh-keygen사용하여 로컬 SSH 키 쌍을 만듭니다.ssh-keygen -t rsa -b 4096
나중에 노드 액세스 또는 문제 해결에 사용할 수 있으므로 Azure에서 SSH 키 쌍을 만드는 것이 좋습니다. SSH 키를 만드는 방법에 대한 자세한 내용은
Bicep 스크립트 다운로드 및 업데이트
Bicep 배포를 위해 AKSArc GitHub 리포지토리 에서 main.bicep 와 aksarc.bicepparam두 파일을 다운로드합니다. 필요에 따라 aksarc.bicepparam 매개 변수를 업데이트하고 main.bicep 모든 기본값이 올바른지 확인합니다.
Microsoft.HybridContainerService/provisionedClusterInstances 리소스 유형은 main.bicep파일에서 정의됩니다. 클러스터를 만들기 위해 더 많은 속성을 사용자 지정하려면 프로비전된 API 참조참조하세요.
Bicep 템플릿을 배포하세요
Azure CLI를 사용하여 Bicep 배포를 구성합니다.
az deployment group create --name BicepDeployment --resource-group <Resource_Group_Name> --parameters aksarc.bicepparam
배포 유효성 검사 및 클러스터에 연결
이제 개발 컴퓨터에서 az connectedk8s proxy 명령을 실행하여 Kubernetes 클러스터에 연결할 수 있습니다. kubectl을 사용하여 노드 및 Pod 상태를 볼 수도 있습니다. Kubernetes 클러스터에 연결에 설명된 것과 동일한 단계를 따릅니다.