Note. This tutorial goes through how to set up your own Google Compute Engine (GCE) instance to work on the assignments. Each student will get some credits for use during the semester. Please use the resources judiciously. Adding additional credits is a bit difficult. When you sign up for GCP the first time, you also receive some credits from Google that you can use for the course.
You will connect to the Google cloud through a terminal or shell. This is the standard way of interacting with *nix family systems. This tutorial will also help you set up your own terminal access.
The Secure SHell (SSH) provides a range of secure access tools to remote machines. For this class, we will be using it to establish a terminal (command-line) connection to your virtual machine instance.
We are using key-based authentication to your compute instances. This means that access will be linked to specific computers and accounts that you will be accessing your instance from. Also, you will not use a password for access (unless your local private key is encrypted).
Windows users can look into PuTTY and its documentation. However, I suggest that you set-up your Windows Subsystem for Linux. Doing so will allow you to follow the same instructions as the Macintosh and GNU/Linux users since most distributions of the latter mentions come with SSH already installed.
If you already have a public key such as
~/.ssh/id_rsa.pub in your home (user) directory, then you are done. You can check for this file by typing:
machine@user:~$ ls ~/.ssh/id_rsa.pub
You may also create a key pair by running
ssh-keygen. No file name is needed for generation. It is okay to use an empty passphrase, but doing so means that your private key is unencrypted (this is often okay, since it is stored on your local machine only, but is a problem if your laptop is compromised).
Here is an example run on mac os
Create a Gmail account if you don’t already have one. You may at https://accounts.google.com. Sign into your account and point your web-browser to https://console.cloud.google.com/education. Fill out the required fields and read the terms and conditions. If you agree, go ahead and click on the blue ACCEPT AND CONTINUE button.
You may receive a verification email, follow the instructions within. At the end you can verify your credits by going to the billing menu (make sure you select the right billing account) as seen in the screenshot bellow.
You can access your virtual machine by a terminal that can be reached by pointing your web-browser to the Google Cloud Console (make sure you are logged in). You’ll land on a dash-board page. Here you can customize your project (you need one to work on a virtual machine (VM)) or create a new one for the course.
Ensure you select the Gmail account that uses the Cloud Credits. Select
Billing Account for Education as the Billing Account for the project as seen in the screenshot above. If you already have projects, you’ll need to swap the billing account to the
Billing Account for Education.
To create a new project or select a different project, follow the steps below.
Create a new project or change projects by locating the
down arrow in the pop up screen.
A new project can be created by selecting the NEW PROJECT option on the pop up screen. You can change project by selecting the project name.
Name your project, ensure your billing account is set to
Billing Account for Education, and select create.
Top left hamburger menu>Compute Engine>VM instances. Alternatively, you can navigate from the dashboard screen, select
Create a VM. Ensure you have the correct project selected before continuing. If the Compute Engine API is not enabled, you will be given an option to enable it before continuing.
You will mostly use the defaults, but change:
Note that the e2-micro (1 GB 2 shared vCPU) instance will be cheap but likely not free.
You can change to a more expensive instance if you would like, but you will need to be diligent about turning it off when not in use to preserve your credits.
There are several zone options, so you can choose the one where you would like your virtual instance to live.
The closest zone to Norman, Oklahoma is
This zone is located in Council Bluffs, Iowa.
Set your zone to
us-central1-c they will have the configurations we need.
You can also increase the size of disk space that you would like to use. A Standard persistent disk with a size of 30 should be sufficient.
Setting Boot Disk:
Click CREATE button.
down arrowby the default network settings. In the “External IPv4 address” field, press the
down arrowto “Create IP address”. Fill out the fields and click the RESERVE button.
On the same edit page as discussed above, scroll down to the “SSH keys” section and click on the hyperlink “Show and edit”.
On your local machine, you may run
cat ~/.ssh/id_rsa.pub to print your public key to the terminal. Additionally, you may run
xclip -sel clip < ~/.ssh/id_rsa.pub to copy your public key to the clipboard.
+Add Item. Paste the contents into the
SSH key field. Make sure you do not paste any additional new-line or other white-space characters.
Locate the blue SAVE button.
There are at least two ways to connect to your Google Cloud VM. We can use their browser interface or your own computer.
A pop-up window should appear with a terminal into your VM instance.
ssh -i PATH_TO_PRIVATE_KEY USERNAME@EXTERNAL_IP
PATH_TO_PRIVATE_KEYis likely something like
~/.ssh/name. If the file extension is .pub, this is your public key, not your private key.
USERNAMEis the username specified in your public key. Note that this is not your Google username. E. g., your TA’s Google username is
jonathan.lessliebut the username in his public key is
EXTERNAL_IPis the IP given in the INSTANCES list under the “External IP” column.
Example command: ssh -i ~/.ssh/id_rsa jdehart@
Are you sure you want to continue connecting (yes/no/[fingerprint])? Type
yes in the terminal to connect.
In order to update and install necessary packages, you may consider running the following commands,
sudo apt update sudo apt -y upgrade sudo apt install -y emacs vim htop tmux tree ranger glances sudo apt install -y gcc gdb make sudo apt install -y valgrind strace sudo apt install -y linux-tools-common linux-tools-generic sudo apt install -y linux-tools-`uname -r` sudo apt install -y libcap-dev sudo apt install -y libacl1-dev sudo apt install -y bats zlib1g-dev sudo apt install -y libsqlite3-dev sqlite3 bzip2 libbz2-dev sudo apt install -y libssl-dev openssl libgdbm-dev libgdbm-compat-dev sudo apt install -y liblzma-dev libreadline-dev libncursesw5-dev uuid-dev sudo apt install -y ssh evince
You might want to reboot now with
sudo reboot now.
For any help about how to set-up a VM instance or connect to it, send the TA an email. For help regarding coupon codes or information that gets you Google credits, email the professor.