Class: Jets::Application
- Inherits:
-
Object
- Object
- Jets::Application
- Extended by:
- Memoist
- Includes:
- Middleware, Singleton
- Defined in:
- lib/jets/application.rb
Constant Summary collapse
- ENV_MAP =
Use the shorter name in stack names, but use the full name when it comes to checking for the env.
Example:
Jets.env: 'development' Jets.config.project_namespace: 'demo-dev'
{ development: 'dev', production: 'prod', staging: 'stag', }
Class Method Summary collapse
Instance Method Summary collapse
- #aws ⇒ Object
- #config ⇒ Object
- #configure(&block) ⇒ Object
-
#default_autoload_paths ⇒ Object
Essentially folders under app folder will be the default_autoload_paths.
- #default_config ⇒ Object
- #deprecated_configs_message ⇒ Object
- #eval_app_config ⇒ Object
- #exclude_autoload_path?(path) ⇒ Boolean
- #finish! ⇒ Object
- #internal_autoload_paths ⇒ Object
- #load_app_config ⇒ Object
- #load_configs ⇒ Object
- #load_db_config ⇒ Object
- #load_environments_config ⇒ Object
- #load_inflections ⇒ Object
- #load_routes ⇒ Object
-
#normalize_env_vars! ⇒ Object
It is pretty easy to attempt to set environment variables without the correct AWS Environment.Variables path struture.
-
#parse_project_name ⇒ Object
Double evaling config/application.rb causes subtle issues: * double loading of shared resources: Jets::Stack.subclasses will have the same class twice when config is called when declaring a function * forces us to rescue all exceptions, which is a big hammer.
-
#reload_configs! ⇒ Object
After the mimimal template gets build, we need to reload it for the full stack creation.
-
#routes ⇒ Object
Naming it routes because config/routes.rb requires.
- #set_dependent_configs! ⇒ Object
- #set_iam_policy ⇒ Object
- #setup! ⇒ Object
- #setup_auto_load_paths ⇒ Object
Methods included from Middleware
#build_stack, #call, #config_middleware, #default_stack, #endpoint, #middlewares
Class Method Details
.default_iam_policy ⇒ Object
221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 |
# File 'lib/jets/application.rb', line 221 def self.default_iam_policy project_namespace = Jets.project_namespace logs = { action: ["logs:*"], effect: "Allow", resource: "arn:aws:logs:#{Jets.aws.region}:#{Jets.aws.account}:log-group:/aws/lambda/#{project_namespace}-*", } s3_bucket = Jets.aws.s3_bucket s3_readonly = { action: ["s3:Get*", "s3:List*"], effect: "Allow", resource: "arn:aws:s3:::#{s3_bucket}*", } s3_bucket = { action: ["s3:ListAllMyBuckets", "s3:HeadBucket"], effect: "Allow", resource: "arn:aws:s3:::*", # scoped to all buckets } policies = [logs, s3_readonly, s3_bucket] if Jets::Stack.has_resources? cloudformation = { action: ["cloudformation:DescribeStacks"], effect: "Allow", resource: "arn:aws:cloudformation:#{Jets.aws.region}:#{Jets.aws.account}:stack/#{project_namespace}*", } policies << cloudformation end policies end |
Instance Method Details
#config ⇒ Object
28 29 30 |
# File 'lib/jets/application.rb', line 28 def config @config ||= ActiveSupport::OrderedOptions.new # dont use memoize since we reset @config later end |
#configure(&block) ⇒ Object
10 11 12 |
# File 'lib/jets/application.rb', line 10 def configure(&block) instance_eval(&block) if block end |
#default_autoload_paths ⇒ Object
Essentially folders under app folder will be the default_autoload_paths. Example:
app/controllers
app/helpers
app/jobs
app/models
app/rules
app/shared/resources
168 169 170 171 172 173 174 175 |
# File 'lib/jets/application.rb', line 168 def default_autoload_paths paths = [] Dir.glob("#{Jets.root}app/*").each do |p| p.sub!('./','') paths << p unless exclude_autoload_path?(p) end paths end |
#default_config ⇒ Object
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 |
# File 'lib/jets/application.rb', line 32 def default_config config = ActiveSupport::OrderedOptions.new config.project_name = parse_project_name # must set early because other configs requires this config.cors = true config.autoload_paths = default_autoload_paths config.extra_autoload_paths = [] # function properties defaults config.function = ActiveSupport::OrderedOptions.new config.function.timeout = 30 # default memory setting based on: # https://medium.com/epsagon/how-to-make-lambda-faster-memory-performance-benchmark-be6ebc41f0fc config.function.memory_size = 1536 config.prewarm = ActiveSupport::OrderedOptions.new config.prewarm.enable = true config.prewarm.rate = '30 minutes' config.prewarm.concurrency = 2 config.prewarm.public_ratio = 3 config.prewarm.rack_ratio = 5 config.gems = ActiveSupport::OrderedOptions.new config.gems.sources = [ Jets.default_gems_source ] config.inflections = ActiveSupport::OrderedOptions.new config.inflections.irregular = {} config.assets = ActiveSupport::OrderedOptions.new config.assets.folders = %w[assets images packs] config.assets.base_url = nil # IE: https://cloudfront.com/my/base/path config.assets.max_age = 3600 config.assets.cache_control = nil # IE: public, max-age=3600 , max_age is a shorter way to set cache_control. config.ruby = ActiveSupport::OrderedOptions.new config.middleware = Jets::Middleware::Configurator.new config.session = ActiveSupport::OrderedOptions.new config.session.store = Rack::Session::Cookie # note when accessing it use session[:store] since .store is an OrderedOptions method config.session. = {} config.api = ActiveSupport::OrderedOptions.new config.api. = "NONE" config.api.binary_media_types = ['multipart/form-data'] config.api.endpoint_type = 'EDGE' # PRIVATE, EDGE, REGIONAL config.domain = ActiveSupport::OrderedOptions.new # config.domain.name = "#{Jets.project_namespace}.coolapp.com" # Default is nil # config.domain.cert_arn = "..." config.domain.endpoint_type = "REGIONAL" # EDGE or REGIONAL. Default to EDGE because CloudFormation update is faster config.domain.route53 = true # controls whether or not to create the managed route53 record. # Useful to disable this when user wants to manage the route themself like pointing # it to CloudFront for blue-green deployments instead. config end |
#deprecated_configs_message ⇒ Object
143 144 145 146 147 148 149 150 151 152 |
# File 'lib/jets/application.rb', line 143 def unless config.ruby.lazy_load.nil? puts "Detected config.ruby.lazy_load = #{config.ruby.lazy_load.inspect}".colorize(:yellow) puts "Deprecated: config.ruby.lazy_load".colorize(:yellow) puts "Gems are now bundled with with Lambda Layer and there's no need to lazy load them." puts "Please remove the config in your config/application.rb or config/environments files." puts "You can have Jets automatically do this by running:" puts " jets upgrade" end end |
#eval_app_config ⇒ Object
116 117 118 119 |
# File 'lib/jets/application.rb', line 116 def eval_app_config app_config = "#{Jets.root}config/application.rb" load app_config # use load instead of require so reload_configs! works end |
#exclude_autoload_path?(path) ⇒ Boolean
177 178 179 |
# File 'lib/jets/application.rb', line 177 def exclude_autoload_path?(path) path =~ %r{app/javascript} || path =~ %r{app/views} end |
#finish! ⇒ Object
18 19 20 21 22 |
# File 'lib/jets/application.rb', line 18 def finish! load_inflections setup_auto_load_paths load_routes end |
#internal_autoload_paths ⇒ Object
181 182 183 184 185 186 187 188 189 |
# File 'lib/jets/application.rb', line 181 def internal_autoload_paths internal = File.("../internal", __FILE__) paths = %w[ app/controllers app/models app/jobs ] paths.map { |path| "#{internal}/#{path}" } end |
#load_app_config ⇒ Object
106 107 108 109 110 111 112 113 114 |
# File 'lib/jets/application.rb', line 106 def load_app_config @config = default_config set_dependent_configs! # things like project_namespace that need project_name eval_app_config # this overwrites Jets.config.project_name Jets.config.project_name = parse_project_name # Must set again because JETS_PROJECT_NAME is possible set_iam_policy # relies on dependent values, must be called afterwards normalize_env_vars! end |
#load_configs ⇒ Object
136 137 138 139 140 141 |
# File 'lib/jets/application.rb', line 136 def load_configs load_app_config load_db_config load_environments_config end |
#load_db_config ⇒ Object
264 265 266 267 268 269 270 271 272 273 274 |
# File 'lib/jets/application.rb', line 264 def load_db_config config.database = {} Jets::Dotenv.load! database_yml = "#{Jets.root}config/database.yml" if File.exist?(database_yml) text = Jets::Erb.result(database_yml) db_config = YAML.load(text) config.database = db_config end end |
#load_environments_config ⇒ Object
128 129 130 131 132 133 134 |
# File 'lib/jets/application.rb', line 128 def load_environments_config env_file = "#{Jets.root}config/environments/#{Jets.env}.rb" if File.exist?(env_file) code = IO.read(env_file) instance_eval(code) end end |
#load_inflections ⇒ Object
24 25 26 |
# File 'lib/jets/application.rb', line 24 def load_inflections Jets::Inflections.load! end |
#load_routes ⇒ Object
285 286 287 288 |
# File 'lib/jets/application.rb', line 285 def load_routes routes_file = "#{Jets.root}config/routes.rb" require routes_file if File.exist?(routes_file) end |
#normalize_env_vars! ⇒ Object
It is pretty easy to attempt to set environment variables without the correct AWS Environment.Variables path struture. Auto-fix it for convenience.
255 256 257 258 259 260 261 262 |
# File 'lib/jets/application.rb', line 255 def normalize_env_vars! environment = config.function.environment if environment and !environment.to_h.key?(:variables) config.function.environment = { variables: environment.to_h } end end |
#parse_project_name ⇒ Object
Double evaling config/application.rb causes subtle issues:
* double loading of shared resources: Jets::Stack.subclasses will have the same
class twice when config is called when declaring a function
* forces us to rescue all exceptions, which is a big hammer
Lets parse for the project name instead for now.
98 99 100 101 102 103 104 |
# File 'lib/jets/application.rb', line 98 def parse_project_name return ENV['JETS_PROJECT_NAME'] if ENV['JETS_PROJECT_NAME'] # override lines = IO.readlines("#{Jets.root}config/application.rb") project_name_line = lines.find { |l| l =~ /config\.project_name.*=/ } project_name_line.gsub(/.*=/,'').strip.gsub(/["']/,'') # project_name end |
#reload_configs! ⇒ Object
After the mimimal template gets build, we need to reload it for the full stack creation. This allows us to reference IAM policies configs that depend on the creation of the s3 bucket.
124 125 126 |
# File 'lib/jets/application.rb', line 124 def reload_configs! load_configs end |
#routes ⇒ Object
Naming it routes because config/routes.rb requires
Jets.application.routes.draw do
for scaffolding to work.
281 282 283 |
# File 'lib/jets/application.rb', line 281 def routes @router ||= Jets::Router.new end |
#set_dependent_configs! ⇒ Object
203 204 205 206 207 208 209 210 211 212 213 214 |
# File 'lib/jets/application.rb', line 203 def set_dependent_configs! # env_extra can be also be set with JETS_ENV_EXTRA. # JETS_ENV_EXTRA higher precedence than config.env_extra config.env_extra = ENV['JETS_ENV_EXTRA'] if ENV['JETS_ENV_EXTRA'] # IE: With env_extra: project-dev-1 # Without env_extra: project-dev config.short_env = ENV_MAP[Jets.env.to_sym] || Jets.env # table_namespace does not have the env_extra, more common case desired. config.table_namespace = [config.project_name, config.short_env].compact.join('-') config.project_namespace = Jets.project_namespace end |
#set_iam_policy ⇒ Object
216 217 218 219 |
# File 'lib/jets/application.rb', line 216 def set_iam_policy config.iam_policy ||= self.class.default_iam_policy config.managed_policy_definitions ||= [] # default empty end |
#setup! ⇒ Object
14 15 16 |
# File 'lib/jets/application.rb', line 14 def setup! load_configs end |
#setup_auto_load_paths ⇒ Object
154 155 156 157 158 159 |
# File 'lib/jets/application.rb', line 154 def setup_auto_load_paths autoload_paths = config.autoload_paths + config.extra_autoload_paths # internal_autoload_paths are last autoload_paths += internal_autoload_paths ActiveSupport::Dependencies.autoload_paths += autoload_paths end |