Deploy a Ruby web app to a VM in Azure Stack Hub

  • Article

You can create a VM to host your Ruby web app in Azure Stack Hub. In this article, you set up a server, configure the server to host your Ruby web app, and then deploy the app to Azure Stack Hub.

This article uses Ruby and a Ruby on Rails web framework.

Create a VM

  1. Set up your VM in Azure Stack Hub. For instructions, see Deploy a Linux VM to host a web app in Azure Stack Hub.

  2. In the VM network pane, make sure the following ports are accessible:

    Port Protocol Description
    80 HTTP Hypertext Transfer Protocol (HTTP) is the protocol that's used to deliver webpages from servers. Clients connect via HTTP with a DNS name or IP address.
    443 HTTPS Hypertext Transfer Protocol Secure (HTTPS) is a secure version of HTTP that requires a security certificate and allows for the encrypted transmission of information.
    22 SSH Secure Shell (SSH) is an encrypted network protocol for secure communications. You use this connection with an SSH client to configure the VM and deploy the app.
    3389 RDP Optional. The Remote Desktop Protocol (RDP) allows a remote desktop connection to use a graphic user interface on your machine.
    3000 Custom The port that's used by the Ruby on Rails web framework in development. For a production server, you route your traffic through 80 and 443.

Install Ruby

  1. Connect to your VM by using your SSH client. For instructions, see Connect via SSH with PuTTy.

  2. Install the PPA repository. At the bash prompt on your VM, enter the following commands:

    sudo apt -y install software-properties-common
sudo apt-add-repository ppa:brightbox/ruby-ng

sudo apt update

  3. Install Ruby and Ruby on Rails on your VM. While you're still connected to your VM in your SSH session, enter the following commands:

    sudo apt install ruby
gem install rails -v 4.2.6

  4. Install Ruby on Rails dependencies. While you're still connected to your VM in your SSH session, enter the following commands:

    sudo apt-get install make
sudo apt-get install gcc
sudo apt-get install sqlite3
sudo apt-get install nodejs
sudo gem install sqlite
sudo gem install bundler

    Note

    While you're installing Ruby on Rails dependencies, you might need to repeatedly run sudo gem install bundler. If the installation fails, review the error logs and resolve the issues.

  5. Validate your installation. While you're still connected to your VM in your SSH session, enter the following command:

        ruby -v

  6. Install Git, a widely distributed version control and source code management (SCM) system. While you're still connected to your VM in your SSH session, enter the following command:

       sudo apt-get -y install git

Create and run an app

  1. While you're still connected to your VM in your SSH session, enter the following commands:

        rails new myapp
    cd myapp
    rails server -b 0.0.0.0 -p 3000

  2. Go to your new server. You should see your running web application.

       http://yourhostname.chinacloudapp.cn:3000

Next steps