{"id":33264476,"url":"https://github.com/kiwi-josh/ember-cli-deploy-fastboot-api-lambda","last_synced_at":"2025-11-17T05:01:00.880Z","repository":{"id":57223196,"uuid":"80493756","full_name":"kiwi-josh/ember-cli-deploy-fastboot-api-lambda","owner":"kiwi-josh","description":"An ambitious ember-cli-deploy plugin for serving Ember FastBoot Applications entirely from within AWS Lambda/API Gateway (assets and all!).","archived":false,"fork":false,"pushed_at":"2017-03-15T17:50:39.000Z","size":24,"stargazers_count":27,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-10T15:09:29.105Z","etag":null,"topics":["api-gateway","ember","ember-addon","ember-cli-deploy-plugin","lambda"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kiwi-josh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-31T05:18:57.000Z","updated_at":"2024-05-30T02:44:31.000Z","dependencies_parsed_at":"2022-08-24T16:20:53.716Z","dependency_job_id":null,"html_url":"https://github.com/kiwi-josh/ember-cli-deploy-fastboot-api-lambda","commit_stats":null,"previous_names":["wytlytningnz/ember-cli-deploy-fastboot-api-lambda"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/kiwi-josh/ember-cli-deploy-fastboot-api-lambda","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwi-josh%2Fember-cli-deploy-fastboot-api-lambda","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwi-josh%2Fember-cli-deploy-fastboot-api-lambda/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwi-josh%2Fember-cli-deploy-fastboot-api-lambda/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwi-josh%2Fember-cli-deploy-fastboot-api-lambda/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kiwi-josh","download_url":"https://codeload.github.com/kiwi-josh/ember-cli-deploy-fastboot-api-lambda/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwi-josh%2Fember-cli-deploy-fastboot-api-lambda/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284825032,"owners_count":27069170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-17T02:00:06.431Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-gateway","ember","ember-addon","ember-cli-deploy-plugin","lambda"],"created_at":"2025-11-17T05:00:51.729Z","updated_at":"2025-11-17T05:01:00.864Z","avatar_url":"https://github.com/kiwi-josh.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ember-cli-deploy-fastboot-api-lambda\n\n[![npm version](https://badge.fury.io/js/ember-cli-deploy-fastboot-api-lambda.svg)](https://badge.fury.io/js/ember-cli-deploy-fastboot-api-lambda)\n\nAn ambitious ember-cli-deploy plugin for serving Ember FastBoot Applications entirely from within AWS Lambda/API Gateway (assets and all!).\n\n\n## Background\nAPI Gateway [now supports the handling binary payloads](https://aws.amazon.com/about-aws/whats-new/2016/11/binary-data-now-supported-by-api-gateway/), which means an end-to-end fastboot hosting solution can now be achieved through API gateway and Lambda without the use of S3 for serving static files. This is what this addon aims to achieve.\n\n## Prerequisites \n- You have [ember-fastboot](https://ember-fastboot.com) installed and configured within your Ember app.\n- You have an [AWS account](https://aws.amazon.com/free) setup.\n- You have the [AWS CLI](https://aws.amazon.com/cli) installed and configured.\n\n## Installation\n\n* Install the ember-cli-deploy addons\n```\nember install ember-cli-deploy\nember install ember-cli-deploy-build\nember install ember-cli-deploy-fastboot-api-lambda\n```\n\n## Configuration\n\n* Configure the deployment variables\n```\n// config/deploy.js\nENV['fastboot-api-lambda'] = {\n  accessKeyId: process.env.AWS_ACCESS_KEY_ID,         // (Required) AWS accessKeyId (must have permission to deploy lambda functions)\n  secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY, // (Required) AWS secretAccessKey\n  lambdaFunction: 'my-ember-app',                     // (Required) Lambda functions name\n  region: 'us-east-1',                                // (Required) Region where lambda is deployed\n\n  fallbackPath: '/'                                   // (optional) The route that will be attempted if the current route fails. i.e. doesn't exist, fails etc.\n  stringyExtensions: [                                // (optional) The file extensions that will be treated as text and not binary. Defaults are shown. Any additional items will be concatenated to this list.\n    'html',\n    'css',\n    'js',\n    'json',\n    'xml',\n    'ico',\n    'txt',\n    'map'\n  ],\n  validAssetPaths: [                                  // (optional) The assets paths that the lambda is explicitly allow serve. Defaults are shown. Any additional items will be concatenated to this list.\n    '/assets/',\n    '/robots.txt',\n    '/humans.txt',\n    '/crossdomain.xml',\n    '/sitemap.xml'\n  ]\n};\n```\n\n* Create the lambda function\n    \n  * Open the [AWS Lambda console](https://console.aws.amazon.com/lambda). \n  * Select the region that you defined in your deploy variables above.\n  * Create a blank lambda, with the name you defined in your deploy variables above.\n    * Handler =\u003e `index.handler`.\n    * Role =\u003e `Create a custom role`. Give it a name and use the default policy document.\n    * Memory =\u003e `128`.\n    * Timeout =\u003e `30 seconds`.\n  * Select `Next` and then select `Create function`. \n\n* Create the API Gateway Proxy\n  \n  * Open the [AWS API Gateway console](https://console.aws.amazon.com/apigateway). \n  * Select the region that you defined in your deploy variables above.\n  * Select `New API` and give it a name\n  * Select Binary Support. Click `Edit`. Add `*/*` and click `Save`.\n  * Create proxy method:\n    * Under resources, click `/`, then click `Actions =\u003e Create Method`. Select `Any`.\n    * Click the `Any label`, choose Integration type `lambda`, check the `Use Lambda Proxy integration` checkbox, and finally select your lambda function's region and name.\n  * Create proxy resource:\n    * Under resources, click `/`, then click `Actions =\u003e Create Resource`. Select `Any`.\n    * Select `Configure as proxy resource`, and select `Enable API Gateway CORS`.\n    * Select Integration type `Lambda Function Proxy`, and finally select your lambda function's region and name.\n  * Under resources, click `Actions =\u003e Deploy API`. Select a new stage and give it the name `fastboot`. Hit `Deploy`. You will now see the `Invoke URL`. This is where you site will be hosted.\n\n* Ember Application\n  * The `rootURL` must match the stage name you selected when creating the api gateway. Otherwise the `link-to` helper wont work.\n  ```\n  // config/environment.js\n  var ENV = {\n    rootURL: '/fastboot/'\n  }\n  ```\n\n* Configuration is done! 🎉\n\n## Deployment\n\nIs as simple as going:\n\n`ember deploy production --activate --verbose=true`\n\n\n## Caveats\n\nJust a word of warning.. just because this architecture is possible, doesn't make it the optimal for all use-cases.\nLambda functions suffer from a cold start delay, which can make response times unpredictable.\n\n\n## Sites using this addon\n\n* [nzsupps.co.nz](https://nzsupps.co.nz)\n\n*Feel free to make a pull request if you would like your site added to the list!*\n\n\n\n## Credit\n[ember-cli-deploy-fastboot-lambda](https://github.com/bustlelabs/ember-cli-deploy-fastboot-lambda) for providing the base upload logic.\n\n## Information\nFor more information on using ember-cli, visit [http://www.ember-cli.com/](http://www.ember-cli.com/).\n\nFor more information on using ember-cli-deploy, visit [https://github.com/ember-cli-deploy/ember-cli-deploy](https://github.com/ember-cli-deploy/ember-cli-deploy).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiwi-josh%2Fember-cli-deploy-fastboot-api-lambda","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkiwi-josh%2Fember-cli-deploy-fastboot-api-lambda","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiwi-josh%2Fember-cli-deploy-fastboot-api-lambda/lists"}