📕Deploy an Application with a Dockerfile on Clouddley Triggr

Learn how to deploy an application using a Dockerfile on Triggr.

Deploying applications with a Dockerfile on Clouddley Triggr allows you to containerize and manage your application efficiently. This guide provides step-by-step instructions on deploying an Express.js application using a Dockerfile, ensuring a seamless and reliable deployment process.

Prerequisites

Creating a Dockerfile

In the application root directory, create a Dockerfile triggr.dockerfile that defines how the app should be containerized.

Best Practice: When creating a Dockerfile, use a lightweight base image (e.g., node:alpine for Node.js apps) to reduce image size. Always specify exact versions for dependencies to ensure consistency.

triggr.dockerfile
# Use an official Node.js runtime as a parent image
FROM node:18-alpine

# Set the working directory in the container
WORKDIR /app

# Copy package.json and package-lock.json first for dependency installation
COPY package*.json ./

# Install dependencies
RUN npm install --omit=dev  # Use --omit=dev for production builds

# Copy the rest of the application code
COPY . .

# Expose the application port (ensure it matches the port your app listens on)
EXPOSE 3011

# Define the command to run the application
CMD ["node", "./bin/www"]

Building and Running the Container Locally

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

  1. Build the Docker image:

    docker build -t my-express-app -f triggr.dockerfile .
  2. Run the container:

    docker run -d -p 3011:3011 --name express-container my-express-app
  3. Verify the app is running by visiting http://localhost:3011.

Deploying the Application

Accessing Clouddley Triggr

  • Open your web browser, log in to your Clouddley account

  • Navigate to Triggr Apps and click on Deploy App.

Image of Triggr Apps dashboard.
Accessing Triggr Apps

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

Configuring Git hosting service during app deployment on Triggr Apps.
Choose your Git hosting service

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

Configuring the Git repository during app deployment on Triggr Apps.
Setup the Express.js application repository on Triggr

Step 3: Configure your Virtual Machine

  • To configure your VM, insert your VM hostname or IP address, VM user, and the VM port for SSH access.

  • Use the Clouddley CLI (recommended) or connect via SSH to verify.

The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal.

  • Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command:

curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh
  • To install Triggr, run the command:

clouddley triggr install

Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently.

  • Click on Verify. This verifies the connection.

  • Click on NEXT

Configuring the virtual machine during app deployment on Triggr Apps.
Configuration of virtual machine on Triggr

Step 4: Configure app settings

Insert the name of the application and its port.

Configuring App settings (name and port) during app deployment on Triggr Apps.
Configure the App name and port

The firewall of the virtual machine should allow access to the application port.

Step 5: Configure Environment Variables

  • To add environment variables, click on Add Variable

  • Choose an ENV mode, which can be either single or import variables. Learn more here.

Image showing the single variable ENV mode on Triggr Apps
Single variable ENV mode
  • Add the key-value pairs and Click on Save

  • Click on NEXT

Image showing environment variables added during app deployment on Triggr Apps.
Adding environment variables

Step 6: Setup 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

A gif showing how to set up notifications on Triggr Apps.
Notifications set up and creation of Express.js application on Triggr

Step 7: Test and Verify the app

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

  • After the app deployment is complete, the app status changes from deploying to running

An image of the overview of a successfully deployed Express.js application on Triggr Apps.
Express.js application dashboard overview
  • Click on 🌐 Website at the top right corner of the page, this opens the URL of the deployed application in your browser.

  • You can test the application functionalities.

An image of the Express.js application running on Triggr on the web.
Express.js application running from Triggr on a cloud virtual machine

The Express.js application has been successfully deployed on Triggr with a Dockerfile. You can manage it from the application dashboard by selecting the three-dot menu () in the top-right corner, where you will find options to Edit, Instant Rollback, Scale, Pause, or Delete the deployment.

Additionally, you can navigate through the dashboard tabs to:

  • View deployment history

  • Access and download logs

  • Add a custom domain

  • View and manage environment variables

Conclusion

Following these steps, you have successfully deployed an Express.js application with a Dockerfile on Clouddley Triggr. This method ensures a consistent, scalable, and efficient deployment workflow. Check out the source code for this application here.

Last updated

Was this helpful?