Red Hat Summit Red Hat SummitApoyoConsolaDesarrolladoresIniciar una pruebaContacto

Este contenido no está disponible en el idioma seleccionado.

Chapter 8. Istioctl tool

OpenShift Service Mesh 3 supports istioctl, the command line utility for the Istio project that includes many diagnostic and debugging utilities.

8.1. Support for Istioctl
Copiar enlace

OpenShift Service Mesh 3 supports a selection of Istioctl commands.

Expand
Table 8.1. Supported Istioctl commands
CommandDescription

admin

Manage the control plane (istiod) configuration

analyze

Analyze the Istio configuration and print validation messages

completion

Generate the autocompletion script for the specified shell

create-remote-secret

Create a secret with credentials to allow Istio to access remote Kubernetes API servers

help

Display help about any command

proxy-config, pc

Retrieve information about the proxy configuration from Envoy (Kubernetes only)

proxy-status, ps

Retrieve the synchronization status of each Envoy in the mesh

remote-clusters

List the remote clusters each istiod instance is connected to

validate, v

Validate the Istio policy and rules files

version

Print out the build version information

waypoint

Manage the waypoint configuration

ztunnel-config

Update or retrieve the current Ztunnel configuration.

8.2. Installing the Istioctl tool
Copiar enlace

Install the istioctl command-line utility to debug and diagnose Istio service mesh deployments.

Prerequisites

  • You have access to the OpenShift Container Platform web console.
  • The OpenShift Service Mesh 3 Operator is installed and running.
  • You have created at least one Istio resource.

Procedure

  1. Confirm which version of the Istio resource runs on the installation by running the following command: 

    $ oc get istio -ojsonpath="{range .items[*]}{.spec.version}{'\n'}{end}" | sed s/^v// | sort
    Copy to Clipboard Toggle word wrap

    If there are multiple Istio resources with different versions, choose the latest version. The latest version is displayed last.

  2. In the OpenShift Container Platform web console, click the Help icon and select Command Line Tools.

  3. Click Download istioctl. Choose the version and architecture that matches your system.

  4. Extract the istioctl binary file.

    1. If you are using a Linux operating system, run the following command: 

      $ tar xzf istioctl-<VERSION>-<OS>-<ARCH>.tar.gz
      Copy to Clipboard Toggle word wrap
    2. If you are using an Apple Mac operating system, unpack and extract the archive.
    3. If you are using a Microsoft Windows operating system, use the zip software to extract the archive.

  5. Move to the uncompressed directory by running the following command: 

    $ cd istioctl-<VERSION>-<OS>-<ARCH>
    Copy to Clipboard Toggle word wrap

  6. Add the istioctl client to the path by running the following command: 

    $ export PATH=$PWD:$PATH
    Copy to Clipboard Toggle word wrap

  7. Confirm that the istioctl client version and the Istio control plane version match or are within one version by running the following command: 

    $ istioctl version
    Copy to Clipboard Toggle word wrap

    Sample output:

    client version: 1.20.0
control plane version: 1.24.3_ossm
data plane version: none
    Copy to Clipboard Toggle word wrap

Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2025 Red Hat