diff --git a/www/_blog/2022-03-31-supabase-edge-functions.mdx b/www/_blog/2022-03-31-supabase-edge-functions.mdx index f252c25a14a..786727bd80c 100644 --- a/www/_blog/2022-03-31-supabase-edge-functions.mdx +++ b/www/_blog/2022-03-31-supabase-edge-functions.mdx @@ -1,6 +1,6 @@ --- title: 'Edge Functions are now available in Supabase' -description: 'Today we’re launching Edge Functions. Edge Functions let you execute Typescript code close to your users, no matter where they’re located.' +description: 'Today we're launching Edge Functions. Edge Functions let you execute Typescript code close to your users, no matter where they're located.' author: inian,paul_copplestone image: launch-week-4/thursday-functions/functions-thumb.png thumb: launch-week-4/thursday-functions/functions-thumb.png @@ -11,9 +11,9 @@ date: '2022-03-31' toc_depth: 3 --- -Today we’re launching one of our [most](https://twitter.com/lau_cazanove/status/1506530181946691592) [requested](https://twitter.com/edgarasben/status/1506653203458363393) and [highly-](https://twitter.com/runjep/status/1507462077216088069)[anticipated](https://twitter.com/marcopolotwo/status/1506431782362632195) [features](https://github.com/supabase/supabase/discussions/4269) — Edge Functions. Edge Functions let you execute Typescript code close to your users, no matter where they’re located. +Today we're launching one of our [most](https://twitter.com/lau_cazanove/status/1506530181946691592) [requested](https://twitter.com/edgarasben/status/1506653203458363393) and [highly-](https://twitter.com/runjep/status/1507462077216088069)[anticipated](https://twitter.com/marcopolotwo/status/1506431782362632195) [features](https://github.com/supabase/supabase/discussions/4269) — Edge Functions. Edge Functions let you execute Typescript code close to your users, no matter where they're located. -Edge Functions are executed on the secure-by-default [Deno runtime](https://deno.land/), and deployed around the world in seconds using Deno’s [hosted Deno Deploy offering](https://deno.com/deploy). However, as a user of Supabase Edge Functions, you don’t need to know or worry about any of that; we handle all the gnarly details, delivering a seamless experience that allows you to focus on your business logic. +Edge Functions are executed on the secure-by-default [Deno runtime](https://deno.land/), and deployed around the world in seconds using Deno's [hosted Deno Deploy offering](https://deno.com/deploy). However, as a user of Supabase Edge Functions, you don't need to know or worry about any of that; we handle all the gnarly details, delivering a seamless experience that allows you to focus on your business logic. ## Choosing a platform @@ -24,7 +24,7 @@ Serverless compute options can be broken down into two broad categories: Additionally, there are self-hosted offerings within each category as well (e.g. Firecracker sort-of for the former, OpenFaaS for the latter). -Our first critical decision was to choose Functions as a Service (”FaaS”) over Containers and other alternatives. While Containers can allow for more flexible workloads, authoring and maintaining Functions allows for a substantially simpler developer experience-something Supabase has always focused on. As a Supabase user, all you need to think about is the business logic you wanted to write a Function for in the first place; you don’t need to think about optimizing docker image builds, updating your system dependencies, etc. +Our first critical decision was to choose Functions as a Service (”FaaS”) over Containers and other alternatives. While Containers can allow for more flexible workloads, authoring and maintaining Functions allows for a substantially simpler developer experience-something Supabase has always focused on. As a Supabase user, all you need to think about is the business logic you wanted to write a Function for in the first place; you don't need to think about optimizing docker image builds, updating your system dependencies, etc. Additionally, while a lot of work has been invested in improving container start-up times, Functions generally still enjoy significantly faster start-ups. @@ -36,13 +36,13 @@ However, Supabase already offers a flexible solution for that - [Database Functi ## The Deno runtime -Deno is a modern Typescript and JavaScript runtime created with first-class support for web technologies. Here some of the reasons why we’re excited about Deno: +Deno is a modern Typescript and JavaScript runtime created with first-class support for web technologies. Here some of the reasons why we're excited about Deno: ### Open-source -_Deno Deploy_ is Deno’s hosted service and, although it is proprietary, the Deno CLI is open source. This means that the open source offering from Deno maintains feature-parity with the proprietary service. If you use Deno to develop functions locally, its behavior will be the same as when deployed on the edge, unlocking an incredible developer experience. We couldn’t achieve a similarly seamless experience with e.g. AWS Lambda, no matter how much we tried. +_Deno Deploy_ is Deno's hosted service and, although it is proprietary, the Deno CLI is open source. This means that the open source offering from Deno maintains feature-parity with the proprietary service. If you use Deno to develop functions locally, its behavior will be the same as when deployed on the edge, unlocking an incredible developer experience. We couldn't achieve a similarly seamless experience with e.g. AWS Lambda, no matter how much we tried. -Deno even goes a step further than maintaining feature-parity, releasing all new APIs to open-source **first** before rolling them out to their hosted offering. This ensures that you can always develop and test bleeding-edge functionality locally, with all the tools you’re used to and familiar with, before deploying to a hosted cloud environment. +Deno even goes a step further than maintaining feature-parity, releasing all new APIs to open-source **first** before rolling them out to their hosted offering. This ensures that you can always develop and test bleeding-edge functionality locally, with all the tools you're used to and familiar with, before deploying to a hosted cloud environment. ### Batteries included @@ -56,27 +56,27 @@ Like modern web browsers, the Deno runtime executes your code in a secure sandbo When a request comes in to an Edge Function you deploy on Supabase, it first lands at a “Relay”. The [Relay](https://github.com/supabase/functions-relay) acts as an API gateway, authenticating the JWT, and providing some additional functionality like logging and rate-limiting. Upon receiving the incoming request, the Relay retrieves the metadata for your Function, and uses it to construct a unique identifier (”Deployment ID”) for the Function. This Deployment ID then gets passed over to the Deno Deploy platform, which takes care of invoking your Function securely, and passing your output back to the Relay, which in turn passes it back to your end-user. -If a user’s request comes in for your Function before it has been cached by the Deno Deploy platform (a ”cold start”), it reaches out to Supabase to retrieve your Functions code, and any associated permissions and secrets. Even though this might sound like a lot of work, we’ve worked to ensure that these cold starts are still pretty spiffy. +If a user's request comes in for your Function before it has been cached by the Deno Deploy platform (a ”cold start”), it reaches out to Supabase to retrieve your Functions code, and any associated permissions and secrets. Even though this might sound like a lot of work, we've worked to ensure that these cold starts are still pretty spiffy. ![Functions architecture](/images/blog/launch-week-4/thursday-functions/functions-architecture.png) -The primary goal of this architecture is to reduce the amount of work done in the hot path (marked in purple above). Each component in the hot path is globally distributed so that Edge Functions start up and respond to your users’ requests fast. +The primary goal of this architecture is to reduce the amount of work done in the hot path (marked in purple above). Each component in the hot path is globally distributed so that Edge Functions start up and respond to your users' requests fast. ### Region: Earth 🌎 -Supabase Edge Functions are deployed to one region - Earth (and we’re exploring Mars as an additional region 👽). Edge Functions are deployed to over 30 data centers in a matter of seconds, ensuring fast response times no matter where your users are located. +Supabase Edge Functions are deployed to one region - Earth (and we're exploring Mars as an additional region 👽). Edge Functions are deployed to over 30 data centers in a matter of seconds, ensuring fast response times no matter where your users are located. [Database Functions](https://supabase.com/docs/guides/database/functions) (also served via our [REST and GraphQL APIs](https://supabase.com/docs/guides/api)) are colocated with your Postgres database, making them ideal for DB-intensive operations. These APIs can also be called seamlessly from your Supabase Edge Functions, making for a powerful combination. ### Scale to zero -Functions scale down to zero and you only pay for what you use. This makes them great for an extremely wide variety of workloads-whether you’re starting out with extremely sporadic usage, or bursty request patterns, or using them consistently and heavily. +Functions scale down to zero and you only pay for what you use. This makes them great for an extremely wide variety of workloads-whether you're starting out with extremely sporadic usage, or bursty request patterns, or using them consistently and heavily. ## A fun and efficient Developer Experience -Delivering a phenomenal Developer Experience is something we care about a lot at Supabase. In the serverless functions space, we’ve found that local development and testing, coupled with fast deploys are critical. +Delivering a phenomenal Developer Experience is something we care about a lot at Supabase. In the serverless functions space, we've found that local development and testing, coupled with fast deploys are critical. -We’ve [extended the Supabase CLI](https://supabase.com/docs/guides/local-development) to optimize the Edge Functions DX along these two dimensions. You get live-reloading, and a local Deno environment that matches the production environment, making for a great local iteration environment. +We've [extended the Supabase CLI](https://supabase.com/docs/guides/local-development) to optimize the Edge Functions DX along these two dimensions. You get live-reloading, and a local Deno environment that matches the production environment, making for a great local iteration environment. -Once you’ve tested your Function locally (or gone straight to production cos you live _on the edge_ ... get it?) it takes just seconds to deploy a new function and see the logs streaming in your Dashboard—ensuring a tight iteration loop with your production environment. +Once you've tested your Function locally (or gone straight to production cos you live _on the edge_ ... get it?) it takes just seconds to deploy a new function and see the logs streaming in your Dashboard—ensuring a tight iteration loop with your production environment.