Set Up a Bastion Server¶
To create a cluster, you first need a Genvid bastion server running. You can set up and manage a bastion server using the genvid-bastion script. The following command will set up one with the minimal services required.
From your shell, run:
genvid-bastion install --bastionid mybastion --checkmodules --update-global-tfvars --loadconfig
- A unique identifier for your bastion. It must:
- Be between 3 and 64 characters.
- Only contain lowercase letters, numbers, or hyphens.
- Start with a letter.
- Use this option to install new modules if none exist or update the ones already present.
- Use this option to update the global Terraform variables.
- Use this option to load the jobs and logs.
Due to limitations with the Windows file system directory length, system username and Bastion ID also factor into the max possible cluster name length. We’ve set a reasonably safe name length limit, but it’s technically possible for this limit to still cause issues if the user has an especially long username and/or Bastion ID.
The bastion is configured through a series of files available under
This folder contains files loaded before launching the
bastionjob. The content is added to the key-value store, where each object describes a folder and each value is converted to a string and inserted as a key.