Repository files navigation

Terraform and Bolt based deployment and provisioning of virtual machines with sshfs to a local workstation. At the moment only Proxmox is supported.

Also in the beginning only Debian and RHEL works. Ubuntu should works.

Required variables for Terraform (located in ./terraform) are:

• proxmox here the data for authentication
  • endpoint URL to the API endpoint of your Proxmox environment
  • api_token
• requirednetworks define available networks
  • domain the network domain
  • bridge the proxmox bridge to connect
• vms a hash of managed virtual machines cloned from templates
  • type (size) of the virtual machine
  • template name to clone from
  • node destination to deploy
  • optionalsshfs hash to configure mounts from your local workstation
    • user name to login to your waorkstation
    • private private key (without passphrase) file to use
  • network the vm is connected
  • optionalopenvox the openvox collection ("7" or "8") to use
  • optionalopenvox_prod_env link production environment to this directory
• optionalvm_default set defaults for all defined machines invms
  • same options as invm_default
• types for a definition of different VM sizes
  • name (for another hash) with count ofcores andmemory

See also the files with the suffix.example.

The file specified insshfs.private of a virtual machine invms will be copied to your new VM and will be used to authenticate against your local workstation. So the belonging public key has to be saved to yourauthorized_keys file of the user speficied.

Requirements for the local machine:

• binaries in search path
  • facter
  • bolt
  • terraform
  • jq
• SSH access via pubkey without passphrass

Requirements for the used Proxmox templates:

• cloud-init, no package updates, usercloud with public ssh key
• qemu-guest-agent installed and running
• sshfs package installed

How to start?

• change into root project directory
• ./bin/cde init
  • initilize project (installs bolt modules and do a terraform init)
• ./bin/cde <status|up|destroy> [virtual machine]
  • show status, apply or destroy all or a specific defined machine(s)
• ./bin/cde ssh <virtual machine>
  • logon specific machine