이 문서에서는 OSM 클라이언트 라이브러리를 다운로드하여 AKS(Azure Kubernetes Service)에 대한 OSM 추가 기능을 작동하고 구성하는 방법과 사용자 환경에 대한 이진 파일을 구성하는 방법을 보여 줍니다.
중요합니다
2027년 9월 30일부터 AKS(Azure Kubernetes Service)는 더 이상 OSM(Open Service Mesh) 추가 기능을 지원하지 않습니다. 업스트림 Open Service Mesh 프로젝트가 사용 중지되었습니다.
클러스터에서 OSM 추가 기능을 사용하는 경우 지원 종료 날짜 전에 Istio 추가 기능으로 마이그레이션합니다. 이 사용 중지 알림은 관리되는 OSM 추가 기능에만 적용되며 오픈 소스 또는 자체 관리 서비스 메시 설치를 다루지 않습니다. 마이그레이션 단계는 OSM 추가 기능에서 Istio 추가 기능으로의 마이그레이션 지침을 참조하세요. AKS 공지 사항 및 업데이트에 대한 정보를 유지하려면 AKS 릴리스 정보를 따르세요.
중요합니다
클러스터가 실행 중인 Kubernetes 버전에 따라 OSM 추가 기능은 다른 버전의 OSM을 설치합니다.
| Kubernetes 버전 | OSM 버전이 설치됨 |
|---|---|
| 1.24.0 이상 | 1.2.5 |
| 1.23.5에서 1.24.0 사이 | 1.1.3 |
| 1.23.5 미만 | 1.0.0 |
이전 버전의 OSM은 설치에 사용할 수 없거나 해당 AKS 버전이 수명이 다한 경우 적극적으로 지원되지 않을 수 있습니다. AKS 버전 지원 창에 대한 자세한 내용은 AKS Kubernetes 릴리스 일정을 확인하세요.
OSM(Open Service Mesh) 클라이언트 이진 파일 다운로드 및 설치
Linux의 bash 기반 셸 또는 Linux용 Windows 하위 시스템에서 curl을 사용하여 OSM 릴리스를 다운로드한 후, 다음과 같이 tar사용하여 추출합니다.
# Specify the OSM version that will be leveraged throughout these instructions
OSM_VERSION=v1.2.0
curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-linux-amd64.tar.gz" | tar -vxzf -
osm 클라이언트 이진 파일은 클라이언트 컴퓨터에서 실행되며 이를 통해 AKS 클러스터에서 OSM을 관리할 수 있습니다. 다음 명령을 사용하여 Linux 또는 osm의 Bash 기반 셸에 OSM 클라이언트 이진 파일을 설치합니다. 이 명령을 사용하여 osm 클라이언트 이진 파일을 PATH의 표준 사용자 프로그램 위치에 복사합니다.
sudo mv ./linux-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
다음 명령을 사용하여 osm 클라이언트 라이브러리가 경로 및 해당 버전 번호에 올바르게 추가되었는지 확인할 수 있습니다.
osm version
OSM(Open Service Mesh) 클라이언트 이진 파일 다운로드 및 설치
bash 기반 셸에서 curl을 사용하여 OSM 릴리스를 다운로드한 후, 다음과 같이 tar로 추출합니다.
# Specify the OSM version that will be leveraged throughout these instructions
OSM_VERSION=v1.2.0
curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-darwin-amd64.tar.gz" | tar -vxzf -
osm 클라이언트 이진 파일은 클라이언트 컴퓨터에서 실행되며 이를 통해 AKS 클러스터에서 OSM을 관리할 수 있습니다. 다음 명령을 사용하여 bash 기반 셸에서 OSM osm 클라이언트 이진 파일을 설치합니다. 이 명령을 사용하여 osm 클라이언트 이진 파일을 PATH의 표준 사용자 프로그램 위치에 복사합니다.
sudo mv ./darwin-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
다음 명령을 사용하여 osm 클라이언트 라이브러리가 경로 및 해당 버전 번호에 올바르게 추가되었는지 확인할 수 있습니다.
osm version
OSM(Open Service Mesh) 클라이언트 이진 파일 다운로드 및 설치
Windows의 PowerShell 기반 셸에서 Invoke-WebRequest를 사용하여 OSM 릴리스를 다운로드한 후, 다음과 같이 Expand-Archive로 추출합니다.
# Specify the OSM version that will be leveraged throughout these instructions
$OSM_VERSION="v1.2.0"
[Net.ServicePointManager]::SecurityProtocol = "tls12"
$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -URI "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-windows-amd64.zip" -OutFile "osm-$OSM_VERSION.zip"
Expand-Archive -Path "osm-$OSM_VERSION.zip" -DestinationPath .
osm 클라이언트 이진 파일은 클라이언트 컴퓨터에서 실행되며 이를 통해 AKS 클러스터에서 OSM 컨트롤러를 관리할 수 있습니다. 다음 명령을 사용하여 Windows의 PowerShell 기반 셸에 OSM osm 클라이언트 이진 파일을 설치합니다. 이러한 명령은 osm 클라이언트 이진 파일을 OSM 폴더에 복사한 다음, PATH를 통해 즉시(현재 셸에서) 및 영구적으로(셸 다시 시작에서) 사용할 수 있습니다. 이러한 명령을 실행하는 데에는 상승된(관리자) 권한이 필요하지 않으며 셸을 다시 시작하지 않아도 됩니다.
# Copy osm.exe to C:\OSM
New-Item -ItemType Directory -Force -Path "C:\OSM"
Move-Item -Path .\windows-amd64\osm.exe -Destination "C:\OSM\"
# Add C:\OSM to PATH.
# Make the new PATH permanently available for the current User
$USER_PATH = [environment]::GetEnvironmentVariable("PATH", "User") + ";C:\OSM\"
[environment]::SetEnvironmentVariable("PATH", $USER_PATH, "User")
# Make the new PATH immediately available in the current shell
$env:PATH += ";C:\OSM\"
경고
osm install 바이너리를 사용하여 OSM을 설치하지 마세요. 이로 인해 AKS용 추가 기능으로 통합되지 않은 OSM이 설치됩니다.
OSM_CONFIG 파일로 OSM CLI 변수 구성
사용자는 기본 OSM CLI 구성을 재정의하여 추가 기능 환경을 향상시킬 수 있습니다. 이는 kubeconfig과 유사한 구성 파일을 만들어 수행할 수 있습니다. 구성 파일은 $HOME/.osm/config.yaml에서 만들거나 OSM_CONFIG 환경 변수를 사용하여 내보낸 다른 경로에서 만들 수 있습니다.
파일에는 다음과 같은 YAML 형식의 콘텐츠가 포함되어야 합니다.
install:
kind: managed
distribution: AKS
namespace: kube-system
파일이 $HOME/.osm/config.yaml에서 생성되지 않았다면 구성 파일이 생성되는 경로를 가리키도록 환경 변수를 OSM_CONFIG로 설정해야 합니다.
OSM_CONFIG를 설정한 후 osm env 명령의 출력은 다음과 같아야 합니다.
$ osm env
---
install:
kind: managed
distribution: AKS
namespace: kube-system