12 Factor App. Best Practices for Scala Deployment

Transcription

1 12 Factor App Best Practices for Scala Deployment

2 WAR files JAR files App Servers Microservices Hot-Deploy Continuous Deploy Java Scala

3 Joe JVM Platform

4 12 Factor App a methodology Scalability Maintainability Portability

5 Immutable Ephemeral Declarative Automated

6

7 project/plugins.sbt addsbtplugin( "com.typesafe.sbt" % "sbt-native-packager" % "0.7.6" )

8 $ sbt stage

9 without further ado

10 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

11 Thank You! Goodbye! (just kidding)

12 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

13 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

14 Use Version Control

15

16

17 BAD

18 App #1 App #2 BAD

19 my-project! build.sbt! app! conf! public! my-library! build.sbt! src! main! scala

20 my-project! build.sbt! app! conf! public! my-library! my-sub-project! build.sbt! src! main! scala BAD

21 Submodules

22 $ git submodule add

23 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

24 Don t check JAR files into Git

25

26 Explicitly declare and isolate dependencies Never rely on implicit existence of system-wide packages

27 Dependencies global BAD ~/.m2 local GOOD target/ ~/.ivy2 (ok in dev)

28 Vendoring GOOD

29 $ sbt stage... $ tree target/universal/stage/lib/ target/universal/stage/lib/ "## ch.qos.logback.logback-classic jar "## ch.qos.logback.logback-core jar "## com.fasterxml.jackson.core.jackson-annotations "## com.fasterxml.jackson.core.jackson-core jar "## com.fasterxml.jackson.core.jackson-databind jar "## com.google.guava.guava jar...

30 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

31 Don t check passwords into Git

32 Or was it DUH?

33 Litmus Test Can you make your app open source at any moment, without compromising any credentials?

34 Configuration is Anything that changes between deployment environments: Resource handles to the database, Memcached, and other backing services Credentials to external services such as Amazon S3 or Twitter Per-deploy values such as the canonical hostname for the deploy (does not include things like conf/routes)

35 Configuration should be strictly separated from code Configuration belongs in the environment, not in the application

36 conf/application.conf db.default.url=${database_url}

37 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

38 conf/application.conf db.default.url=${database_url}

39 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

40 build, release, run

41 build $ sbt stage... release run $ sbt deployheroku... # in the cloud! $ target/universal/stage/bin/my-app

42 $ sbt run BAD (in production)

43 simple build tool

44 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

45 DEMO!

46 build $ sbt stage... release run $ sbt deployheroku... # in the cloud! $ target/universal/stage/bin/scaladays

47 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

48 Processes should be stateless

49 sticky sessions

50 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

51 The twelve-factor app is completely self-contained The web app exports HTTP as a service by binding to a port

52 Traditional Deployment.war

53 Modern Deployment.jar

54 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

55 Actors Futures Agents RELAX BRO, I GOT THIS

56 Scale Up Scale Out

57 worker.3 Number of Processes web.2 worker.2 web.1 worker.1 clock.1 Workload Diversity

58 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

59 Quick startup Resilience to failure Graceful shutdown

60 Servers are not pets Servers are cattle

61 Application Servers are not disposable

62 Microservices are disposable

63 Easy to replace Easy to modify Decoupled from external infrastructure

64 Microservices

65 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

66 dev = stage = prod sqlite mysql postgres postgres = postgres = postgres

67 dev = stage = prod jetty tomcat jboss jetty = jetty = jetty

68 dev = stage = prod jetty tomcat jboss {} = {} = {}

69 Dropwizard

70 parity reproducible disposable

71 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

72 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

73 Admin tasks should be run in isolated processes

74 $ heroku run console Running `console` attached to terminal... up, run.2581 Picked up JAVA_TOOL_OPTIONS: -Djava.rmi.server.useCode... Failed to created JLineReader: java.lang.noclassdeffou... Falling back to SimpleReader. Welcome to Scala version (OpenJDK 64-Bit Server... Type in expressions to have them evaluated. Type :help for more information. scala>

75 web1 web3 web2 admin

76 $ heroku run sbt console?

77 simple build tool

78 project/plugins.sbt addsbtplugin( "com.typesafe.sbt" % "sbt-native-packager" % "0.7.6" )

79 Procfile console: target/universal/stage/bin/my-app \ -main scala.tools.nsc.maingenericrunner \ -usejavacp worker: target/universal/stage/bin/my-app \ -main com.example.myworker

80 The 12 Factors Codebase Dependencies Config Backing services Build, release, run Processes Port binding Concurrency Disposability Dev/prod parity Logs Admin processes

81

82 What next? Add sbt-native-packager Run `sbt stage` Deploy to Heroku? Go to the sbt-native-packager talk

83 Joe JVM Platform