Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 3c28c40

Browse files
authoredApr 8, 2019
tweak warning to make less scary
1 parent cfb47dc commit 3c28c40

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed
 

‎README.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,23 @@ This is an optional tool that helps with building or locally developing [Netlify
44

55
The goal is to make it easy to write Lambda's with transpiled JS/TypeScript features and imported modules.
66

7-
## New Alternative to Netlify Lambda
7+
<details>
8+
<summary><b>Multiple ways to deploy functions on Netlify</b></summary>
9+
10+
There are 3 ways to deploy functions to Netlify:
11+
12+
1. each function as a single JS or Go file, possibly bundled by a build tool like `netlify-lambda` or `tsc`
13+
2. each function as a zip of a folder of files
14+
3. as of [CLI v2.7](https://www.netlify.com/docs/cli/#unbundled-javascript-function-deploys), a non-bundled, non-zipped, folder of files.
815

9-
Netlify-Lambda uses webpack to bundle up your functions and their dependencies for you, however this is not the only approach. If you have native node modules (or other dependencies that don't expect to be bundled like [the Firebase SDK](https://github.com/netlify/netlify-lambda/issues/112)) then you may want to try the zipping approach.
16+
`Netlify-Lambda` uses webpack to bundle up your functions and their dependencies for you, suiting the first approach. However, if you have native node modules (or other dependencies that don't expect to be bundled like [the Firebase SDK](https://github.com/netlify/netlify-lambda/issues/112)) then you may want to try the other approaches.
1017

11-
We have recently integrated this functionality ([zip-it-and-ship-it](https://github.com/netlify/zip-it-and-ship-it)) into the Netlify CLI. Check the [documentation here](https://www.netlify.com/docs/cli/#unbundled-javascript-function-deploys) in the official CLI docs and support is available through [our regular channels](https://www.netlify.com/support/). The current drawback of this approach is no ability to serve these zipped functions locally, although we are working on this. An update on this will come [in April](https://jamstackconf.com/nyc/).
18+
If this sounds confusing, support is available through [our regular channels](https://www.netlify.com/support/). An update on how this will be supported locally will come [in April](https://jamstackconf.com/nyc/). Importantly, **There will be no change to the workflow of existing `netlify-lambda` users.**
19+
20+
</details>
1221

1322
<details>
14-
<summary><b>A bit information on manual zipping</b></summary>
23+
<summary><b>A bit of information on manual zipping</b></summary>
1524

1625
You can still zip up and deploy functions by yourself, as has always been the case with Netlify Functions. Read [here](https://www.netlify.com/blog/2018/09/14/forms-and-functions/) and [here for instructions](https://github.com/DavidWells/function-zips/) (more examples [here](https://github.com/netlify/function-bundling-example))
1726
</details>

0 commit comments

Comments
 (0)
Please sign in to comment.