Feature: Add Kamal Deployment

[ronald2wing]

Streamlined Deployment for Wave

Live demo: https://commercestarterkits.com/admin
Credentials: [email protected] / password

Overview

This PR implements an automated deployment pipeline for the Wave using Kamal. By standardizing the deployment process, we've created a reliable and repeatable workflow that requires minimal configuration while maintaining consistency across environments.

Key Features

• One-command deployment and rollback
• Automated database backups
• Environment-specific configuration
• Detailed deployment logging
• Docker-based containerization

Prerequisites

• DigitalOcean Docker droplet
• Docker registry access credentials
• Environment variables configured for your deployment

Deployment Instructions

1. Container Setup

• Provision a DigitalOcean plain Ubuntu Docker droplet
• Configure SSH access for deployment automation

2. Registry Authentication

export KAMAL_REGISTRY_PASSWORD=your_token_here

3. Environment Configuration

Configure your deployment environment:

In .kamal/secrets or .env:

APP_KEY=your_app_key
AWS_ACCESS_KEY_ID=your_aws_key
AWS_SECRET_ACCESS_KEY=your_aws_secret
DB_PASSWORD=your_database_password

In .env.production:

PROD_HOST=site-domain
SSH_HOST=ssh-ip-address

4. Deployment Commands

Initial setup:

dotenv -f ".env.production" kamal setup -vvv

Rebuild environment:

dotenv -f ".env.production" kamal remove -y && dotenv -f ".env.production" kamal setup -vvv

Documentation

• Kamal deployment documentation
• MySQL backup configuration can be found in https://github.com/databacker/mysql-backup/blob/master/docs/configuration.md