Skip to content

Latest commit

聽

History

History
111 lines (77 loc) 路 3.91 KB

cli-installation-reference.mdx

File metadata and controls

111 lines (77 loc) 路 3.91 KB
Raw
id title description keywords image
cli-installation-reference
CLI Installation Reference
This page contains a reference of all options for installing Tracetest CLI. Tracetest has a command line interface (CLI) which includes Tracetest Agent - Enables Tracetest to access your application under test and to ingest trace data from your OpenTelemetry Collector or tracing backend. Tracetest Core Install Wizard - Helps install the Tracetest Core Server into Docker or Kubernetes.
tracetest
tracetest cli
tracetest reference
trace-based testing
observability
distributed tracing
testing

This page contains a reference of all options for installing Tracetest CLI.

Tracetest has a command line interface (CLI) which includes:

  • Tracetest Agent: Enables Tracetest to access your application under test and to ingest trace data from your OpenTelemetry Collector or tracing backend.
  • Tracetest Core Install Wizard: Helps install the Tracetest Core Server into Docker or Kubernetes.

The CLI is used to run tests, download or upload tests, and manage Tracetest capability and resources.

:::tip Want more info? Read more about the installation guide here. :::

Installing the Tracetest CLI in different operating systems

Every time we release a new version of Tracetest, we generate binaries for Linux, MacOS, and Windows. Supporting both amd64, and ARM64 architectures, in tar.gz, deb, rpm and exe formats.

You can find the latest version here.

Linux/MacOS

Tracetest CLI can be installed automatically using the following script:

curl -L https://raw.githubusercontent.com/kubeshop/tracetest/main/install-cli.sh | bash

It works for systems with Homebrew, apt-get, dpkg, yum, rpm installed, and if no package manager is available, it will try to download the build and install it manually.

You can also manually install it with one of the following methods.

Homebrew

brew install kubeshop/tracetest/tracetest

APT

# requirements for our deb repo to work
sudo apt-get update && sudo apt-get install -y apt-transport-https ca-certificates

# add repo
echo "deb [trusted=yes] https://apt.fury.io/tracetest/ /" | sudo tee /etc/apt/sources.list.d/fury.list

# update and install
sudo apt-get update
sudo apt-get install tracetest

YUM

# add repository
cat <<EOF | sudo tee /etc/yum.repos.d/tracetest.repo
[tracetest]
name=Tracetest
baseurl=https://yum.fury.io/tracetest/
enabled=1
gpgcheck=0
EOF

# install
sudo yum install tracetest --refresh

Windows

Chocolatey

choco source add --name=kubeshop_repo --source=https://chocolatey.kubeshop.io/chocolatey ; choco install tracetest

From source

Download one of the files from the latest tag, extract to your machine, and then add the tracetest binary to your PATH variable.

Installing a specific version of the Tracetest CLI

You can request to install a specific version by appending -s -- [version] to the installation script.

curl -L https://raw.githubusercontent.com/kubeshop/tracetest/main/install-cli.sh | bash -s -- [version]

If you would want version v0.13.0 you would run this command:

curl -L https://raw.githubusercontent.com/kubeshop/tracetest/main/install-cli.sh | bash -s -- v0.12.1

This method skips package managers and directly downloads the build from the release page.

Due to this, if the Tracetest CLI was previously installed using a package manager, that version will still exist in the system, so depending on the $PATH environment variable configuration, that version might take precedence over the specific version you installed with the install script.