Transferir e configurar a biblioteca de cliente do Open Service Mesh (OSM)

Este artigo mostra como baixar a biblioteca de cliente OSM para operar e configurar o complemento OSM para o Serviço Kubernetes do Azure (AKS) e como configurar o binário para seu ambiente.

Importante

A partir de 30 de setembro de 2027, o Azure Kubernetes Service (AKS) deixou de suportar o add-on Open Service Mesh (OSM). O projeto upstream Open Service Mesh foi retirado.

Se o seu cluster usar o add-on OSM, migre para o add-on Istio antes da data de fim de suporte. Este aviso de descontinuação aplica-se apenas ao suplemento OSM gerido e não se aplica a instalações de malha de serviços de código aberto ou autogeridas. Para os passos de migração, consulte Orientação de migração do add-on OSM para o add-on Istio. Para se manter informado sobre os anúncios e atualizações da AKS, siga as notas de atualização da AKS.

Importante

Com base na versão do Kubernetes que seu cluster está executando, o complemento OSM instala uma versão diferente do OSM.

Versão do Kubernetes	Versão do OSM instalada
1.24.0 ou superior	1.2.5
Entre 1.23.5 e 1.24.0	1.1.3
Abaixo de 1.23.5	1.0.0

Versões mais antigas do OSM podem não estar disponíveis para instalação ou não estar ativamente suportadas se a versão correspondente do AKS atingir o fim de vida. Consulte o calendário de lançamentos do AKS Kubernetes para informações sobre as janelas de suporte a versões do AKS.

Baixe e instale o binário do cliente Open Service Mesh (OSM)

Em um shell baseado em bash no Linux ou no Subsistema Windows para Linux, use curl para baixar a versão OSM e, em seguida, extraia com tar da seguinte forma:

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

O osm binário do cliente é executado em sua máquina cliente e permite que você gerencie o OSM em seu cluster AKS. Use os comandos a seguir para instalar o binário do cliente OSM osm em um shell baseado em bash no Linux ou no Subsistema Windows para Linux. Esses comandos copiam o binário do cliente osm para a localização padrão de programas de usuário no seu PATH.

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

Você pode verificar se a biblioteca do cliente foi adicionada osm corretamente ao seu caminho e seu número de versão com o seguinte comando.

osm version

Baixe e instale o binário do cliente Open Service Mesh (OSM)

Em um shell baseado em bash, use curl para baixar a versão OSM e depois extraia com tar da seguinte forma:

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

O osm binário do cliente é executado em sua máquina cliente e permite que você gerencie o OSM em seu cluster AKS. Use os comandos a seguir para instalar o binário do cliente OSM osm em um shell baseado em bash. Esses comandos copiam o binário do cliente osm para a localização padrão de programas de usuário no seu PATH.

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

Você pode verificar se a biblioteca do cliente foi adicionada osm corretamente ao seu caminho e seu número de versão com o seguinte comando.

osm version

Baixe e instale o binário do cliente Open Service Mesh (OSM)

Em um shell baseado em PowerShell no Windows, use Invoke-WebRequest para baixar a versão do OSM e, em seguida, extrair com Expand-Archive da seguinte forma:

# 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 .

O osm binário do cliente é executado em sua máquina cliente e permite que você gerencie o controlador OSM em seu cluster AKS. Use os comandos a seguir para instalar o binário do cliente OSM osm em um shell baseado no PowerShell no Windows. Esses comandos copiam o binário do osm cliente para uma pasta OSM e, em seguida, disponibilizam-no imediatamente (no shell atual) e permanentemente (nas reinicializações do shell) através do seu PATH. Você não precisa de privilégios elevados (Admin) para executar esses comandos e não precisa reiniciar seu shell.

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

Aviso

Não tente instalar o OSM a partir do binário usando osm install. Isso resultará em uma instalação do OSM que não está integrada como um complemento para o AKS.

Configurar variáveis da CLI do OSM com um arquivo OSM_CONFIG

Os usuários podem substituir a configuração padrão da CLI do OSM para aprimorar a experiência do complemento. Isso pode ser feito criando um arquivo de configuração, semelhante ao kubeconfig. O arquivo de configuração pode ser criado em $HOME/.osm/config.yaml, ou em um caminho diferente que é exportado usando a OSM_CONFIG variável de ambiente.

O arquivo deve conter o seguinte conteúdo formatado YAML:

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

Se o arquivo não for criado no $HOME/.osm/config.yaml, lembre-se de definir a OSM_CONFIG variável de ambiente para apontar para o caminho onde o arquivo de configuração é criado.

Depois de definir OSM_CONFIG, a osm env saída do comando deve ser a seguinte:

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