Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.

Chapter 9. Istioctl tool


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

9.1. Support for Istioctl

OpenShift Service Mesh 3 supports a selection of Istioctl commands.

Expand
Table 9.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.

9.2. Installing the Istioctl tool

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

Nach oben
Red Hat logoGithubredditYoutubeTwitter

Lernen

Testen, kaufen und verkaufen

Communitys

Über Red Hat Dokumentation

Wir helfen Red Hat Benutzern, mit unseren Produkten und Diensten innovativ zu sein und ihre Ziele zu erreichen – mit Inhalten, denen sie vertrauen können. Entdecken Sie unsere neuesten Updates.

Mehr Inklusion in Open Source

Red Hat hat sich verpflichtet, problematische Sprache in unserem Code, unserer Dokumentation und unseren Web-Eigenschaften zu ersetzen. Weitere Einzelheiten finden Sie in Red Hat Blog.

Über Red Hat

Wir liefern gehärtete Lösungen, die es Unternehmen leichter machen, plattform- und umgebungsübergreifend zu arbeiten, vom zentralen Rechenzentrum bis zum Netzwerkrand.

Theme

© 2025 Red Hat