Skip to content

Improve installation instructions #132

@zasgar

Description

@zasgar

Reported by @daz:

Hey folks! Have been intrigued by Pixie for some time and, after listening to your developers interesting discussion on Kubelist podcast today, was prompted to try. I'm making progress but I think some improvements could be made to the install instructions. I'm always loathe to use (bash) installers on Linux but, the Docker solution has flaws and the install the binary correctly suggests checking the binary's hash but does not provide a convenient link to determine the hash. I'm using: https://docs.pixielabs.ai/installing-pixie/install-guides/ and https://docs.pixielabs.ai/installing-pixie/install-schemes/cli/
Docker
I'm using Podman but alias px="podman run --interactive --rm --name=pixie --volume=${HOME}/.pixie:/root/.pixie --volume=${HOME}/.kube/config:/root/.kube/config pixielabs/px" even with the volume for the cluster config, this requires a prior mkdir ${HOME}/.pixie step and fails because it's unable to find kubectl for px deploy.
Binary
Suggests (good practice!) # Check the signature matches. but it's unclear where the hash is to be found!?
The binary referenced in the page is evidently for MacOS (default?) cli_darwin_amd64 but, I'm using Linux and guessed (correctly) that I want cli_linux_amd64
Step #2 is "Deploy Pixie" using px deploy but this fails requiring that the user first px auth login
This isn't successful (yet) for me with:
Failed to perform browser-based auth. Will try manual autho error=missing code, assuming auth failed
But, on my second attempt using login?local_mode=true I get:
Failed to login error="rpc error: code = Internal desc = server closed the stream without sending trailers"
Third time lucky... I noticed the prompt to update to "0.7.2" having just installed using the Pixie installation page (!) and this appears to have resolved my issue. (edited)

docs.pixielabs.ai
Installing Pixie | Install Guide
Getting started guide to setup Pixie

docs.pixielabs.ai
Install | Install Schemes (optional) | CLI
How to install Pixie via CLI

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions