CONFIGURING COLDFUSION DOCKER CONTAINERS THROUGH ENVIRONMENT VARIABLES GUUST NIEUWENHUIS 

ABOUT ME Guust Nieuwenhuis Managing Partner @ We Are North Full Stack Web Wizard Masa CMS Born in The Netherlands Living in Belgium Football coach Mountainbiker 

CONFIGURING COLDFUSION DOCKER CONTAINERS THROUGH ENVIRONMENT VARIABLES GUUST NIEUWENHUIS 

12FACTOR.NET The twelve-factor app is a methodology for building software-as-a-service apps 

https://12factor.net/ 

I. Codebase II. Dependencies III. Config IV. Backing services V. Build, release, run VI. Processes VII. Port binding VIII. Concurrency IX. Disposability X. Dev/prod parity XI. Logs XII. Admin processes 

I. Codebase II. Dependencies III. Config IV. Backing services V. Build, release, run VI. Processes VII. Port binding VIII. Concurrency IX. Disposability X. Dev/prod parity XI. Logs XII. Admin processes 

STORE CONFIG IN THE ENVIRONMENT An app’s con fi g is everything that is likely to vary between deploys (staging, production, developer environments, etc) 

No content

I. Codebase II. Dependencies III. Config IV. Backing services V. Build, release, run VI. Processes VII. Port binding VIII. Concurrency IX. Disposability X. Dev/prod parity XI. Logs XII. Admin processes 

Environment variables 

A VARIABLE WHOSE VALUE IS SET OUTSIDE THE APPLICATION AND AFFECTS THE WAY APPLICATIONS BEHAVE Since 1979 

$ printenv __CFBundleIdentifier=com.apple.Terminal TMPDIR=/var/folders/39/dlwg4phj09508hq4d8zhrs600000gn/T/ XPC_FLAGS=0x0 LaunchInstanceID=7B6325E4-B6DB-4A0B-8CC9-1FC70EECBAD7 TERM=xterm-256color SSH_AUTH_SOCK=/private/tmp/com.apple.launchd.055kmmIwsv/Listeners SECURITYSESSIONID=186a6 XPC_SERVICE_NAME=0 TERM_PROGRAM=Apple_Terminal TERM_PROGRAM_VERSION=447 PWD=/Users/guustnieuwenhuis SHLVL=2 SHELL=/bin/zsh HOME=/Users/guustnieuwenhuis LOGNAME=guustnieuwenhuis USER=guustnieuwenhuis PATH=/Users/guustnieuwenhuis/.gem/ruby/3.0.0/bin: OLDPWD=/Users/guustnieuwenhuis LC_CTYPE=UTF-8 _=/usr/bin/printenv 

$ printenv HOME HOME=/Users/guustnieuwenhuis 

$ echo $HOME HOME=/Users/guustnieuwenhuis 

$ cat .env REACT_APP_API_KEY=your-development-api-key REACT_APP_DATABASE_URL=https://your-development-database.com REACT_APP_PROJECT_ID=your-development-project-id 

Docker environment variables 

Docker build Docker run Docker compose 

$ docker build -t app --build-arg VERSION=1.0 . [+] Building 0.0s (5/5) FINISHED => [internal] load .dockerignore => => transferring context: 2B => [internal] load build definition from Dockerfile => => transferring dockerfile: 147B => [internal] load metadata for docker.io/adobecoldfusion/coldfusion:latest => CACHED [1/1] FROM docker.io/adobecoldfusion/coldfusion => exporting to image => => exporting layers => => writing image sha256:5afe3a1890d670e183df27e6a9acc5da23c1e4da9a93c8d09fb957b7351fe59d => => naming to docker.io/library/app 

$ docker build -t app --build-arg VERSION=${BITBUCKET_TAG} . [+] Building 0.0s (5/5) FINISHED => [internal] load .dockerignore => => transferring context: 2B => [internal] load build definition from Dockerfile => => transferring dockerfile: 147B => [internal] load metadata for docker.io/adobecoldfusion/coldfusion:latest => CACHED [1/1] FROM docker.io/adobecoldfusion/coldfusion => exporting to image => => exporting layers => => writing image sha256:5afe3a1890d670e183df27e6a9acc5da23c1e4da9a93c8d09fb957b7351fe59d => => naming to docker.io/library/app 

FROM adobecoldfusion/coldfusion ENV VERSION=${VERSION} Docker fi le 

$ docker run -p 80:8500 -e acceptEULA=YES adobecoldfusion/coldfusion Updating webroot to /app Configuring virtual directories Skipping password updation Skipping language updation Serial Key: Not Provided Previous Serial Key: Not Provided Starting ColdFusion Starting ColdFusion 2023 server ... ====================================================================== ColdFusion 2023 server has been started. ColdFusion 2023 will write logs to /opt/coldfusion/cfusion/bin/../logs/coldfusion-out.log ====================================================================== 

$ docker run -p 80:8500 --env acceptEULA=YES adobecoldfusion/coldfusion Updating webroot to /app Configuring virtual directories Skipping password updation Skipping language updation Serial Key: Not Provided Previous Serial Key: Not Provided Starting ColdFusion Starting ColdFusion 2023 server ... ====================================================================== ColdFusion 2023 server has been started. ColdFusion 2023 will write logs to /opt/coldfusion/cfusion/bin/../logs/coldfusion-out.log ====================================================================== 

$ docker run -p 80:8500 --env-file ./.env adobecoldfusion/coldfusion Updating webroot to /app Configuring virtual directories Skipping password updation Skipping language updation Serial Key: Not Provided Previous Serial Key: Not Provided Starting ColdFusion Starting ColdFusion 2023 server ... ====================================================================== ColdFusion 2023 server has been started. ColdFusion 2023 will write logs to /opt/coldfusion/cfusion/bin/../logs/coldfusion-out.log ====================================================================== 

$ cat .env acceptEULA=YES 

version: "3.7" services: app: image: adobecoldfusion/coldfusion environment: - acceptEULA=YES docker-compose.yml 

version: "3.7" services: app: image: adobecoldfusion/coldfusion env_file: ./.env docker-compose.yml 

Environment variables precedence 1. Set using docker compose run -e in the CLI 2. Substituted from your shell 3. Set using the environment attribute in the Compose file 4. Use of the --env-file argument in the CLI 5. Use of the env_file attribute in the Compose file 6. Set using an .env file placed at base of your project directory 7. Set in a container image in the ENV directive. Having any ARG or ENV setting in a Dockerfile evaluates only if there is no Docker Compose entry for environment, env_file or run --env. 

Configuring Adobe CF 

https://helpx.adobe.com/in/coldfusion/using/docker-images-coldfusion.html 

Required ENV Variables: acceptEULA=YES Optional ENV variables: serial= previousSerial= password= enableSecurePro fi le= con fi gureExternalSessions= externalSessionsHost= externalSessionsPort= externalSessionsPassword= con fi gureExternalAddons= addonsHost= addonsPort= addonsUsername= addonsPassword= addonsPDFServiceName= addonsPDFSSL= setupScript= setupScriptDelete= language= installModules= importCFSettings= importCFSettingsPassphrase= importModules= 

version: "3.7" services: app: image: adobecoldfusion/coldfusion environment: docker-compose.yml - acceptEULA=YES - serial=xxx - password=adminpassword - enableSecureProfile=true 

Configuring Commandbox 

https://hub.docker.com/r/ortussolutions/commandbox/ 

version: "3.7" services: app: image: ortussolutions/commandbox environment: docker-compose.yml - BOX_SERVER_APP_CFENGINE=adobe@2023 - BOX_SERVER_PROFILE=development - BOX_SERVER_CFCONFIGFILE=/config/cfconfig.json 

{ "adminPassword" : “${ADMIN_PASSWORD}” } cfcon fi g.json 

https://www.forgebox.io/view/commandbox-dotenv 

Configuring Masa CMS 

https://docs.masacms.com/getting-started/con fi guration/env-variables/ 

All settings.ini.cfm settings Format: MURA_{setting} 

[settings] appreloadkey=appreload mode=production [production] admindir=/admin admindomain= adminemail= adminssl=false allowautoupdates=true allowedIndexFiles=index.cfm,index.json,index.html allowlocalfiles=false alwaysUseLocalRenderer=false assetdir=/s3assets assetpath= autodiscoverplugins=true autoresetpasswords=false autoupdateurl=https://github.com/MasaCMS/MasaCMS/archive/main.zip bcryptpasswords=true clientmanagement=false settings.ini.cfm 

version: "3.7" services: app: image: adobecoldfusion/coldfusion environment: docker-compose.yml - MURA_ADMIN_USERNAME: admin - MURA_ADMIN_PASSWORD: admin - MURA_ADMINEMAIL: [email protected] - MURA_APPRELOADKEY: appreload - MURA_SITEIDINURLS: "true" - MURA_INDEXFILEINURLS: "true" - MURA_DBTYPE: mysql - MURA_DBCONNECTIONSTRING: “jdbc:mysql://masa_mysql:3306/masadb" - MURA_DBCLASS: com.mysql.jdbc.Driver - MURA_DBUSERNAME: root - MURA_DBPASSWORD: rootpassword - MURA_DBHOST: masa_mysql - MURA_DBPORT: 3306 

Configuring own apps 

server.system.environment 

version: "3.7" services: docker-compose.yml mysql: image: mysql:latest environment: MYSQL_ROOT_PASSWORD: rootpassword MYSQL_DATABASE: testdb app: image: adobecoldfusion/coldfusion environment: - DBTYPE: mysql - DBCLASS: com.mysql.jdbc.Driver - DBCONNECTIONSTRING: "jdbc:mysql://mysql:3306/testdb" - DBUSERNAME: root - DBPASSWORD: rootpassword 

component { this.datasources = { testdb = { driver = server.system.environment.DBTYPE, class = server.system.environment.DBCLASS, url = server.system.environment.DBCONNECTIONSTRING, username = server.system.environment.DBUSERNAME, password = server.system.environment.DBPASSWORD } }; } Application.cfc 

Configuring on AWS 

No content

No content

TaskDefinition: Type: AWS::ECS::TaskDefinition Properties: NetworkMode: 'awsvpc' Cpu: '256' Memory: '512' ExecutionRoleArn: !Ref TaskRole TaskRoleArn: !Ref TaskRole RequiresCompatibilities: - FARGATE ContainerDefinitions: - Name: "acfengine" Image: "adobecoldfusion/coldfusion" Environment: - Name: "acceptEULA" Value: "YES" - Name: "serial" Value: "ssm://my.acf.serial" AWS CloudFormation 

const containerDefinitionProps: ecs.ContainerDefinitionProps = { image: containerImage, taskDefinition: taskDefinition, environment: { acceptEULA: 'YES', }, secrets: { serial: EcsSecret.fromSsmParameter( StringParameter.fromStringParameterAttributes( stack, "serial", { parameterName: `/ecs/ecd/serial`, } ) ), }; AWS CDK 

Configuring on GCP 

No content

No content

Configuring on Azure 

No content

CONFIGURING COLDFUSION DOCKER CONTAINERS THROUGH ENVIRONMENT VARIABLES [email protected] https://www.linkedin.com/in/guustnieuwenhuis 
 www.wearenorth.eu 

No content