Installation instructions
1. Go to the MiniKF page on the AWS Marketplace
2. Click on the Continue to Subscribe button
3. Click on the Accept Terms button
4. Wait for a few minutes and the click on Continue to Configuration
5. Select a Region. We recommend you keep the default values for Delivery Method and Software Version. Then click Continue to Launch
6. Here you can review your configuration details. Don’t forget to view the Usage Instructions and keep them handy, as you are going to need them later.
7. You can also select how to launch MiniKF or change the EC2 instance type. We recommend you leave the default value for Choose Action. We recommend that you keep the default EC2 Instance Type (m5.2xlarge) or choose an even more powerful instance. Choosing a VM with reduced specs may make it impossible to train ML models.
8. Choose an existing VPC or create a new one. If you create a new one, make sure you click on the refresh icon to update the contents of the list, so that your new VPC appears in it.
9. Choose an existing Subnet or create a new one. If you create a new one, make sure you click on the refresh icon to update the contents of the list, so that your new subnet appears in it.
10. We strongly recommend to create a new security group. Otherwise you may not be able to access your MiniKF. To do so, click on Create New Based On Seller Settings
Note: If you need to use an existing security group, make sure it covers the ports mentioned in the usage instructions (see at the top of this page).
11. Choose an existing Key Pair or create a new one. If you create a new one, make sure you click on the refresh icon to update the contents of the list, so that your new key pair appears in it.
12. Click Launch. You will then see a message informing you about the successful installation. The message contains a link to view the instance on the EC2 Console. Click on it.
13. You should now see a screen like this. Click on the Instance ID of the created instance
14. You will then see this page. Click Connect to connect to the instance using EC2 Instance Connect
Note: this will only work if you have created a security group based on seller settings, as in step 10, or you have configured a security group based on the usage instructions. Otherwise, you need to SSH to the instance manually, see: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html
15. The User name will be prefilled. Click Connect
16. Follow the on-screen instructions and type minikf to view the progress of the deployment
17. Wait for a few minutes
18. Once the installation is completed you will see this screen
19. Follow the URL and log in to MiniKF using the provided username and password.
Note that MiniKF uses a self-signed certificate, so you will have to follow this guide to proceed to the MiniKF dashboard.
20. Once you log in, you will see the MiniKF Dashboard
Congratulations! You have successfully deployed MiniKF on AWS. You can now create notebooks, write your ML code, and run Kubeflow Pipelines.