Open Service Mesh (OSM) istemci kitaplığını indirme ve yapılandırma

Bu makalede, Azure Kubernetes Service (AKS) için OSM eklentisini çalıştırmak ve yapılandırmak için OSM istemci kitaplığını indirme ve ortamınız için ikili yapılandırma işlemleri gösterilmektedir.

Önemli

Azure Kubernetes Service (AKS), 30 Eylül 2027'den itibaren Open Service Mesh (OSM) eklentisini artık desteklememektedir. Yukarı akış Open Service Mesh projesi kullanımdan kaldırıldı.

Kümeniz OSM eklentisini kullanıyorsa destek sonu tarihinden önce Istio eklentisine geçin. Bu kullanımdan kaldırma bildirimi yalnızca yönetilen OSM eklentisi için geçerlidir ve açık kaynak veya kendi kendine yönetilen hizmet ağı yüklemelerini ele almaz. Geçiş adımları için bkz . OSM eklentisinden Istio eklentisine geçiş kılavuzu. AKS duyuruları ve güncelleştirmeleri hakkında bilgi sahibi olmak için AKS sürüm notlarını izleyin.

Önemli

Kümenizin çalıştırdığı Kubernetes sürümüne bağlı olarak, OSM eklentisi OSM'nin farklı bir sürümünü yükler.

Kubernetes sürümü	OSM sürümü yüklü
1.24.0 veya üzeri	1.2.5
1.23.5 ile 1.24.0 arasında	1.1.3
1.23.5'in Altında	1.0.0

OSM'nin eski sürümleri yükleme için kullanılamayabilir veya karşılık gelen AKS sürümü kullanım ömrü sonuna ulaştıysa etkin bir şekilde desteklenmeyebilir. AKS sürüm destek pencereleri hakkında bilgi için AKS Kubernetes yayın takvimine bakın.

Open Service Mesh (OSM) istemci ikili dosyasını indirme ve yükleme

Linux veya Linux için Windows Alt Sistemi üzerinde bash tabanlı bir kabukta, OSM sürümünü indirmek için curl ve ardından tar ile ayıklamak üzere aşağıdaki adımları izleyin:

# 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 İstemci ikili dosyası, istemci makinenizde çalışır ve AKS kümenizde OSM'yi yönetmenize olanak tanır. Linux'ta bash tabanlı bir kabukta veya Linux osm OSM istemci ikili dosyasını yüklemek için aşağıdaki komutları kullanın. Bu komutlar istemci ikili dosyasını osm sizin PATH içindeki standart kullanıcı programı konumuna kopyalar.

sudo mv ./linux-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm

aşağıdaki komutla istemci kitaplığının osm yolunuz ve sürüm numarasına doğru şekilde eklendiğini doğrulayabilirsiniz.

osm version

Open Service Mesh (OSM) istemci ikili dosyasını indirme ve yükleme

Bash tabanlı bir kabukta, OSM sürümünü indirmek için curl kullanın ve ardından tar ile şu şekilde ayıklayın:

# 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 İstemci ikili dosyası, istemci makinenizde çalışır ve AKS kümenizde OSM'yi yönetmenize olanak tanır. OSM osm istemci ikili dosyasını bash tabanlı bir kabukta yüklemek için aşağıdaki komutları kullanın. Bu komutlar istemci ikili dosyasını osm sizin PATH içindeki standart kullanıcı programı konumuna kopyalar.

sudo mv ./darwin-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm

aşağıdaki komutla istemci kitaplığının osm yolunuz ve sürüm numarasına doğru şekilde eklendiğini doğrulayabilirsiniz.

osm version

Open Service Mesh (OSM) istemci ikili dosyasını indirme ve yükleme

Windows'da PowerShell tabanlı bir kabukta, OSM sürümünü indirmek için Invoke-WebRequest kullanın ve ardından Expand-Archive ile aşağıdaki şekilde ayıklayın:

# 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 İstemci ikili dosyası, istemci makinenizde çalışır ve AKS kümenizdeki OSM denetleyicisini yönetmenize olanak tanır. Windows'da PowerShell tabanlı bir kabukta OSM osm istemci ikili dosyasını yüklemek için aşağıdaki komutları kullanın. Bu komutlar, istemci çalıştırılabilir dosyasını osm bir OSM klasörüne kopyalar ve ardından PATH aracılığıyla hem hemen (geçerli kabukta) hem de kalıcı olarak (kabuk yeniden başlatmaları arasında) kullanılabilir hale getirir. Bu komutları çalıştırmak için yükseltilmiş (Yönetici) ayrıcalıklarına ve kabuğunuzu yeniden başlatmanıza gerek yoktur.

# 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\"

Uyarı

OSM'yi ikili dosya kullanarak osm install yüklemeyi denemeyin. Bu, AKS için bir eklenti olarak tümleştirilmeyen bir OSM yüklemesi ile sonuçlanacaktır.

OSM CLI değişkenlerini bir OSM_CONFIG dosyasıyla yapılandırma

Kullanıcılar, eklenti deneyimini geliştirmek için varsayılan OSM CLI yapılandırmasını geçersiz kılabilir. Bu, benzeri kubeconfigbir yapılandırma dosyası oluşturarak yapılabilir. Yapılandırma dosyası ya $HOME/.osm/config.yaml konumunda ya da OSM_CONFIG ortam değişkeni kullanılarak dışarı aktarılan farklı bir yolda oluşturulabilir.

Dosya aşağıdaki YAML biçimli içeriği içermelidir:

install:
  kind: managed
  distribution: AKS
  namespace: kube-system

$HOME/.osm/config.yaml konumunda dosya oluşturulmadıysa, ortam değişkenini yapılandırma dosyasının oluşturulduğu yolu gösterecek şekilde ayarlamayı unutmamanız gerektiğini unutmayın.

OSM_CONFIG ayarlandıktan sonra komutun osm env çıkışı aşağıdaki gibi olmalıdır:

$ osm env
---
install:
  kind: managed
  distribution: AKS
  namespace: kube-system