Configure Ax Controller
Installation
Follow the Installation guide to install the Ax Controller
ax configure
Setup and configure the ax controller and validate your cloud account ๐ป
Example Usage
ax configure --run
Launch the interactive configuration workflow will step you through the following:
Install dependencies
Add ax to your shell profile
Ask to occasionally check for updates in the background
Set up access to your chosen cloud provider
Usage
run ~/.axiom/interact/axiom-configure
if ax is not yet in your shell path.
# axiom-configure --help
โโโโโโ โโโ โโโ โโโโโโโ โโโโโโโ โโโโ โโโโโโโโโโโโโโ โโโโโโโ
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโ โโโโโโ โโโ โโโ โโโโโโโโโ โโโโโโโโโ โโโโโโ โโโโ
โโโโโโโโ โโโโโโ โโโ โโโ โโโโโโโโโโโโโโโโโโโ โโโโโโ โโโ
โโโ โโโโโโโ โโโ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโ โโโโโโโโโโโโ
โโโ โโโโโโ โโโ โโโโโโโ โโโโโโโ โโโ โโโโโโโโ โโโ โโโโโโโ
Maintainer: 0xtavian
๐ช๐ต๐ป๐ฒ๐ฐ๐ฑ๐ฝ, ๐๐ธ๐พ ๐ฐ๐ธ๐ฝ ๐ถ๐ฎ, ๐ฒ๐ฝ๐ผ ๐ณ๐พ๐ผ๐ฝ ๐ช๐๐ฒ๐ธ๐ถ: ๐ฝ๐ฑ๐ฎ ๐ญ๐๐ท๐ช๐ถ๐ฒ๐ฌ ๐ฒ๐ท๐ฏ๐ป๐ช๐ผ๐ฝ๐ป๐พ๐ฌ๐ฝ๐พ๐ป๐ฎ ๐ฏ๐ป๐ช๐ถ๐ฎ๐๐ธ๐ป๐ด ๐ฏ๐ธ๐ป ๐ฎ๐ฟ๐ฎ๐ป๐๐ซ๐ธ๐ญ๐! - @๐น๐ป๐0๐ฌ๐ฌ @0๐๐ฝ๐ช๐ฟ๐ฒ๐ช๐ท
Description:
Examples:
axiom-configure --run # kick off Ax configuration wizard
axiom-configure --shell zsh # Set default shell to zsh via command line
axiom-configure --config <personal.json file> # Use personal.json from a file for account setup
axiom-configure --config <personal.json string> # Use personal.json data supplied by command-line for account setup (must be vaild personal.json data wrapped in single quotes)
axiom-configure --shell bash --unattended --config <path to personal.json file> # Use bash for default shell, do not promot, use personal.json data from file for axiom setup
Usage:
--run (required)
Start axiom-configure wizard, install dependencies, kick off axiom-account-setup and axiom-build
--config <axiom.json data>
Setup account with data from file or supplied from the command line (must be vaild data from a personal.json axiom file)
--unattended (optional)
Avoid any promots, defaults to Oh My Zsh unless --shell argument is also provided
--shell <bash, zsh, omz (Oh My Zsh)> (optional)
Add axiom to path, backup .zshrc/.bashrc to .zshrcbak/.bashrcbak
--auto-update <yes, no> (optional)
Toggle auto-update to periodically update axiom
--debug (optional)
Enable debug mode (VERY VERBOSE!)
--help
Display this help menu
You can provide your config inline or after running axiom-configure. axiom-configure --shell bash --unattended --config { "do_key": "[redacted]", "region": "nyc1", "provider": "do", "default_size": "s-1vcpu-1gb", "appliance_name": "", "appliance_key": "", "appliance_url": "", "email": "", "op": "[redacted]", "imageid": "axiom-default-myimageid", "provisioner": "default", "sshkey": "id_rsa" }
To get your account.json config file in this format run: cat ~/.axiom/accounts/do.json | tr '\n' ' ' | tr -s ' '
Cloud Configuration
During the initial installation, running ax configure
will trigger ax account-setup
, which in turn calls ax account
along with the respective cloud provider's account-helper
script. Once this setup is complete, ax build
is executed to create your Packer image. After the image is successfully built, you can deploy fleets of servers using ax fleet
and distribute scans with ax scan
!
You can also just run axiom account-setup at any time.
$ ax account-setup
Axiom Account Setup
You can use this wizard to add new accounts, once made, use axiom-account to switch between profiles
Please enter your provider (aws, azure, do, gcp, hetzner, ibm, linode, scaleway):
Last updated