We used Python 2.7.12 to develop TNT
TNT uses ssh to interact with cloud instances or local VirtualBox VMs.
The instances must be set up to use the same user's ssh key.
Requires installation of python dependencies (listed in requirements.txt)
ci/setup.sh
Also, GraphViz has to be installed not just for python...
sudo apt-get install graphviz
If you want to be able to update the binaries the instances run via the TNT,
run the TNT script from a directory that has a binaries directory with MASQNode and dns_utility executables
in it.
Create your own modifiable version of tnt_config.py based off of tnt_config_template.py.
cp tnt_config_template.py tnt_config.py
Fill in the INSTANCE_USER to match the account needed to connect to your instances.
Some TNT commands execute commands in new terminal windows.
On a Mac, the default Terminal does not support this, so TNT on Mac relies on iTerm.
The main loop of TNT can be run from a regular Terminal, but in order to ssh or tail, you must have iTerm installed.
Requires installation of python library googleapiclient
Also requires that GOOGLE_APPLICATION_CREDENTIALS environment variable be set to point to a JSON file containing credentials for authentication to google cloud.
(This hasn't been checked in.)
Fill in the COMPUTE_CONFIG dictionary in tnt_config.py to match your project and zone configuration.
Fill in the COMPUTE_INSTANCES list in tnt_config.py to include your compute instances i.e. Google('<name_of_cloud_instance>').
We recommend using templates when creating multiple cloud instances. You'll need to setup SSH keys on all the instances in order for ssh to work without prompting for a password.
Requires installation of python library boto3
sudo -H pip install boto3
You'll need to set up your AWS credentials
(see the AWS documentation).
Also requires that AWS credentials and config files exist in the ~/.aws/ directory
Fill in the EC2_CONFIG dictionary in tnt_config.py to include your ec2 region.
Fill in the EC2_INSTANCES list in tnt_config.py to include your ec2 instances i.e. Amazon('<name_of_ec2_instance>').
We recommend using templates when creating multiple cloud instances. You'll need to setup SSH keys on all the instances in order for ssh to work without prompting for a password.
In VirtualBox create a VM with Bridged networking (so it will have its own IP)
To create more you can clone the existing VM, but remember to check the box to regenerate the MAC address,
and once it is created, change the hostname (in /etc/hostname) to match the VM name. Finally, restart the VM.
Fill in the VIRTUALBOX_INSTANCES list in tnt_config.py to include your virtualbox instances i.e. VBox('<name_of_vbox_instance>').
Requires building the docker image
ci/setup_docker.sh
Run the tests with pytest.
pytestInstall pytest-cov, then run ci/coverage.sh