Blog

Boxlang Multisite using Docker and Commandbox

docker-compose.yml

version: '3.4'    
services:

  bxapp:
    image: ortussolutions/commandbox:jdk21
    environment:
      - BOX_SERVER_APP_CFENGINE=boxlang
      - cfengine=boxlang
      - BOXLANG_DEBUG=true
      - BOXLANG_MODULES=bx-compat-cfml,bx-esapi,bx-mysql
      - REWRITES=false
      - BOXLANG_HOME=/var/boxlang
      - BOXLANG_HEALTH_CHECK=false
      - BOX_SERVER_WEB_useProxyForwardedIP=true
    ports:
      - 80:8080
      - 443:443
    volumes:
      - /var/www/domains/:/var/www/
      - /var/www/domains/app:/app
      - /etc/letsencrypt/:/etc/letsencrypt/
      
    healthcheck:
      test: ["CMD", "curl", "-f", "http://127.0.0.1:8080/"]
      interval: 60s
      timeout: 30s
      retries: 5

    deploy:
      replicas: 1
      update_config:
        parallelism: 1
        delay: 0s
        failure_action: continue
        order: start-first
      restart_policy:
        condition: on-failure
        delay: 5s

docker-compose.yml with nginx in front:

version: '3.4'    
services:
 web:
   image: nginx
   volumes:
     - /var/www/nginx/nginx.conf:/etc/nginx/nginx.conf
     - /var/www/nginx/conf.d/:/etc/nginx/conf.d/
     - /var/www/nginx/boxlang.conf:/etc/nginx/boxlang.conf
     - /var/www/nginx/boxlang-proxy.conf:/etc/nginx/boxlang-proxy.conf
     - /var/www/domains/:/var/www/
     - /etc/letsencrypt/:/etc/letsencrypt/
   ports:
     - target: 80
       published: 80
       mode: host
     - target: 443
       published: 443
       mode: host
   depends_on:
       - bxapp

 bxapp:
   image: ortussolutions/commandbox:jdk21
   environment:
     - BOX_SERVER_APP_CFENGINE=boxlang
     - cfengine=boxlang
     - BOXLANG_DEBUG=true
     - BOXLANG_MODULES=bx-compat-cfml,bx-esapi,bx-mysql
     - REWRITES=false
     - BOXLANG_HOME=/var/boxlang
     - BOXLANG_HEALTH_CHECK=false
     - BOX_SERVER_WEB_useProxyForwardedIP=true
   ports:
     - 8080:8080
   volumes:
     - /var/www/domains/:/var/www/
     - /var/www/domains/app:/app
     - /var/www/boxlang:/var/boxlang
     - /etc/letsencrypt/:/etc/letsencrypt/
     
   healthcheck:
     test: ["CMD", "curl", "-f", "http://127.0.0.1:8080/"]
     interval: 60s
     timeout: 30s
     retries: 5

   deploy:
     replicas: 1
     update_config:
       parallelism: 1
       delay: 0s
       failure_action: continue
       order: start-first
     restart_policy:
       condition: on-failure
       delay: 5s

CommandBox 6 Multisite Docker with MOD_CFML

Follow along in the video https://www.youtube.com/watch?v=eVmMw5TAwcc

Clone this repo: https://github.com/ortus-Solutions/docker-commandbox

git clone https://github.com/ortus-Solutions/docker-commandbox

We first need to modify the install-commandbox.sh. file located in build/util/install-commandbox.sh

On around line 25 you will see box config set server.singleServerMode=true we need to change that to false:

box config set server.singleServerMode=false

On around line 29 just after the initial box conf set server.daults... add the following:

box server set ModCFML.enable=true
box server set ModCFML.sharedKey=my-secret
box server set web.ajp.enable=true web.ajp.port=8009

NOTE: You need to make note of the sharedKey as it will be used later and I HIGHLY suggest you change this shareKey for security reasons.

The next step is to get the docker image up on dockerhub.io. You will need an account there, please sign up at https://hub.docker.com/ You can skip this step if you're familiar with Docker and know how to pull the image locally

From the terminal in the same folder as the git repo above enter the following to build the docker image.

docker build -f builds/debian/Lucee5.Dockerfile -t YOURUSERNAME/mycommandbox . --build-arg COMMANDBOX_VERSION=6.0.1

Next you will need to login to docker from the terminal using docker login, enter your credentials and now you're ready to push your image.

To push your image type in docker push YOURUSERNAME/mycommandbox

Your image should now appear on Docker Hub.

For the next steps I'm going to use a program called Portainer. Instructions for getting this installed in docker can be found at https://docs.portainer.io/start/install-ce/server/docker/linux

Copy the lucee.conf, and lucee-proxy.conf file from https://viviotech.github.io/mod_cfml/install-nginx.html into the /var/www/nginx/ directory.

You then need to create your sites config in /var/nginx/conf.d/

sample site1.com.conf file

server {
  listen 80;
  server_name site1.com;
  root /var/www/site1.com/;

  set $lucee_context "site1.com";
  include lucee.conf;
}

You need to create a new stack in portainer with the following information.

version: '3.4'    
services:
  web:
    image: nginx
    volumes:
      - /var/nginx/conf.d/:/etc/nginx/conf.d/
      - /var/nginx/lucee.conf:/etc/nginx/lucee.conf
      - /var/nginx/lucee-proxy.conf:/etc/nginx/lucee-proxy.conf
      - /var/www/:/var/www/

    ports:
      - 80:80
      - 443:443
  app:
    image: YOURUSERNAME/mycommandbox

    # Ports
    ports:
      - 8885:8080
    volumes:
      - /var/www/:/var/www/
      
    healthcheck:
      test: ["CMD", "curl", "-f", "http://127.0.0.1:8080/"]
      interval: 30s
      timeout: 10s
      retries: 5
#      start_period: 180s
      
      # Deployment Configuration
    deploy:
      replicas: 1
      update_config:
        parallelism: 1
        delay: 0s
        failure_action: continue
        order: start-first
      restart_policy:
        condition: on-failure
        delay: 5s

*IMPORTANT: Be sure to check your image on docker hub to make sure it's private and not public. You should also setup appropriate firewalls on DigitalOcean droplet

USE THIS AS A GUIDE ONLY. IT COMES WITHOUT WARRANTY

Private S3 Server with Docker+Scality S3 Server

docker run -d \
--name mys3server \
-p 8000:8000 \
-e SCALITY_ACCESS_KEY_ID=myAccessKey \
-e SCALITY_SECRET_ACCESS_KEY=mySuperSecretKey123 \
-v s3data:/usr/src/app/localData \
-v s3metaData:/usr/src/app/localMetadata \
scality/s3server

Connection Options: https://github.com/scality/S3/blob/master/README.md#command-line-tools

I prefer the s3cmd.

Once you configured ~/.s3cfg you here's some commands you can run.

#This will create the bucket webfiles
s3cmd mb s3://webfiles

#This will upload a test.txt file from the mac desktop to the  webfiles bucket.
s3cmd put ~/Desktop/test.txt  s3://webfiles

#This will List All objects (buckets, files inside buckets)
s3cmd la

#This will list all files in the webfiles bucket.
s3cmd ls s3://webfiles

Private Bitbucket Repo's with CommandBox and Mac

ssh-keygen -f ~/.ssh/privatebitbucket -C "privatebitbucket"

Edit the ~/.ssh/config file.

Host privatebitbucket
 HostName bitbucket.org
 IdentityFile ~/.ssh/privatebitbucket

Copy the new key to clipboard to add to bitbucket.

pbcopy < ~/.ssh/privatebitbucket.pub

Login to bitbucket and add the ssh key:

List the currently loaded keys:

$ ssh-add -l

If necessary, add your new key to the list:

$ ssh-add ~/.ssh/privatebitbucket

List the keys again to verify the add was successful:

$ ssh-add -l

   _____                                          _ ____             
  / ____|                                        | |  _ \            
 | |     ___  _ __ ___  _ __ ___   __ _ _ __   __| | |_) | _____  __ 
 | |    / _ \| '_ ` _ \| '_ ` _ \ / _` | '_ \ / _` |  _ < / _ \ \/ / 
 | |___| (_) | | | | | | | | | | | (_| | | | | (_| | |_) | (_) >  <  
  \_____\___/|_| |_| |_|_| |_| |_|\__,_|_| |_|\__,_|____/ \___/_/\_\   v3.7.0-SNAPSHOT+00685

Welcome to CommandBox!
Type "help" for help, or "help [command]" to be more specific.

CommandBox:you> install git+ssh://git@privatebitbucket:[BITBUCKETUSERNAME]/[privaterepo].git