fink Documentation Release 1.0.2 fink Dec 04, 2017 Contents 1 Introduction 1 1.1 Related documents............................................1 1.2 Problem reporting instructions......................................1 2 Getting Started Guide 3 2.1 Infrastructure as code..........................................3 2.2 Installation................................................4 2.3 fink.cloud.................................................6 2.4 fink.lambda................................................7 2.5 fink.code.................................................7 2.6 fink.api..................................................8 3 Overview 9 4 Installing fink 11 4.1 Related documents............................................ 11 4.2 What you need to know about python package management...................... 11 4.3 fink package structure.......................................... 12 4.4 Maintaining dependencies for your project............................... 12 4.5 Defining which fink plugins to use.................................... 13 4.6 Setup virtualenv............................................. 13 4.7 Installing all dev dependencies in one go................................ 13 4.8 Deactivate a virtualenv.......................................... 14 4.9 Updating fink............................................... 14 5 fink tool 17 5.1 Related documents............................................ 17 5.2 Usage................................................... 17 5.3 Commands................................................ 17 6 cloud command 19 6.1 Related documents............................................ 19 6.2 Usage................................................... 19 6.3 Commands................................................ 19 6.4 Folder Layout.............................................. 21 6.5 Howto.................................................. 22 6.6 Kumo lifecycle hooks.......................................... 22 i 6.7 DEPRECATED Kumo legacy hooks................................... 23 6.8 Using fink functionality in your cloudformation templates....................... 24 6.9 Accessing context and config in cloudformation............................ 24 6.10 Stack Policies............................................... 24 6.11 Signal handling.............................................. 25 7 cloud config 1.0.3 27 7.1 Description................................................ 27 7.2 Data Structures.............................................. 27 8 cloud particles 29 8.1 Related documents............................................ 29 8.2 Goals................................................... 29 8.3 Detailed requirements.......................................... 29 8.4 Status on cloud particles implementation................................ 30 8.5 Usage................................................... 30 8.6 Sample particles............................................. 30 8.7 Quickstart example using particles.................................... 30 8.8 Developing your own particles...................................... 31 9 code command 33 9.1 Related documents............................................ 33 9.2 Usage................................................... 33 9.3 Folder Layout.............................................. 33 9.4 code configuration............................................ 34 9.5 Signal handling.............................................. 35 10 fink.code configuration 1.0.1 37 10.1 Description................................................ 37 10.2 Data Structures.............................................. 37 11 lambda command 39 11.1 Related documents............................................ 39 11.2 Usage................................................... 39 11.3 Folder Layout.............................................. 42 11.4 Sample config file............................................ 42 11.5 lambda configuration as part of the fink_<env>.json file........................ 44 11.6 Deploying AWS Lambda@Edge..................................... 46 11.7 Setting the ENV variable......................................... 47 11.8 Environment specific configuration for your lambda functions..................... 47 11.9 Defining dependencies for your NodeJs lambda function........................ 47 11.10 Sample NodeJs lambda function..................................... 47 12 api command 49 12.1 Related documents............................................ 49 12.2 Usage................................................... 49 12.3 Folder Layout.............................................. 50 13 api tool config 1.0.1 53 13.1 Description................................................ 53 13.2 Data Structures.............................................. 53 14 Plugins for fink 57 14.1 Introduction............................................... 57 14.2 Overview................................................. 57 ii 14.3 fink plugin mechanism.......................................... 59 14.4 Overview on configuration........................................ 61 14.5 fink.config-reader plugin......................................... 63 14.6 fink.lookups plugin............................................ 65 14.7 fink.lookups plugin config 1.0.4..................................... 66 14.8 fink.bundler plugin............................................ 67 14.9 fink.say-hello plugin........................................... 67 14.10 fink.slack-integration plugin....................................... 68 14.11 fink-slack-integration plugin config 1.0.2................................ 70 15 Frequently Asked Questions (faq) 71 15.1 Homebrew Python............................................ 71 15.2 Python package errors.......................................... 71 15.3 Bundling error.............................................. 71 15.4 Missing configuration error....................................... 72 15.5 Environment variable error........................................ 72 15.6 Using hooks in fink............................................ 72 16 Changelog 75 16.1 [0.1.436] - 2017-08-17.......................................... 75 16.2 [0.1.435] - 2017-08-17.......................................... 75 16.3 [0.1.433] - 2017-08-14.......................................... 75 16.4 [0.1.432] - 2017-08-10.......................................... 76 16.5 [0.1.431] - 2017-08-10.......................................... 76 16.6 [0.1.430] - 2017-08-08.......................................... 76 16.7 [0.1.429] - 2017-08-07.......................................... 76 16.8 [0.1.428] - 2017-08-03.......................................... 76 16.9 [0.1.427] - 2017-08-01.......................................... 76 16.10 [0.1.426] - 2017-08-01.......................................... 77 16.11 [0.1.425] - 2017-08-01.......................................... 77 16.12 [0.1.424] - 2017-08-01.......................................... 77 16.13 [0.1.423] - 2017-07-21.......................................... 77 16.14 [0.1.422] - 2017-07-18.......................................... 77 16.15 [0.1.421] - 2017-07-18.......................................... 77 16.16 [0.1.420] - 2017-07-18.......................................... 78 16.17 [0.1.419] - 2017-07-17.......................................... 78 16.18 [0.1.418] - 2017-07-17.......................................... 78 16.19 [0.1.417] - 2017-07-13.......................................... 78 16.20 [0.1.415] - 2017-07-12.......................................... 78 16.21 [0.1.413] - 2017-07-07.......................................... 78 16.22 [0.1.412] - 2017-07-05.......................................... 79 16.23 [0.1.411] - 2017-07-04.......................................... 79 16.24 [0.1.410] - 2017-07-03.......................................... 79 16.25 [0.1.409] - 2017-07-03.......................................... 79 16.26 [0.1.408] - 2017-06-30.......................................... 79 16.27 [0.1.407] - 2017-06-30.......................................... 79 16.28 [0.1.406] - 2017-06-30.......................................... 79 16.29 [0.1.405] - 2017-06-30.......................................... 80 16.30 [0.1.404] - 2017-06-29.......................................... 80 16.31 [0.1.403] - 2017-06-22.......................................... 80 16.32 [0.1.402] - 2017-06-21.......................................... 80 16.33 [0.1.401] - 2017-06-20.......................................... 80 16.34 [0.1.400] - 2017-06-20.......................................... 80 16.35 [0.1.399] - 2017-06-19.......................................... 80 iii 16.36 [0.1.398] - 2017-06-16.......................................... 81 16.37 [0.1.397] - 2017-06-16.......................................... 81 16.38 [0.1.396] - 2017-06-12.......................................... 81 16.39 [0.1.394] - 2017-06-09.......................................... 81 16.40 [0.1.393] - 2017-06-09.......................................... 81 16.41 [0.1.392] - 2017-06-07.......................................... 81 16.42 [0.1.391] - 2017-06-02.......................................... 82 16.43 [0.1.390] - 2017-05-31.......................................... 82 16.44 [0.1.8] - 2017-04-27........................................... 82 16.45 [0.1.7] - 2017-04-27........................................... 82 16.46 [0.1.6] - 2017-04-26........................................... 82 16.47 [0.1.5] - 2017-04-26........................................... 82 16.48 [0.1.4] - 2017-04-07..........................................