AKS용 Azure Kubernetes Application Network 시작(미리 보기)

중요합니다

AKS 미리 보기 기능은 셀프 서비스에서 사용할 수 있습니다(옵트인 방식). 미리 보기는 "있는 그대로" 및 "사용 가능한 상태로" 제공되며 서비스 수준 계약 및 제한적 보증에서 제외됩니다. AKS 미리 보기의 일부는 고객 지원팀에서 최선을 다해 지원합니다. 따라서 이러한 기능은 프로덕션 용도로 사용할 수 없습니다. 자세한 내용은 다음 지원 문서를 참조하세요.

이 문서는 AKS용 Azure Kubernetes Application Network를 시작하는 데 도움이 됩니다. Application Network 리소스를 만들고 AKS 클러스터를 멤버 클러스터로 연결하는 단계별 지침을 제공합니다.

사전 요구 사항

Azure 구독입니다. 계정이 없는 경우, 무료 계정을만드세요.
Azure CLI 버전 2.84.0 이상. az --version 명령을 사용하여 버전을 확인합니다. 설치 또는 업데이트하려면 Azure CLI 설치를 참조하세요.
기존 및 새 AKS 클러스터 모두에 대해 다음 요구 사항을 충족하는지 확인합니다. 이러한 요구 사항은 클러스터를 멤버로 조인할 때 유효성이 검사됩니다.
- Istio 기반 서비스 메시 추가 기능(ServiceMeshProfile)을 사용할 수 없습니다 . 이미 Istio 추가 기능을 사용하도록 설정된 클러스터는 Azure Kubernetes Application Network에 가입할 수 없습니다.
- AKS 관리형 Microsoft Entra 통합 사용하도록 설정됩니다.
- OIDC 발급자가 활성화되었습니다.
- 관리되는 Kubernetes 게이트웨이 API 설치 가 사용됩니다.
지원 정책을 사용하여 기존 Kubernetes 클러스터에 대한 지원을 확인합니다.

환경 변수 설정

Azure Kubernetes Application Network 리소스 및 클러스터에 대해 다음 환경 변수를 설정합니다. Azure Kubernetes Application Network에 추가 하기 전에 기존 클러스터를 사용하거나 이후 단계에서 클러스터를 만들 수 있습니다.

export SUBSCRIPTION=<subscription-id>
export LOCATION=<location>
export APPNET_RG=<resource-group-for-appnet-resource>
export APPNET_NAME=<appnet-name>
export APPNET_MEMBER_NAME=<appnet-member-name>
export AKS_RG=<aks-cluster-resource-group>
export CLUSTER_NAME=<cluster-name>

공개 미리 보기에 대한 기능 등록

명령을 사용하여 Azure Kubernetes Application Network에 대한 기능을 등록합니다 az feature register .
```
az feature register --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION
```
기능이 등록될 때까지 기다립니다. 명령을 사용하여 az feature show 상태를 확인할 수 있습니다.
```
az feature show --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION
```
등록이 완료되면 출력에서 properties.state 필드에 Registered이 표시됩니다.
Microsoft.AppLink 리소스 공급자가 등록된 후, az provider register 명령을 사용하여 해당 등록을 갱신합니다.
```
az provider register --namespace Microsoft.AppLink --subscription $SUBSCRIPTION
```

AppNet CLI 확장 설치

명령을 사용하여 AppNet CLI 확장을 설치합니다 az extension add .
```
az extension add --name appnet-preview
```

활성 구독 설정

Azure Kubernetes Application Network에 사용하려는 구독으로 활성 구독을 설정하려면 az account set 명령을 사용하십시오.
```
az account set --subscription $SUBSCRIPTION 
```

AKS 클러스터 만들기

메모

멤버 클러스터는 별도의 리소스 그룹에 있을 필요가 없습니다 . Azure Kubernetes Application Network 리소스와 동일한 리소스 그룹에 있을 수 있습니다. 그러나 모든 멤버 클러스터는 동일한 테넌트에 있어야 합니다.

Azure Kubernetes Application Network에 연결할 기존 AKS 클러스터가 없는 경우 만들어야 합니다. Azure Kubernetes Application Network에는 다음 요구 사항을 충족하는 AKS 클러스터가 필요합니다.

Istio 기반 서비스 메시 추가 기능(ServiceMeshProfile)을 사용할 수 없습니다 .
AKS 관리형 Microsoft Entra 통합 사용하도록 설정됩니다.
OIDC 발급자가 활성화되었습니다.
관리되는 Kubernetes 게이트웨이 API 설치 가 사용됩니다.

이러한 요구 사항을 이미 충족하는 기존 클러스터가 있는 경우 이 단계를 건너뛸 수 있습니다.

명령을 사용하여 AKS 클러스터에 대한 리소스 그룹을 만듭니다 az group create .
```
az group create --name $AKS_RG --location $LOCATION 
```
az aks create, --enable-oidc-issuer, --enable-aad 플래그와 함께 --enable-gateway-api 명령을 사용하여 AKS 관리형 Microsoft Entra 통합, OIDC 발급자 기능 및 관리형 Kubernetes Gateway API 추가 기능이 사용하도록 설정된 AKS 클러스터를 만듭니다. 이 클러스터에서 Istio 서비스 메시 추가 기능()을 사용하도록 설정--enable-azure-service-mesh 마세요.
```
az aks create --name $CLUSTER_NAME --resource-group $AKS_RG --enable-oidc-issuer --enable-aad --enable-gateway-api
```

Azure Kubernetes Application Network 리소스 만들기

명령을 사용하여 Azure Kubernetes Application Network 리소스에 대한 리소스 그룹을 만듭니다 az group create .
```
az group create --name $APPNET_RG --location $LOCATION 
```
명령을 사용하여 Azure Kubernetes Application Network 리소스를 만듭니다 az appnet create .

메모

애플리케이션 네트워크 리소스의 위치, 구독 또는 리소스 그룹을 만든 후에는 변경할 수 없습니다.
```
az appnet create --resource-group $APPNET_RG --name $APPNET_NAME --location $LOCATION  --identity-type SystemAssigned
```
만들기 프로세스는 몇 분 정도 걸릴 수 있습니다. properties.provisioningState 필드에는 성공적으로 생성된 Azure Kubernetes Application Network의 결과가 Succeeded로 표시됩니다.
az appnet show 명령을 사용하여 Azure Kubernetes Application Network 리소스를 봅니다.
```
az appnet show --resource-group $APPNET_RG --name $APPNET_NAME
```

AKS 클러스터를 Azure Kubernetes Application Network의 멤버로 조인

멤버 클러스터를 Azure Kubernetes Application Network에 조인할 때 해당 클러스터에 대한 다음 업그레이드 모드 중 하나를 지정할 수 있습니다. 완전 관리 형 또는 자체 관리 모드. 업그레이드 모드는 Azure Kubernetes Application Network의 부 버전 업그레이드가 멤버 클러스터에 적용되는 방법을 결정합니다. 멤버 조인 중에 업그레이드 모드를 지정하지 않으면 기본적으로 .로 설정 SelfManaged됩니다. 업그레이드 모드에 대한 자세한 내용은 Azure Kubernetes Application Network 멤버에 대한 업그레이드 구성을 참조하세요.

메모

구성원의 부모 Application Network, 위치, 구독 또는 리소스 그룹을 가입한 후에는 변경할 수 없습니다. 이러한 값을 변경하려면 멤버를 제거하고 새 값으로 다시 연결합니다.

az appnet member join 명령을 사용하고 매개 변수를 --upgrade-mode로 설정하여 AKS 클러스터를 Azure Kubernetes Application Network의 구성원으로 조인합니다. FullyManaged 또는 SelfManaged. 다음 예제에서는 SelfManaged 모드에서 멤버 클러스터에 참여하는 방법을 보여줍니다.
```
az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged
```

멤버 클러스터 연결 확인

클러스터에 조인한 후 명령을 사용하여 az appnet member show 연결을 확인하고 멤버 세부 정보를 볼 수 있습니다.

az appnet member show --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME

예를 들어, Stable 릴리스 채널을 사용하여 완전히 관리되는 모드로 등록된 경우, 출력은 다음과 같습니다.

{
  "id": "/subscriptions/$SUBSCRIPTION/resourceGroups/$APPNET_RG/providers/Microsoft.AppLink/appLinks/$APPNET_NAME/appLinkMembers/$APPNET_MEMBER_NAME",
  "location": "myLocation",
  "name": "myMemberName",
  "properties": {
    "clusterType": "AKS",
    "connectivityProfile": {
      "eastWestGateway": {
        "visibility": "Internal"
      }
    },
    "metadata": {
      "resourceId": "/subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME"
    },
    "observabilityProfile": {
      "metrics": {
        "metricsEndpoint": "https://myMember-mcp-fqdn.appnet.net"
      }
    },
    "provisioningState": "Succeeded",
    "upgradeProfile": {
      "mode": "FullyManaged",
      "fullyManagedUpgradeProfile": {
        "releaseChannel": "Stable"
      }
    }
  },
  "resourceGroup": "myAppNetRG",
  "type": "microsoft.applink/applinks/applinkmembers"
}

Azure Kubernetes Application Network 멤버 나열

여러 클러스터가 Azure Kubernetes Application Network에 조인할 수 있습니다.

명령을 사용하여 Azure Kubernetes Application Network의 모든 멤버를 나열합니다 az appnet member list .
```
az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME --output table
```

Azure Kubernetes Application Network 리소스 삭제

Azure Kubernetes Application Network 리소스를 삭제하면 해당 멤버가 모두 자동으로 제거되므로 먼저 멤버를 제거할 필요가 없습니다. 개별적으로 또는 이 연계를 통해 멤버를 제거해도 해당 AKS 클러스터는 삭제되지 않습니다.

Azure Kubernetes Application Network 멤버 제거

메모

멤버를 제거하기 전에 리소스에서 이전에 적용한 Istio 레이블(예: istio.io/use-waypointistio.io/use-waypoint-namespace, 및istio.io/dataplane-mode)을 제거하여 앰비언트 데이터 평면에서 워크로드를 제거해야 합니다.

명령을 사용하여 Azure Kubernetes Application Network에서 멤버를 제거합니다 az appnet member remove .
```
az appnet member remove --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME
```
명령을 사용하여 멤버가 제거되었는지 확인합니다 az appnet member list .
```
az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME 
```

Azure Kubernetes Application Network 리소스 삭제

명령을 사용하여 Azure Kubernetes Application Network 리소스를 삭제합니다 az appnet delete .
```
az appnet delete --resource-group $APPNET_RG --appnet-name $APPNET_NAME
```

Azure Kubernetes Application Network에 대한 자세한 내용은 다음 문서를 참조하세요.

피드백

이 페이지가 도움이 되었나요?

2026-05-20 에 마지막으로 업데이트됨

AKS용 Azure Kubernetes Application Network 시작(미리 보기)

사전 요구 사항

환경 변수 설정

공개 미리 보기에 대한 기능 등록

AppNet CLI 확장 설치

활성 구독 설정

AKS 클러스터 만들기

Azure Kubernetes Application Network 리소스 만들기

AKS 클러스터를 Azure Kubernetes Application Network의 멤버로 조인

멤버 클러스터 연결 확인

Azure Kubernetes Application Network 멤버 나열

Azure Kubernetes Application Network 리소스 삭제

Azure Kubernetes Application Network 멤버 제거

Azure Kubernetes Application Network 리소스 삭제

관련 콘텐츠

피드백

추가 리소스