Example build files are available at http://mark.gruden.com/masters-of-war-build-files.zip Mark walks though how to create a scalable and automated deployment process for Coldfusion apps using Ant. Starting with some reverse engineering of CF's built-in WAR deployment process, we'll then be working through to the separation of application code, the CF runtime and CF's configuration files into distinct elements that can be versioned independently and finally looking at how these assets can be deployed selectively to a number of servers and put back together into running applications.

1. Masters of WAR
Mark Stanton
@MarkStanto

2. Warning

3. Warning
• Don’t try this at home

4. Warning
• Don’t try this at home

5. Warning
• Don’t try this at home
• Unless you:
• have a lot of time and patience
• understand support/license implications

6. What we’ll cover
• Ant
• WAR
• JRun

7. Apache Ant
• Automated build system
• Java based
• XML configuration

8. Why Automated Builds?
• Repeatable
• Predictable
• Scalable

9. Why Ant?

10. Why Ant?
• Familiar
• Java
• Eclipse
• XML
• SSH/HTTP

11. Why Ant?
• Familiar
• Java
• Eclipse
• XML
• SSH/HTTP
• Hackable

12. Example: Deploying
Hello World

13. Example: Deploying
Hello World
• <project>

14. Example: Deploying
Hello World
• <project>
• <target>

15. Example: Deploying
Hello World
• <project>
• <target>
• Tasks:
• <echo>
• <scp>

16. Example: Depolying
Mango Blog

17. Example: Depolying
Mango Blog
• <property>

18. Example: Depolying
Mango Blog
• <property>
• depends=“ ”

19. Example: Depolying
Mango Blog
• <property>
• depends=“ ”
• Tasks:
• <zip>
• <sshexec>

20. Example: Depolying
Mango Blog

21. Example: Depolying
Mango Blog
• Tasks:
• <delete>
• <fileset>

22. Web Application
aRchives

23. Web Application
aRchives
“JAR file used to distribute a collection of JavaServer
Pages, servlets, Java classes, XML files, tag libraries
and static Web pages (HTML and related files) that
together constitute a Web application.”
http://en.wikipedia.org/wiki/WAR_(Sun_file_format)

24. Web Application
aRchives

25. Web Application
aRchives

26. Web Application
aRchives
• Special kind of JAR (which is a special ZIP)

27. Web Application
aRchives
• Special kind of JAR (which is a special ZIP)
• Directory structure (compressed or not)

28. Example: Creating a
WAR

29. Example: Manually
Deploying a WAR

30. JRun

31. JRun
• Hackable / Configurable
• XML files
• Properties files

32. JRun
• Hackable / Configurable
• XML files
• Properties files
• Versionable

33. JRun
• Hackable / Configurable
• XML files
• Properties files
• Versionable
• Deployable

34. JRun
• Hackable / Configurable
• XML files
• Properties files
• Versionable
• Deployable
http://gizmodo.com/5073637/fanboy-fever-explained-through-science

35. JRun Architecture
website website website website Sites
JRun Management
cfusion-ear/cfusion-war WAR/EAR Applications
Console
cfusion admin J2EE Server
Jrun Installation

36. JRun Architecture
website website website website Sites
example- JRun Management
cfusion-ear/cfusion-war WAR/EAR Applications
war Console
cfusion admin J2EE Server
Jrun Installation

37. Sandboxing
Website Website Website Website Sites
JRun Management
cfusion-ear cfusion-ear cfusion-ear cfusion-ear WAR/EAR Applications
Console
client 1 client 2 client 3 client 4 admin J2EE Server
Jrun Installation

38. Mixed Purpose
Mango A B Mango A B Sites
JRun Management
Blog Apps Blog Apps WAR/EAR Applications
Console
staging production admin J2EE Server
Jrun Installation

39. Memory Allocation
Mango A B Mango A B Sites
JRun Management
Blog Apps Blog Apps WAR/EAR Applications
Console
staging production admin J2EE Server
500MB 1GB 200MB
Jrun Installation

40. JRun Architecture
Mango A B Mango A B Apache Virtuals
JRun Management
Blog Apps Blog Apps Instances of Coldfusion
Console
staging production admin JVM instances
500MB 1GB 200MB
Jrun Installation

41. JRun Architecture
Mango A B Mango A B
jrun-web.xml
JRun Management
Blog Apps Blog Apps license.properies
Console
neo-*.xml
jvm.config
staging production admin jrun.xml
jndi.properties
500MB 1GB 200MB
Jrun Installation servers.xml

42. JRun Configuration

43. JRun Configuration
• {jrun}/lib/servers.xml
• Which servers are configured?
• Where does each server live?

44. Server Configuration

45. Server Configuration
• {jrun}/bin/jvm.config
• Path to JRE
• VM args - memory, GC
• Classpath

46. Server Configuration
• {jrun}/bin/jvm.config
• Path to JRE
• VM args - memory, GC
• Classpath
• Can have one per server

47. Server Configuration

48. Server Configuration
• {server}/SERVER-INF/jrun.xml
• Metrics & logging
• Deploy directory
• HTTP WebService & ProxyService ports

49. Server Configuration
• {server}/SERVER-INF/jrun.xml
• Metrics & logging
• Deploy directory
• HTTP WebService & ProxyService ports
• Beware of port conflicts

50. Server Configuration

51. Server Configuration
• {server}/SERVER-INF/jndi.properties
• Java Naming Service (JNDI) port
• Used for clustering

52. Application
Configuration

53. Application
Configuration
• {app-name}/WEB-INF/jrun-web.xml
• <context-root>/</context-root> is missing
by default
• Applications run under /{app-name}

54. Application
Configuration

55. Application
Configuration
• {app}/WEB-INF/cfusion/lib/neo-*.xml
• All settings for CF Administrator
• Caching, Memory, Verity, Data Sources,
Mail, etc

56. Creating a new server

57. Creating a new server

58. Creating a new server

59. Creating a new server

60. Creating a new server

61. Creating a new server
• Creates /opt/jrun4/servers/deploy containing

62. Creating a new server
• Creates /opt/jrun4/servers/deploy containing
• default-ear

63. Creating a new server
• Creates /opt/jrun4/servers/deploy containing
• default-ear
• SERVER-INF

64. Creating a new server
• Creates /opt/jrun4/servers/deploy containing
• default-ear
• SERVER-INF
• Delete default-ear application

65. Creating a new server
• Point Apache at the new server

66. WAR Deployment uses
Ant

67. Integrating with our
build

68. Example: Deploying a
WAR

69. Example: Deploying a
WAR

70. Example: Deploying a
WAR
• <antcall>

71. Example: Deploying a
WAR
• <antcall>
• <sleep>

72. Example: Deploying a
WAR
• <antcall>
• <sleep>
• <war>

73. Recap

74. Recap
• Created empty JRun server

75. Recap
• Created empty JRun server
• Created WAR containing empty CF instance

76. Recap
• Created empty JRun server
• Created WAR containing empty CF instance
• Integrated with Ant build

77. Recap
• Created empty JRun server
• Created WAR containing empty CF instance
• Integrated with Ant build
• Deployed WAR into JRun server along with
CF code

78. Why bother?

79. Cons

80. Cons
• Up front cost

81. Cons
• Up front cost
• Longer build time

82. Pros

83. Pros
• Save time

84. Pros
• Save time
• Prevent errors & inconsistencies

85. Pros
• Save time
• Prevent errors & inconsistencies
• Versioning of config & dependencies

86. Pros
• Save time
• Prevent errors & inconsistencies
• Versioning of config & dependencies
• Easy to scale

87. Pros
• Save time
• Prevent errors & inconsistencies
• Versioning of config & dependencies
• Easy to scale
• Good discipline

88. Make up your own mind

89. Other uses for Ant

90. Other uses for Ant
• Checkout from version control / Tag revision

91. Other uses for Ant
• Checkout from version control / Tag revision
• Minify & combine JS

92. Other uses for Ant
• Checkout from version control / Tag revision
• Minify & combine JS
• Run database update scripts

93. Other uses for Ant
• Checkout from version control / Tag revision
• Minify & combine JS
• Run database update scripts
• Run unit tests

94. Other uses for Ant
• Checkout from version control / Tag revision
• Minify & combine JS
• Run database update scripts
• Run unit tests
• Send notification email/SMS

95. Other uses for Ant
• Checkout from version control / Tag revision
• Minify & combine JS
• Run database update scripts
• Run unit tests
• Send notification email/SMS
• Continuous integration / scheduled builds

96. Extending Ant

97. Extending Ant
• Custom tasks

98. Extending Ant
• Custom tasks
• If you can do it in Java, you can do it in Ant

99. Extending Ant
• Custom tasks
• If you can do it in Java, you can do it in Ant
• Someone probably already has

100. Questions?