https://github.com/Harvard-IACS/2020-ComputeFest/
Install instructions
Create an Amazon Web Services (AWS) account
If you already have an account, skip this step.
- Go to this link and follow the instructions.
You will need a valid debit or credit card. You will not be charged, it is only to validate your ID.
Install AWS Command Line Interface (AWSCLI)
- Install the AWS CLI Version 1 for your operating system. Please follow the appropriate link below based on your operating system.
- Linux
- macOS
- Windows
* Please make sure you add the AWS CLI version 1 executable to your command line Path.
Verify that AWS CLI is installed correctly by running aws --version
.
- You should see something similar to
aws-cli/1.17.0 Python/3.7.4 Darwin/18.7.0 botocore/1.14.0
.
Configuring the AWS CLI
You need to retrieve AWS credentials that allow your AWS CLI to access AWS resources.
- Sign into the AWS console. This simply requires that you sign in with the email and password you used to create your account. If you already have an AWS account, be sure to log in as the root user.
- Choose your account name in the navigation bar at the top right, and then choose My Security Credentials.
- Expand the Access keys (access key ID and secret access key) section.
- Press Create New Access Key.
- Press Download Key File to download a CSV file that contains your new AccessKeyId and SecretKey. Keep this file somewhere where you can find it easily.
Now, you can configure your AWS CLI with the credentials you just created and downloaded.
-
In your Terminal, run
aws configure
.i. Enter your AWS Access Key ID from the file you downloaded.
ii. Enter the AWS Secret Access Key from the file.
iii. For Default region name, enterus-east-1
.
iv. For Default output format, enterjson
. -
Run
aws s3 ls
in your Terminal. If your AWS CLI is configured correctly, you should see nothing (because you do not have any existing AWS S3 buckets) or if you have created AWS S3 buckets before, they will be listed in your Terminal window.
* If you get an error, then please try to configure your AWS CLI again.
eksctl
Install If you have already installed the eksctl
tool previously, please update to the latest version so that your GitTag
is 0.12.0
.
- Follow the instructions here under the "Install eksctl" section to install eksctl depending on your operating system.
If you run eksctl version
in your Terminal window, you should get version.Info{BuiltAt:"", GitCommit:"", GitTag:"0.12.0"}
. The GitTag
should be 0.12.0
.
kubectl
Install - Install the Kubernetes command-line tool, kubectl, so that you can communicate with Kubernetes clusters.
- Follow the instructions in the link to install the proper version depending on your operating system (Linux, MacOS, or Windows). Either versions
v1.16.0
orv1.17.0
are fine. You can choose to install through a package manager (like Homebrew) or by downloading the binary.
- Follow the instructions in the link to install the proper version depending on your operating system (Linux, MacOS, or Windows). Either versions
Install Postman
Follow the instructions of your operating system:
Install Docker
- Install
Docker Desktop
. Use one of the links below to download the proper Docker application depending on your operating system. Create a DockerHub account if asked.
- For macOS, follow this link.
- For Linux, follow this link.
- For Windows 10 64-bit (Pro, Enterprise, or Education), follow this link.
- For Windows 10 64-bit Home:
-
Excecute the files "first.bat" and "second.bat" in order, as administrator.
-
Restart your computer.
-
Excecute the following commands in terminal, as administrator.
REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion" /f /v EditionID /t REG_SZ /d "Professional" REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion" /f /v ProductName /t REG_SZ /d "Windows 10 Pro"
-
Follow this link to install Docker.
-
Restart your computer, do not log out.
-
Excecute the following commands in terminal, as administrator.
REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion" /v EditionID /t REG_SZ /d "Core" REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion" /v ProductName /t REG_SZ /d "Windows 10 Home"
-
Open a Terminal window and type docker run hello-world
to make sure Docker is installed properly .
It should appear the following message:
`` Hello from Docker!``
``This message shows that your installation appears to be working correctly.``
Finally, in the Terminal window excecute docker pull tensorflow/tensorflow:2.1.0-py3-jupyter
.
Install Anaconda
Follow the instructions for your operating system.
Install Sublime
Follow the instructions for your operating system.
If you already have a prefered text editor, skip this step.
Clone the github repository
Clone or download this repository.