Creating a Development / Deployment Virtual Machine with GCE

When creating a Rails app, it is helpful to have a decent roadmap of what you're going to do. An important part of this is where you are going to develop your app, and where you are going to host (deploy) it.

If the answer to one or both of these involves using the Google Cloud Platform, then this guide should help you set yourself up nicely.

This process is rather long and can be tricky, so has been split into sections:

  1. GCP Account Setup
  2. Project APIs & Service Account Setup
  3. Virtual Machine Setup
  4. Accessing the VM

 

 

GCP Signup & Project Initialisation

If you don't already have a Google account, this is naturally a prerequisite to getting yourself set up, and you can set one up quickly via accounts.google.com.
Once you're set up, head over to cloud.google.com, where there should be a nice Get started for free button, which you can click to get started:

This free trial gives you an impressive $300 of credit to use over 90 days, which should be plenty for completing your learner apps and deciding if you'd like to continue using the service afterwards.
When you are setting up your account, remember to set your account type to Individual:

With this done, we're ready to get started. Google will try to collect some information from you as to your purposes on the platform; feel free to fill these out if you wish, or hit Close at the bottom to skip it. The Welcome page offers a few resources such as a Basics Checklist, however we will skip this just now and make a start.

GCP works in Projects, and the platform will have taken the liberty of generating one for you as part of the signup process entitled My First Project. You are more than welcome to continue with this project.
However if you'd like something with a snappier name then we can create a new one by clicking on the project's name in the top nav bar and hitting New Project:

From here we can give our new project a name and specify a project ID if we don't like the one Google chooses for us. We can also attribute this to an organisation, which we'll skip for now:

You will be taken back to your Welcome page, and the Notifications panel with appear with the progress of your new project's initialisation:

When the little progress icon (called a throbber - I know...) shows a green tick then you are ready to go! Click the notification and you will be taken your new project's Dashboard, where we can really get started:

Now this may seem a little imposing on your first encounter with it - it certainly was on mine! But never fear; the remaining sections will guide you on the bits you'll need to get the VM and Rails development environment set up.

 

 

Service Account Setup

Before we actually get to building our VM, we will need to set up a service account that will be assigned to our VM and has sufficient access to all the things we need it to access. GCP adds individual elements of functionality to our project based on the APIs we enable for it so, if you are planning to develop or deploy using GCP, we will need to find and enable the appropriate APIs in order to allow access to the features we require:

This can be done by navigating to the API Library and searching for them:

GCP API Library

Or you can trust that I vaguely know what I'm doing and activate the APIs from the list below:

Whichever way you choose to naviatge to them, simply click Enable on each API's library page to activate it, which will throb until it successfully completes the process:

API Library page

With these all enabled, we can now create our service account by heading into the Service Accounts page in the IAM interface:

IAM menu option

and click the Create Service Account button at the top of this page to set it up:

Create Service Account button

The first section of the resulting page will get you to create name for your service account, which will also automatically generate an email for it (which you can change if you wish). You can optionally enter a description for the service account for additional information as well:

Service account details

On clicking Create and Continue, the second step will expand and allow you to add the required roles to the service account. The roles we need to add are:

  • Compute Engine Service Agent - allows use and management of VMs.
  • Cloud SQL Editor - allows use and management of SQL instances and their databases.
  • App Engine Deployer - allows new AppEngine versions to be deployed.
  • App Engine Service Admin - allows version control and traffic management of AppEngine versions and instances.
  • App Engine flexible environment Service Agent - allows use of the AppEngine flexible environment.
For each of these, click on Add Role and search for the role using the filter option at the top of the modal. Once all three have been assigned, hit Continue:

Service account roles

And if you wish to allow other users to use the service account, you can do so here. Now hit Done and this will create the Service Account and redirect you to the service account landing page, where you will see your freshly baked account waiting for you:

Service account index

 

 

Virtual Machine Setup

With our project created and a service user set up, we can now begin doing something with them!

To create our VM we will be using the Compute Engine that you might see in the left-hand navigation bar. Hovering over this will reveal the interfaces available in this engine and, unsurprisingly, we'll need to select VM instances to navigate to the portal:

Clicking on one of the Create Instance buttons will redirect us to the required interface to start setting up our basic development VM. This interface offers a multitude of setup options, so we'll take it step by step.
We'll ignore the left-hand column for now, which offers options to import VMs from various sources, though the right-hand column is interesting and shows the estimated cost of the options you select if the VM is left on continually. While we don't need to worry about this for now as we're using free trial credit, it's a handy feature if you later start paying for the service.

Let's start off by giving the VM an appropriate name and configuring the region based on your location, as you'll generally be the one connecting to it - the drop-down handily informs us where the region designations point to, and zone doesn't matter too much (more info can be found here).

Note that these settings are permanent, and if we realise a mistake later then we'll need to create a new VM to rectify it.

The Machine configuration determines how mighty our VM will be. Feel free to have a nosey through the options presented (particularly how they change the prices on the right-hand side).
However, given that we'll only be using our VM to run our development environment (and possibly code in), we don't need anything too hench - I find the e2-small machine type offers a happy compromise of power without draining our credit too much:

We can skip the Confidential VM service and Container settings just now and select our Boot disk. By default the interface selects the latest stable Debian operating system, but we'll Change this now:

You are, of course, free to develop in whichever operating system you desire, but in this example we will be using Ubuntu because I like it and it's my blog. I would suggest using the latest LTS (long term support) release, which at time of writing is 20.04, and keep the Balanced persistent disk type.
With regards to size, the 10GB default should suffice for just building a single basic application, however increasing this to 25GB shouldn't break the bank and will allow a bit more freedom:

With this done, go ahead and hit Select to confirm these options and go back to the Create Instance interface.

In the Identity and API access section, we will here select the service account that we set up earlier from the drop-down. After this, the only remaining option we need to worry about is enabling HTTP traffic through the Firewall which can be achieved by ticking the corresponding box:

Finally we can hit Create to set up this VM, which will redirect you to the VM instances screen, with a new entry in your Instances table displaying a throbber while GCE is creating the VM.

While this is throbbing, let's do the final bit of setup.

By default Rails serves its development server on port 3000, and we will need to open this port on the firewall in order to access it from the web. This can be achieved by navigating to the Firewall page via the VPC Network portal, which displays all of the currently active firewall rules:

All we need to do now is hit Create Firewall Rule at the top and complete the resulting form provided to us, starting with an appropriate name and a description if you're nasty:

We can leave the next few options in their default state, and stop when we get to the Targets field.
Here we will need to specify http-server as our only tag, and in the Source filter section add 0.0.0.0/0 into the Source IP ranges:

Finally, in Protocols and ports, let's tick the tcp box and specify the Rails dev port 3000 in the text box next to it. With this finished, hit Create and we're ready to go:

On being redirected back to the firewall rules table, you should be able to see your new rule nestling comfortably somewhere within and we can head back to our VM instances table, where our VM should have finished spinning up:

We can see by the green tick under the Status column that our VM is ready to rock, and see that we can connect to it in the browser using its External IP when we come to checking our app.

 

 

Accessing the VM

All we need to do now is connect to our VM via SSH, which can achieved in a couple of ways.
The easiest of these is using the helpful little SSH button in the VM Instances table, which will open a pop-up that transfers the correct keys over and then provides a shell environment for you to work in.

Alternatively, if you would prefer to work in a local terminal emulator via SSH, we can set this up in a few easy steps:

  1. Create a new SSH key on your local workstation - on Ubuntu this can be achieved using: 

    $ ssh-keygen -t rsa
    and giving it a name identifying its use for GCE access, and either giving it a passphrase or just hitting Enter until you see your key's seminal randomart image.

  2. The output of the above command will have a line telling you where your public key has been saved to - either navigate to this this in a file browser or (on Linux) run: 

    $ cat /path/to/ssh-key.pub
    and copy the entire key to your clipboard.

  3. Now head back into the Compute Engine interface in your browser and select Metadata under Settings in the left-hand navigation menu.

  4. From here, select the SSH Keys tab at the top of the page:

  5. Hit the Add SSH keys button and you will see a small interface to paste your public key into:

  6. You should see the SSH username of your key appear to the left of the window if this key is recognised. If this is the case, hit Save to save your key to your project's metadata, which will allow it to work on all of the VMs in your project!

  7. Now all you need to do is head back to your VM instances table, grab the External IP address of your virtual machine and connect to it in your terminal using: 

    $ ssh {{SSH USERNAME}}@{{EXTERNAL IP}}
## for example:
$ ssh nask@34.105.173.148

With your connection set up, you are now ready to use the VM for whatever purposes you desire!

 

 

This concludes the guide to setting yourself up with a VM for your Rails development environment with GCE.
Please remember to switch it off when you have finished with it for the day, to avoid wasting your trial credit! This can be done by highlighting the VM in your instances table and selecting the Stop button, or selecting this option from the instance's option menu:

This guide was made to supplement a wider section on setting up a Rails development environment. Click here if you would like the remaining instructions on how to get your new VM ready to create a Rails project.

If you have already created your Rails project and wish to deploy it to Google App Engine, click here for instructions on how to deploy your app from your GCP VM.

 
 

Back

Comments

Post a Comment

Popular posts from this blog

[ToDoList] Basic Pages

Image
Well that was fun. However all we’ve really done is spooked someone called Bob, without actually creating anything remotely resembling a web application. Let’s rectify this and create some pages one would normally find on a website; a Home page and an About page. Home & Away About Helpful Links [Insert Beatles Reference]     Because we already learned a bit about MVC, we know that we will need a controller and at least one view to display these pages (we won’t need to worry about models until we’re handling real data). As before, we’ll need to add a route configuration so Rails knows where to go, too. Rails provides a fair bit of magic to streamline this process in the form of generators . However, because we’re learning, we’re going to do this manually for now and learn what this magic entails, so we can appreciate it more later. We already created a PagesController in the...
Read more

New Rails Apps with Docker Compose

Image
Following on from the Docker & docker-compose guides, it is possible to use docker-compose to build a Rails application that uses a PostgreSQL database without even installing Ruby on your local machine by instead using containers ! This becomes a very useful option to have if you work from many different workstations and don't want to ensure they are all equipped with the correct Ruby and Rails dependencies, or if you wish to use a version of Ruby / Rails not supported by your operating system (for example, Ubuntu 20.04 only allows provides up to Ruby 2.7 in its apt cache). In fact, Rails 7 added native support for Docker, such that it generates almost all of the default files we need for us! This comes with its problems and, I won't lie, updating this post to work with Rails 7 (it was previously written for Rails 6) has been a colossal pain and features a bit of hackery. However it is ultimately a good thing, and having ...
Read more

[ToDoList] Building the App

Image
The new Generator The Rails Development Server     So we have now learned some theory about Rails and set up our development environment with the required packages and version control prerequisites. I think that’s enough preamble, let’s get developing! The next few sections will involve creating a funky little web app that contains a To-Do list that we can add, remove and edit entries from. We saw a very small snippet of the extensive file structure that Rails uses in the first section. If you thought you’d be constructing the longest mkdir -p command in the observable universe to get all of this set up, you will be pleased to know (as I was) that our first utilisation of Rails magic will be to get Rails to generate all of this for us! Feel free to set up a projects directory on your dev machine, or you can just use your home dir if you’d prefer. Whatever you choose, change into this dir n...
Read more