Skip to content

Latest commit

 

History

History
106 lines (67 loc) · 2.08 KB

quickstart.md

File metadata and controls

106 lines (67 loc) · 2.08 KB

Quickstart

Deploy Infra

To deploy Infra, follow the deployment guide.

Connect via the CLI

Download the Infra CLI:

macOS

Download via homebrew:

brew install infrahq/tap/infra

Windows

Download via scoop:

scoop bucket add infrahq https://github.com/infrahq/scoop.git
scoop install infra

Ubuntu & Debian

Download the latest Debian package from GitHub and install it with dpkg or apt.

sudo dpkg -i infra_*.deb
sudo apt install ./infra_*.deb

Fedora & RHEL

Download the latest RPM package from GitHub and install it with rpm or dnf.

sudo rpm -i infra-*.rpm
sudo dnf install infra-*.rpm

Manual

Download the latest release from GitHub, unpack the file, and add the binary to the PATH.

Next, log in:

infra login <your infra host>

Then, create an access key:

INFRA_ACCESS_KEY=$(infra keys add --connector -q)

Access your cluster

Grant yourself access to the cluster:

infra grants add <your user email> example --role view

Next, verify your access:

infra list

Then, run kubectl to switch to your newly connected cluster.

kubectl config use-context infra:example

Alternatively, you can switch clusters via infra use command.

infra use example

Lastly, try running a command on the Kubernetes cluster:

kubectl get pods -A

By default, Infra will give view access to the user who made the install. To modify permissions or give additional access, use Infra dashboard or CLI.

Next steps

Congratulations. You've successfully connected your first cluster.

Infra works best when used with a team. Next, configure how users authenticate by connecting an identity provider, or add users directly by inviting them.