📗Deploy a Ruby on Rails App on Clouddley

In this guide, you'll learn how to deploy a Ruby on Rails Application on Clouddley, a backend infrastructure for your compute resources that is an advanced runtime auto-detection platform for zero-downtime deployments across different server types. Let's begin!

Prerequisites

• A GitHub or Bitbucket account.

• A Clouddley account.

• A Ruby on Rails application.

• A virtual machine on a Cloud platform or bare metal server.

Deploy your Ruby on Rails Application

Create a Dockerfile

Before deploying your Ruby app on Clouddley, create a Dockerfile triggr.dockerfile which defines how the Ruby app should be containerized.

FROM ruby:3.4.4-alpine

# Install only the essentials for your gems
RUN apk add --no-cache \
    build-base \
    yaml-dev \
    nodejs \
    yarn \
    tzdata \
    git

# Set working directory
WORKDIR /app

# Copy Gemfile and Gemfile.lock first (for caching)
COPY Gemfile Gemfile.lock ./

# Install gems
RUN bundle install

# Copy the rest of the application
COPY . .

EXPOSE 3000

CMD ["rails", "server", "-b", "0.0.0.0"]

Building and Running the Container Locally

Before deploying to Apps, verify that the container works locally.

1. Build the Docker image:

   Copy

   docker build -t ruby-app -f triggr.dockerfile .

2. Run the container:

   Copy

   docker run -d -p 3000:3000 --name ruby-container ruby-app

3. Verify the app is running by visiting http://localhost:3000

Accessing Apps on Clouddley

• Open your browser and log in to your Clouddley account

• Navigate to Apps and click on Deploy App

Step 1: Configure Service

• Choose your Git hosting service; either GitHub or Bitbucket. For this tutorial, we will be using GitHub.

• Click on Continue with GitHub

Step 2: Configure Git

• To connect your GitHub user or organization account, click the Select username/organization dropdown and Add GitHub account.

• Select your repository and the branch from the dropdown list or quickly search.

• Click on Next

Step 3: Configure your Virtual Machine

In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select + Add Virtual Machine.

Enter the following details to configure your VM:

• Hostname or IP address

• Username

• SSH port

After adding the details, use the Clouddley CLI (recommended) or connect via SSH to verify the connection.

curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh

clouddley add key

ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress

• Click on Verify. This verifies the connection.

• Click on Next

Step 4: Configure app settings

• Insert the name of the application and its port.

• Click on Next

Step 5: Configure Environment Variables

• To add environment variables, click on ➕ Add Variable

• Choose an ENV mode: either a single variable or import variables. Learn more here.

Single Variable

Import Variables

• Add the key-value pairs and click on Save

• Click on Next

Step 6: Set up Notifications (optional)

• To configure the notification settings of the application, click on ➕ Add Alert

• Select the Alert type. For this tutorial, we will set up Email alerts.

• Toggle on the buttons of the deployment event (failed, timed out, or success) you want to be notified of.

• Enter the Email address where you want to receive alerts. (You can add multiple email addresses)

• Click on Save

• Click on Deploy

Step 7: Test and Verify the app

• Click on Go to Dashboard. Your app will be visible on the apps dashboard.

• After the app deployment is complete, the app status changes from Deploying to Online

• Click on 🌐 Website at the top right corner of the page, which opens the URL of the deployed application in your browser.

• You can test the application functionalities.

You have deployed a Ruby on Rails application successfully on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (...) at the top-right corner to access Edit, Instant Rollback, Scale, Pause, and Delete options.

Additionally, you can switch to different tabs on the application dashboard to perform the following actions: view your deployment history, view or download logs, add a custom domain, and view the environment variables.

Conclusion

You've successfully deployed a Ruby on Rails application on Clouddley! To access the source code of this application, check here. Furthermore, to explore how different frameworks can be deployed on Clouddley, check out our how-to guides.