클러스터 관리자: Operator Nexus에서 클러스터 관리자를 관리하는 방법

아티클
02/26/2024

클러스터 관리자는 Operator Nexus 인프라 클러스터의 수명 주기를 관리하기 위해 운영자의 Azure 구독에 배포됩니다.

시작하기 전에

필요한 사항:

Azure 구독 ID - 클러스터 관리자를 만들어야 하는 Azure 구독 ID입니다(네트워크 패브릭 컨트롤러의 구독 ID와 동일해야 함).
네트워크 패브릭 컨트롤러 ID - 네트워크 패브릭 컨트롤러와 클러스터 관리자는 1:1로 연결됩니다. 클러스터 관리자와 연결된 네트워크 패브릭 컨트롤러의 리소스 ID가 필요합니다.
Log Analytics 작업 영역 ID - 로그 수집에 사용되는 Log Analytics 작업 영역의 리소스 ID입니다.
Azure 지역 - 클러스터 관리자는 네트워크 패브릭 컨트롤러와 동일한 Azure 지역에 만들어야 합니다. 이 Azure 지역은 클러스터 관리자 및 모든 연결된 Operator Nexus 인스턴스의 Location 필드에서 사용해야 합니다.

전역 인수

모든 Azure CLI 명령에 사용할 수 있는 일부 인수는 다음과 같습니다.

--debug - 디버깅 목적으로 사용되는 CLI 작업에 대한 훨씬 더 자세한 정보를 출력합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.
--help -h - 명령 및 해당 인수에 대한 CLI 참조 정보를 출력하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors - 오류만 표시하고 경고는 표시하지 않습니다.
--output -o - 출력 형식을 지정합니다. 사용 가능한 출력 형식은 Json, Jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), table(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 Json을 출력합니다.
--query - JMESPath 쿼리 언어를 사용하여 Azure 서비스에서 반환되는 출력을 필터링합니다.
--verbose - 작업 중에 Azure에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다.

클러스터 관리자 요소

Elements	설명
name, ID, location, tags, type	name: 사용자 식별 이름 ID: <리소스 ID> location: 클러스터 관리자가 만들어지는 Azure 지역입니다. 값 출처: `az account list -locations`. tags: 리소스 태그 type: Microsoft.NetworkCloud/clusterManagers
managerExtendedLocation	클러스터 관리자와 연결된 ExtendedLocation
managedResourceGroupConfiguration	관리되는 리소스 그룹에 대한 정보
fabricControllerId	이 클러스터 관리자와 1:1인 네트워크 패브릭 컨트롤러에 대한 참조
analyticsWorkspaceId	이 작업 영역은 고객과 관련된 모든 로그가 릴레이되는 위치입니다.
clusterVersions[]	ClusterAvailableVersions 개체의 목록이며, 관리자에서 지원하는 클러스터 버전입니다. 클러스터 clusterVersion 속성의 입력으로 사용됩니다.
provisioningState	성공, 실패, 취소됨, 프로비전 중, 수락됨, 업데이트 중
detailedStatus	클러스터 관리자의 상태에 대한 추가 정보를 제공하는 자세한 상태입니다.
detailedStatusMessage	현재의 detailStatus에 대한 설명 메시지입니다.

클러스터 관리자 만들기

az networkcloud clustermanager create 명령을 사용하여 클러스터 관리자를 만듭니다. 이 명령은 새 클러스터 관리자를 만들거나 클러스터 관리자가 있는 경우 해당 속성을 업데이트합니다. 여러 Azure 구독이 있는 경우 az account set 명령을 사용하여 적절한 구독 ID를 선택합니다.

az networkcloud clustermanager create \
    --name <Cluster Manager name> \
    --location <region> \
    --analytics-workspace-id <log analytics workspace ID>
    --fabric-controller-id <Fabric controller ID associated with this Cluster Manager>
    --managed-resource-group-configuration < name=<Managed Resource group Name> location=<Managed Resource group location> >
    --tags <key=value key=value>
    --resource-group <Resource Group Name>
    --subscription <subscription ID>

인수
- --name -n [필수] - 클러스터 관리자의 이름
- --fabric-controller-id [Required] - 클러스터 관리자와 연결된 네트워크 패브릭 컨트롤러의 리소스 ID
- --resource-group -g [Required] - 리소스 그룹의 이름. 기본 리소스 그룹은 az configure --defaults group=<name>을 사용하여 구성할 수 있습니다.
- --analytics-workspace-id - 로그 수집에 사용되는 Log Analytics 작업 영역의 리소스 ID
- --location -l - 위치. 클러스터 관리자가 만들어지는 Azure 지역입니다. 값 출처: az account list -locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
- --managed-resource-group-configuration - 리소스와 연결된 관리되는 리소스 그룹의 구성
  - 사용법: --managed-resource-group-configuration location=XX name=XX
  - location: 관리되는 리소스 그룹의 지역. 지정하지 않으면 부모 리소스의 지역이 선택됩니다.
  - name: 관리되는 리소스 그룹의 이름. 지정하지 않으면 고유한 이름이 자동으로 생성됩니다.
- wait/--no-wait - 명령이 완료될 때까지 기다리거나 장기 실행 작업이 완료될 때까지 기다리지 않습니다.
- --tags - 공백으로 구분된 태그: key[=value] [key[=value]...]. 기존 태그를 지우려면 ''를 사용합니다.
- --subscription - 구독의 이름 또는 ID. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

클러스터 관리자 나열/표시

list 및 show 명령은 기존 클러스터 관리자 목록 또는 특정 클러스터 관리자의 속성을 가져오는 데 사용됩니다.

리소스 그룹의 클러스터 관리자 나열

이 명령은 지정된 리소스 그룹의 클러스터 관리자를 나열합니다.

az networkcloud clustermanager list --resource-group <Azure Resource group>

구독의 클러스터 관리자 나열

이 명령은 지정된 구독의 클러스터 관리자를 나열합니다.

az networkcloud clustermanager list  --subscription <subscription ID>

클러스터 관리자 속성 표시

이 명령은 지정된 클러스터 관리자의 속성을 나열합니다.

az networkcloud clustermanager show \
    --name <Cluster Manager name> \
    --resource-group <Resource group Name>
    --subscription <subscription ID>

list 및 show 명령 인수

--name -n - 클러스터 관리자의 이름
--IDs - 하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보가 포함된 완전한 리소스 ID여야 합니다.
--resource-group -g - 리소스 그룹의 이름. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
--subscription - 구독의 이름 또는 ID. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

클러스터 관리자 업데이트

이 명령은 제공된 클러스터 관리자의 속성을 패치하거나 클러스터 관리자에 할당된 태그를 업데이트하는 데 사용됩니다. 속성 및 태그 업데이트는 독립적으로 수행할 수 있습니다.

az networkcloud clustermanager update \
    --name <Cluster Manager name> \
    --tags < <key1=value1> <key2=value2>>
    --resource-group <Resource group Name>
    --subscription <subscription ID>

인수
- --tags - 공백으로 구분된 태그: key[=value] [key[=value] ...]. 기존 태그를 지우려면 ''를 사용합니다.
- --name -n - 클러스터 관리자의 이름
- --IDs - 하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보가 포함된 완전한 리소스 ID여야 합니다.
- --resource-group -g - 리소스 그룹의 이름. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
- --subscription - 구독의 이름 또는 ID. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

클러스터 관리자 삭제

이 명령은 제공된 클러스터 관리자를 삭제하는 데 사용됩니다.

Warning

기존 연결된 네트워크 패브릭 컨트롤러가 있는 클러스터 관리자 또는 이 클러스터 관리자를 참조하는 클러스터는 삭제되지 않을 수 있습니다.

az networkcloud clustermanager delete \
    --name <Cluster Manager name> \
    --resource-group <Resource Group Name>
    --subscription <subscription ID>

인수
- --no-wait - 장기 실행 작업이 완료될 때까지 기다리지 않습니다.
- --yes -y - 확인 메시지를 표시하지 않습니다.
- --name -n - 클러스터 관리자의 이름
- --IDs - 하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보가 포함된 완전한 리소스 ID여야 합니다.
- --resource-group -g - 리소스 그룹의 이름. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
- --subscription - 구독의 이름 또는 ID. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

다음을 통해 공유