HOWTO: Setup provider: Amazon Web Services (AWS)

This document describes how to setup your AWS account to use it in BlendNet.

Video reference

TODO

Addon: How to debug instances

By default the created Manager & Agent instances are blocking ssh connection and to enable it you will need to slightly modify the BlendNet addon sources:

1. Create SSH key in your AWS console: Console->EC2->Key Pairs
2. Find createInstanceManager and createInstanceAgent functions in your local BlendNet/providers/aws/__init__.py and uncomment --key-name option for both and replace the key name to created one:
   • Before:

     options = [
         ...
         #'--key-name', 'default_key', # If you want to ssh to the instance (change createFirewall func too)
         ...
     ]
     

   • After:

     options = [
         ...
         '--key-name', '<YOUR SSH KEY NAME>', # If you want to ssh to the instance (change createFirewall func too)
         ...
     ]
     

3. Find createFirewall function in your local BlendNet/providers/aws/__init__.py and uncomment the ingress for 22 port:
   • Before:

     #_executeAwsTool('ec2', 'authorize-security-group-ingress',
     #                '--group-name', target_group,
     #                '--protocol', 'tcp',
     #                '--port', '22',
     #                '--cidr', '0.0.0.0/0')
     

   • After:

     _executeAwsTool('ec2', 'authorize-security-group-ingress',
                     '--group-name', target_group,
                     '--protocol', 'tcp',
                     '--port', '22',
                     '--cidr', '0.0.0.0/0')
     

4. Make sure you cleaned the blendnet-* security groups if they are existing AWS->EC2->Security Groups, otherwise they will not be recreated.
5. Connect to the instance - BlendNet uses debian images, which contains admin user for external ssh access:

ssh [email protected]

6. Now you can check the service logs by run the next commands on the instance:
   • Manager:

     journalctl -u blendnet-manager
     

   • Agent:

     journalctl -u blendnet-agent