YAML
Prerequisites
Review Pixie's requirements to make sure that your Kubernetes cluster is supported.
Determine if you already have Operator Lifecycle Manager (OLM) deployed to your cluster, possibly to the default olm
namespace. Pixie uses the Kubernetes Operator pattern to manage its Vizier, which handles data collection and query execution (see the Architecture diagram). The OLM is used to install, update and manage the Vizier Operator.
1. Install the Pixie CLI
The CLI is used to get Pixie's YAML files. You can install the Pixie CLI following the directions here.
2. (Optional) Use the CLI to Check Pixie's Requirements
Check if your K8s cluster meets Pixie's requirements by running:
If your cluster fails any checks, you may still proceed with installation, but it is unlikely that Pixie will work on your cluster.
3. Create a Deployment Key
Create a deployment key following the directions here.
4. Extract Manifests
Run the following CLI command to extract Pixie's manifest files:
If your cluster already has Operator Lifecycle Manager (OLM) deployed, use the `deploy_olm=false` flag.
Note: The extracted YAMls does not include manifests for each sub-component of Pixie. It includes manifests for etcd, NATS and the cloud-connector service which downloads the manifests for the necessary services and daemonsets.
5. Deploy Pixie
Deploy Pixie in your target cluster by running:
Pixie will deploy pods to the pl
, px-operator
, and olm
(if deploying the OLM) namespaces.
More Deploy Options
For more deploy options that you can specify to configure Pixie, refer to our deploy options.
6. Verify
To verify that Pixie is running in your environment you can check the admin page or run: