Konverge

Pre-requisites

Access to Proxmox Cluster & environment variables

• You need to export credentials for a Proxmox VE cluster

# Syntax
export PROXMOX_HOST=<host-or-ip>:<port>
export PROXMOX_USER=<username>@pam or <username@pve>
export PROXMOX_PASSWORD=<password>

# Example
export PROXMOX_HOST=10.100.1.1:443
export PROXMOX_USER=myuser@pve
export PROXMOX_PASSWORD=myuserpass

• You will also need superuser or root access to Proxmox nodes via ssh & an appropriate ~/.ssh/config entry

# Example
Host node1.proxmox
HostName 10.100.1.1
User root
IdentityFile ~/.ssh/node1.pem

• Finally you will need to have, or generate a .pem RSA private/public keypair for access to VMs or LXC containers that will be created.

Install kubectl CLI

curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
sudo apt-add-repository -y "deb http://apt.kubernetes.io/ kubernetes-xenial main"
sudo apt-get install -y kubectl

# Enable kubectl bash completion
echo "source <(kubectl completion bash)" >> "${HOME}"/.bashrc

Install konverge

# Upgrade pip to version > 20.0.2
pip install --upgrade pip
# Install tag version
pip install -e git+https://github.com/dreamPathsProjekt/[email protected]#egg=konverge
# Install from master
pip install -e git+https://github.com/dreamPathsProjekt/konverge#egg=konverge

konverge Auto Completion

Bash

# Add this to ~/.bashrc
eval "$(_KONVERGE_COMPLETE=source_bash konverge)"

ZSH

# Add this to ~/.zshrc
eval "$(_KONVERGE_COMPLETE=source_zsh konverge)"

Fish

# Add this to ~/.config/fish/completions/konverge.fish
eval "$(env _KONVERGE_COMPLETE=source_fish konverge)"