Herding cats managing ColdFusion servers with commandbox
0 likes619 views
Brad Wood presents CommandBox, a command line tool for managing ColdFusion servers. CommandBox allows starting and stopping CF servers of different versions, setting configuration options like ports and directories, and publishing packages to ForgeBox. It downloads CF engines on demand, requires no installation, and provides a simple way to manage multiple server configurations and versions without having to reinstall an operating system.
![Custom menu items
● Customize tray icon
● Contribute new menu items
○ Stop server
○ Open URL
● Change existing menus
● remove default menus
Brad Wood
Ortus Solutions
@bdw429s
{
"trayOptions":[
{
"label":"Foo",
"action":"openbrowser",
"url":"http://..."
}
],
"trayicon":"myTrayIcon.png"
}](https://image.slidesharecdn.com/ig1yambkremoaahepncd-signature-18098009b6e0b23319985220ee2f052e1eafe96a14816e4ea0b91f07f924c10e-poli-161018175045/85/Herding-cats-managing-ColdFusion-servers-with-commandbox-25-320.jpg)
Ad
More Related Content
What's hot (20)
Viewers also liked (20)
![Single page apps_with_cf_and_angular[1]](https://cdn.slidesharecdn.com/ss_thumbnails/rguckcbqqt2k4rnw6eno-140518085920-phpapp02-thumbnail.jpg?width=560&fit=bounds)
Ad
Similar to Herding cats managing ColdFusion servers with commandbox (20)
Ad
More from ColdFusionConference (20)
Recently uploaded (20)
Herding cats managing ColdFusion servers with commandbox
- 1. ColdFusion Summit 2016 Herding Cats A new way to manage your servers
- 2. About Me • ColdFusion Architect (14 years) • Geek • Android Lover • Blogger (codersrevolution.com) • ColdBox Developer Advocate • Musician • Shade-Tree Mechanic • Husband (13 years) • Dad (3 beautiful girls) Brad Wood Ortus Solutions @bdw429s
- 3. About You Brad Wood Ortus Solutions @bdw429s
- 4. What our friends think we do Brad Wood Ortus Solutions @bdw429s
- 5. What our mom thinks we do Brad Wood Ortus Solutions @bdw429s
- 6. What our coworkers think... Brad Wood Ortus Solutions @bdw429s
- 7. What we really do Brad Wood Ortus Solutions @bdw429s
- 8. What do we install? • ColdFusion ○ CF 9 ○ CF 10 ○ CF 11 ○ CF 2016 ○ Custom WARs •Tomcat, Jetty •Apache/Nginx/IIS •CFML project dependencies Brad Wood Ortus Solutions @bdw429s
- 9. What do we configure? • Ports ○ HTTP ○ AJP ○ Servlet Stop Port • Installation directories • Rewrites • Virtual Directories • Hosts (for more than one site) Brad Wood Ortus Solutions @bdw429s Multiply that times every CF version you need to test!
- 10. You’re herding cats Brad Wood Ortus Solutions @bdw429sPerish the thought you need to reinstall your OS!
- 11. Solutions • Vagrant • Docker •Still requires installs to get started •Can be steep learning curve •Can be heavy on resources Brad Wood Ortus Solutions @bdw429s
- 12. Commandbox CLI • Command line tool • Runs CFML from the console ○ REPL ○ CFM execution ○ Custom Commands • Manages code libraries •Use as a build tool •Publish packages to ForgeBox •Start/stop/manage servers Brad Wood Ortus Solutions @bdw429s
- 13. What is CommandBox? • Native binary ○ Windows ○ Mac ○ Linux • No installation •Small (~35MB) •Downloads CF engines on demand •Local artifacts •Free open source •Professionally supported Brad Wood Ortus Solutions @bdw429s
- 14. Let’s take a look...
- 15. Start servers ● Params ○ port ○ SSLEnable ○ rewritesEnable ○ cfengine ○ heapSize ● Separate process for each server ● Start more than one Brad Wood Ortus Solutions @bdw429s > start > start port=8080 --rewritesEnabled > start heapSize=1024 --!openBrowser
- 16. CF Engines ● Adobe ○ 9, 10, 11, 2016 ● All “other” engines too ● All recent updates ● Any valid endpoint ○ Forgebox ■ Semver ranges ○ HTTP ○ local ● Custom Wars ● CF engines ● Jenkins Brad Wood Ortus Solutions @bdw429s > start cfengine=adobe > start cfengine=adobe@11 > start [email protected]+300068 > start cfengine=”adobe@>9 <=11” > start warPath=jenkins.war
- 17. Configure Server • Ports/host ○ HTTP ○ HTTPS • Certs • Bind to host •JVM Settings •Built in support for heap size •Any other JVM args supported ○ Java agents ○ Debugger ○ System Properties Brad Wood Ortus Solutions @bdw429s
- 18. server.json ● Persists all settings for starting a server ● Portable ● Created automatically ● Commands to manage ○ server set ○ server show ○ server clear Brad Wood Ortus Solutions @bdw429s { "name":"myServer", "app":{ "cfengine":"adobe@2016" }, "web":{ "http":{ "port":8000 }, "rewrites":{ "enable":true } }, "jvm":{ "heapsize":1024 } }
- 19. Config settings ● Same as server.json but global ● Applies to all servers ● server.defaults ● Commands to manage ○ config set ○ config show ○ config clear Brad Wood Ortus Solutions @bdw429s { "server":{ "defaults":{ "app":{ "cfengine":"adobe@2016" }, "web":{ "rewrites":{ "enable":true } }, "jvm":{ "heapsize":1024 } } } }
- 20. Hierarchy of settings 1. CLI params 2. Server.json 3. Config setting server defaults •If port is in use, picks another •Settings like JVM args cumulative Brad Wood Ortus Solutions @bdw429s
- 21. File system paths • Relative to the CWD when passed as CLI params • Relative to the server.json when stored there • Relative to the web root when stored in config Setting • Can always be absolute paths • When saved in server.json, will be made relative if possible Brad Wood Ortus Solutions @bdw429s
- 22. Managing multiple servers • Named servers • Different server.json files • Listing & managing servers • Server info • Server cd Brad Wood Ortus Solutions @bdw429s
- 23. Web aliases • Map web URL to any file system path • For static files or CFML • Set in server.json • Set in config setting server defaults Brad Wood Ortus Solutions @bdw429s { "web":{ "aliases":{ "/bar":"foo" } } }
- 24. Custom error pages ● Customize responses for missing files ● Redirects to a file in the web root ● Can be static or .cfm ● Any status code ○ 404 ○ 500 ○ default Brad Wood Ortus Solutions @bdw429s { "web":{ "errorpages":{ "404":"/missing.htm", "500":"/sorry.htm" } } }
- 25. Custom menu items ● Customize tray icon ● Contribute new menu items ○ Stop server ○ Open URL ● Change existing menus ● remove default menus Brad Wood Ortus Solutions @bdw429s { "trayOptions":[ { "label":"Foo", "action":"openbrowser", "url":"http://..." } ], "trayicon":"myTrayIcon.png" }
- 26. FusionReactor • CommandBox Module • Downloads on demand (and caches) • Uses onServerStart interceptor to load JVM args • Set license to use for all servers • commands ○ fr register ○ fr open Brad Wood Ortus Solutions @bdw429s
- 27. Offline server starts • Use a specific version number for cfengine • If you ever delete ~/.CommandBox, leave the artifacts folder! • If ForgeBox is down, checks your local artifacts folder Brad Wood Ortus Solutions @bdw429s
- 28. What CommandBox isn’t • 110% Exactly the same as your production setup • A database ○ MariaDB module ○ Embedded H2 • A virtual machine • A service that starts on boot ○ You can make it be! Brad Wood Ortus Solutions @bdw429s
- 30. Thank you!