Back to articles
AI & Cloud

Professional PHP and Node.js Deployment Solution with Ansistrano: Speed and Reliability

A detailed guide to deploying PHP and Node.js applications professionally using Ansistrano on VPS, ensuring speed, reliability, and automation for businesses.

DPTCloud Engineering4 min read
Professional PHP and Node.js Deployment Solution with Ansistrano: Speed and Reliability

Introduction to Ansistrano and Professional Deployment Solution

Ansistrano is an automation framework based on Ansible, designed to deploy web applications such as PHP and Node.js quickly, reliably, and professionally. By automating deployment workflows, Ansistrano helps businesses reduce errors, accelerate product launches, and ensure consistent deployment environments across development, staging, and production.

Prerequisites: Setting Up the Deployment Environment

To successfully deploy PHP or Node.js applications using Ansistrano, prepare the following:

  • A VPS (High-RAM Cloud VPS) running Ubuntu 20.04 or 22.04.
  • Ansible installed on your local machine or control node.
  • SSH key configured for secure access to the VPS.
  • Your PHP or Node.js application ready, including source code, configuration, and dependencies.

Deploying PHP and Node.js Applications with Ansistrano

Ansistrano offers a flexible configuration system that lets you define deployment steps such as software installation, backups, web server configuration, application startup, and more. Below is a basic configuration example for a Node.js application:

--- 
- name: Deploy Node.js application 
  hosts: all 
  become: yes 
  vars: 
    app_name: "my-node-app" 
    app_path: "/var/www/{{ app_name }}" 
    node_version: "16.x" 
    npm_version: "8.x" 
    git_repo: "https://github.com/yourusername/my-node-app.git" 
    git_branch: "main" 
    server_port: 3000 
  roles: 
    - role: ansistrano.deploy 
      app_name: "{{ app_name }}" 
      app_path: "{{ app_path }}" 
      git_repo: "{{ git_repo }}" 
      git_branch: "{{ git_branch }}" 
      deploy_via: "git" 
      setup: yes 
      update: yes 
      restart: yes 
    - role: ansistrano.release 
      app_name: "{{ app_name }}" 
      app_path: "{{ app_path }}" 
      release_name: "{{ ansible_date_time.iso8601 }}" 
      symlink: yes 
    - role: ansistrano.rollback 
      app_name: "{{ app_name }}" 
      app_path: "{{ app_path }}" 
      rollback: yes 
    - role: nodejs 
      nodejs_version: "{{ node_version }}" 
    - role: npm 
      npm_version: "{{ npm_version }}" 
    - role: nginx 
      nginx_server_name: "{{ app_name }}" 
      nginx_server_port: "{{ server_port }}" 
      nginx_server_root: "{{ app_path }}/public" 
      nginx_server_location: "/" 

Verification and Deployment Testing

After deployment, verify your application's status using the following commands:

ssh user@your-vps-ip
# Check application status
sudo systemctl status nodejs-app
# Check deployment logs
cat /var/log/ansistrano.log
# Test connectivity to the application port
curl -I http://localhost:3000

Troubleshooting and Notes

Common issues during deployment may include:

  • Ansible failing to connect to the VPS due to missing SSH keys or firewall settings.
  • Application not starting due to missing libraries or incompatible Node.js versions.
  • Ansistrano failing to create release directories or symlinks correctly.

To resolve these, check:

  • SSH key has been added to the VPS.
  • Ansible is installed in the correct version (>= 2.9).
  • Ansible configuration file has correct syntax and parameters.
  • Permissions are set correctly for application and log directories.

References

DPTCloud Tier III Infrastructure

High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02Recommended

VPS-4E

297.000 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe
ECO · vn-02

VPS-5E

614.900 ₫ / mo

10% VAT included

  • CPU: 8 vCPU
  • RAM: 16 GB
  • SSD: 100 GB NVMe
ADVANCED · vn-03Recommended

VPS-4T

548.900 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478