A History of Hosting RedwoodJS - How the Universal Deployment Machine Was Built

We want to deploy to all the things. Write once, learn once, run everywhere.

Peter Pistorius - Deployment Targets tracking issue (August 8, 2020)

Phase 0 - Netlify

RedwoodJS was originally architected to run as a static frontend deployed on a CDN that sends requests to a serverless GraphQL handler. The GraphQL handler was first deployed on AWS Lambda via Netlify Functions. Despite all the jargon in the previous description, you can forget about most of those terms with the notable exceptions of frontend and GraphQL.

You can think about your Redwood application as consisting of a React frontend speaking to a Node backend that exposes a GraphQL API. For the initial v0.1 release of Redwood, the React frontend was hosted on Netlifyā€™s CDN and the GraphQL API was hosted on a serverless Lambda handler via Netlify Functions.

However, thereā€™s no inherent reason a Redwood app has to be deployed this way. This led many to wonder and others to experiment with different methods of deploying the frontend and API.

What does it take to deploy the redwood api part to AWS Lambda directly? I would like to take a shot at it.

Jaikant - Deploying to AWS Lambda (April 6, 2020)

We currently rely on Netlify to do the heavy lifting of deployment for us, but we intend to make it easy to write deployment providers that will allow deployment to a wide variety of services.

Tom Preston-Werner - Deploying to AWS Lambda (April 8, 2020)

Phase 1 - AWS Lambda cause I donā€™t want a server

The first adventurer sought to bypass Netlify Functions and deploy the API directly to AWS Lambda.

So I got the api part deployed and working on AWS lambda directly using serverless. I had to move some files around in the dist directory and also set the environment variables in AWS. I shall create an issue to discuss the changes.

Jaikant - Deploying to AWS Lambda (April 13, 2020)

Serverless Framework

On deploying to AWS lambda, we would get an api endpoint. This api endpoint would be needed within the web part in apollo client for the graphql queries.

The build step would need the api to be built first, before the web, so the endpoint is known. Using serverless to deploy, the config serverless.yml, which is at the root of the project.

Jaikant - Support Deployments to AWS Lambda (April 14, 2020)

service: jai-redwood-1
plugins:
  - serverless-dotenv-plugin

provider:
  name: aws
  runtime: nodejs12.x
  region: ap-south-1

package:
  artifact: zipball/graphql.zip

functions:
  graphql:
    description: redwood on aws lambda
    memorySize: 1024
    timeout: 30
    handler: dist/functions/graphql.handler
    events:
      - http:
          path: graphql
          method: GET
          cors: true
      - http:
          path: graphql
          method: POST
          cors: true
      - http:
          path: playground
          method: ANY
          cors: true

I tried this with the latest version of zip-it-and-ship-it for AWS Lambda and it seems to have worked out of the box. I did not have to make any changes to the zip folder and I used handler: graphql.handler in serverless.yml.

I changed the one line in serverless.yml from handler: dist/functions/graphql.handler to handler: graphql.handler since graphql.js now lives in the root of the zipball.

Hemil Desai - Support Deployments to AWS Lambda (August 8, 2020)

yarn rw setup deploy aws-serverless

Iā€™ve just chatted with @hemildesai and weā€™ve come up with some concrete steps for adding AWS deployments using the serverless framework.

Introduce a deploy command:

  • yarn rw deploy api aws-serverless
  • runs yarn build api, built files are in ./api/dist
  • runs zip it and ship it, placing the files in ./api/dist/
  • runs serverless deploy

Peter Pistorius - Support Deployments to AWS Lambda (August 19, 2020)

yarn rw setup deploy aws-serverless
service: app

plugins:
  - serverless-dotenv-plugin

provider:
  name: aws
  runtime: nodejs12.x
  region: us-east-2
  httpApi:
    cors: true
    payload: '1.0'
  stackTags:
    source: serverless
    name: Redwood Lambda API with HTTP API Gateway
  tags:
    name: Redwood Lambda API with HTTP API Gateway

package:
  individually: true

functions:
  graphql:
    description: graphql function deployed on AWS Lambda
    package:
      artifact: api/dist/zipball/graphql.zip
    memorySize: 1024
    timeout: 25
    tags:
      endpoint: /.redwood/functions/graphql
    handler: graphql.handler
    events:
      - httpApi:
          path: /.redwood/functions/graphql
          method: GET
      - httpApi:
          path: /.redwood/functions/graphql
          method: POST

Phase 2 - PM2 cause I want a server

Do you prefer hosting Redwood on your own server, the traditional serverful way, instead of all this serverless magic? Well, you can! In this recipe we configure a Redwood app with PM2 and Nginx on a Linux server.

Nick Geerts - Add serverfull hosting recipe to cookbook (October 24, 2020)

With the deploy aws-serverless command, developers now had the ability to drop down to the underlying AWS Lambdas and were no longer reliant on Netlify Functions. This may have looked like it was presaging a stronger push towards a wider array of serverless function providers.

But the exact opposite happened, the next investigation involved leaving the serverless world behind entirely. Despite their appeal from a DX perspective, larger Redwood applications hosted on AWS Lambda experienced noticeable cold starts or exceeded the maximum allotted memory for their handler.

And for some developers running a server is not challenging or foreign, it is familiar and simple.

Iā€™m a freelancer and have a lot of smaller clients and host my own Linux server with node.js instances in PM2 with a reverse proxy in Nginx. I was looking into deploying an example Redwood app to my own Linux server. When I build the project, the web/dist output is simple enough - just files to host in Nginx (yay JAMstack!).

However, how can I host the function artifacts in api/dist? Do these conform to a spec like the serverless framework and how can I deploy them to PM2? Or do I need to use something like OpenFAAS or the Fn Project?

Nick Geerts - Serverfull hosting (September 13, 2020)

pm2.config.js

I have a working example! :sunglasses:

Live site: http://redwood-pm2.nickgeerts.com
Repo: GitHub - njjkgeerts/redwood-pm2: Redwood.js serverfull hosting with PM2

Nick Geerts - Serverfull hosting (September 26, 2020)

const name = 'redwood-pm2'
const repo = 'git@github.com:njjkgeerts/redwood-pm2.git'
const user = 'deploy'
const path = `/home/${user}/${name}`
const host = 'example.com'
const port = 8911
const build = `yarn install && yarn rw build && yarn rw prisma deploy`

module.exports = {
  apps: [
    {
      name,
      node_args: '-r dotenv/config',
      cwd: `${path}/current/`,
      script: 'yarn rw serve api',
      args: '--port ${port}',
      env: {
        NODE_ENV: 'development',
      },
      env_production: {
        NODE_ENV: 'production',
      },
    },
  ],

  deploy: {
    production: {
      user,
      host,
      ref: 'origin/master',
      repo,
      path,
      ssh_options: 'ForwardAgent=yes',
      'post-deploy': `${build} && pm2 reload pm2.config.js --env production && pm2 save`,
    },
  },
}

Server-less or Server-more?

ā€œServerfullā€ makes sense in the context of Serverless, but to the best of my knowledge, itā€™s not a well-known term (yet). So when people are browsing the left column navigation docs, or using the site search, is there anything we can add to help others find this document and identify immediately with the topic. Some ideas:

  • Server hosting
  • Traditional or classic server architecture
  • Self-hosting Redwood
  • Hosting Redwood without serverless or docker containers

David Price - Add serverfull hosting recipe to cookbook - (October 26, 2020)

Phase 3 - Render cause I want only one dashboard

render.com looks the same like netlify to me but comes with a way of having postgresql database, is that not a better choice in the tutorial section as deployment target?

Guled - Using render.com instead of Netlify and Heroku (June 10, 2020)

As more Redwood apps have been deployed to production, weā€™ve seen developers place a great emphasis on having their:

  • Redwood API running on a server
  • Build process and infrastructure provisioning defined in code
  • Frontend, API, and database all hosted on the same provider

api-server

RedwoodJS is architected as monorepo with two separate sides, an ā€œapi sideā€ and a ā€œweb side.ā€ The api side is a NodeJS application and the web side is a static SPA (single page app).

This works out great when hosting on Render because hosting a static site is free, and static content is served via super-fast CDN. So weā€™re going to setup two sides on Render.com, but first you need to add some things to your RedwoodJS project.

Install the api-server in your api side.

cd api
yarn add @redwoodjs/api-server

Create a ā€œhealthā€ function used by Render to check if your api side is running correctly.

// api/src/functions/healthz.js

export const handler = async () => {
   return {
       statusCode: 200
   }
}

On Render, create a new ā€œweb serviceā€:

  • Connect to your repository
  • Environment is Node
  • Build: yarn && yarn rw prisma migrate deploy && yarn rw build api
  • Start: cd api && yarn rw-api-server --port 80
  • Use custom domain: ā€œapi.raccoon.tradeā€

On Render create a new ā€œstatic siteā€:

  • Build: yarn && yarn rw build web
  • Publish: ./web/dist
  • Add rewrite and redirect rules

Peter Pistorius - Using render.com instead of Netlify and Heroku (March 15, 2021)

yarn rw setup deploy render

Perfect. Weā€™ll set up a render.yaml and make this easier. Stay tuned!

Anurag Goel - Using render.com instead of Netlify and Heroku (March 15, 2021)

The PR adds a command to the Redwood CLI to automatically configure project for deployment to Render.

Sean Doughty - Adding Setup Deploy Render Command (March 25, 2021)

yarn rw setup deploy render
services:
- name: history-hosting-test-web
  type: web
  env: static
  buildCommand: yarn rw deploy render web
  staticPublishPath: ./web/dist
  envVars:
  - key: NODE_VERSION
    value: 14
  routes:
  - type: rewrite
    source: /.redwood/functions/*
    destination: replace_with_api_url/*
  - type: rewrite
    source: /*
    destination: /index.html

- name: history-hosting-test-api
  type: web
  env: node
  region: oregon
  buildCommand: yarn && yarn rw build api
  startCommand: yarn rw deploy render api
  envVars:
  - key: NODE_VERSION
    value: 14
  - key: DATABASE_URL
    fromDatabase:
      name: history-hosting-test-db
      property: connectionString

databases:
  - name: history-hosting-test-db
    region: oregon

Phase 4 - Still in progress

Is this deployment machine truly universal? That depends of course on your definition of universality. If you want to universally deploy to AWS, youā€™re covered. However, other major cloud providers have proved more difficult.

Google Cloud Run

Adding setup and deploy functionality for firebase hosting for web, with Cloud Run for API.

Benjamin Coe - Adding support for GCP project generation (September 26, 2020)

Azure

Iā€™m not sure which direction this will take (The Serverless Framework vs maintaining deployment providers in Redwood) but here is some Azure specific on the topic.

Azures equivalent to AWSā€™s Lambda and S3 is Azure Functions and Azure Storage. If the deployment would utilize Git deployment to the fullest, would there be any need for a storage account/bucket?

Johan Eliasson - Support Deployments to AWS Lambda (July 7, 2020)

Azure Static Web Apps

Iā€™ve been tinkering Azure Static Web Apps, which would not only host the API side (via Azure Functions), but also the front-end. I donā€™t think function-only deployment would be too far off though.

Kim-Adeline Miguel - Deployment Targets tracking issue (September 7, 2020)

Azure Functions

I am working on hacking together a solution to run Redwood on Azure using Azure Functions.

My approach so far is to vendor the API package into a Redwood project: redwood-azure and replace the code that generates Lambdas with code that generates Azure Functions. I have started this process by unpacking and attempting to grok some of the API package in my own fork of this repo. The branch is called ā€œblueskyā€ because ā€œAzureā€ ha ha.

If I can get my hacked and vendored API package working in the Redwood solution, then I can approach the core maintainers with questions of architecture and implementation. AFAIK, there will have to be some flag to tell the API package whether it should compile to Azure Functions or Lambdas.

With the final implementation, I want to limit the variance between the Lambda producing code and the Functions producing code. This will require me to gain a better understanding of the API package.

Still early days.

Here is a link to the beginning of my vendored ā€œhack-apiā€.

Thomas Eckert - Deployment Targets tracking issue (April 6, 2021)

Cloudflare

Can I deploy the redwood app to the cloudflare page?

Muhammad Rusdi - Deploy Redwoodjs with Cloudflare Page (March 3, 2021)

Such a simple question with such a long and complicated answer.

A Cloudflare Worker is JavaScript you write that runs on Cloudflareā€™s edge. A Cloudflare Service Worker is specifically a worker which handles HTTP traffic and is written against the Service Worker API. Cloudflare Pages is a deployment platform for frontend developers modeled on Netlify and Vercel.

Sounds cool but remember that part about Redwood being a Node app?

Hi @muhrusdi. To the best of my knowledge, no one has tried to deploy Redwood on Cloudflare. Personally, I am a big fan of their products. However, their alternative to AWS Lambdas, which is Cloudflare Workers, is a V8 runtime, which is not the same as a Node.js runtime.

This means the Redwood API will most likely not run on Cloudflare Workers. In the case of a very simple app, it might be fine. But once you add things like Prisma Client itā€™s almost sure to fail.

If you wanted to run an experiment, you could try to deploy Redwoodā€™s Web side to Cloudflareā€™s CDN and the API site directly to AWS Lambdas using these instructions for a Redwood AWS deploy target.

David Price - Deploy Redwoodjs with Cloudflare Page (March 4, 2021)

Prisma is currently out of the question

The potential gotchas that keep me from trying:

  • Prisma binary hates v8 runtime
  • Some random dependency in @redwoodjs/api hates v8 runtime
  • Auth provider packages hate v8 runtime
  • Misc API package dependencies used by random Redwood Project X hate v8 runtime

In general, I foresee it being frustrating if my local dev environment spins up the API in a Node runtime so itā€™s not until I get to deployment that things break, which is then difficult to diagnose.

So Iā€™d suggest starting with local dev for experimentation ā†’ I have ZERO knowledge here:

  • Is it possible to spin up a local v8 runtime for dev?
  • Does babel/esbuild support it?

If we canā€™t do something like this, then Iā€™m not optimistic about creating a workable, um, workflow [Editorā€™s note: lol] regardless of being able to spin up a test app on Cloudflare using Workers.

Workers do NOT support Node.js.

I believe we can transpile code to the JavaScript version we need. But we canā€™t control the other dependencies (and their dependencies), which may or may not have Node.js specific requirements + dependencies.

Iā€™ll be cheering you on. But hereā€™s your first roadblock.

David Price - Running RedwoodJS on Cloudflare Workers (April 7, 2021)

WASM, it practically cures cancer!

You can specify a web worker output target. But youā€™re not wrong about various dependencies using non-web worker-friendly methods. An immediate example I can give you there is validation libraries on workers.

Wrangler wonā€™t currently support a WASM build target, and workers donā€™t currently support TCP - sooooooooo, this is a hard blocker for anything Prisma related.

Matt Sutkowski - Running RedwoodJS on Cloudflare Workers (April 7, 2021)

Deploy just Redwood-Worker-Functions to Cloudflare?

So maybe we have limitations. BUT it would still be rad to know what Workers are good at and what we could use them for. Imagine :rainbow: a Redwood App that takes advantage of a hybrid cloud infrastructure:

  • Cloudflare CDN + Networking (DNS)
  • Specific Redwood-Worker-Functions deployed to Cloudflare
  • Other parts of API deployed to AWS Fargate container for persistence

I donā€™t know why weā€™d do this. But itā€™s possible. ĀÆ\_(惄)_/ĀÆ

I do think thereā€™s a lot of value we could unlock in Cloudflare Key/Value and Durable Objects when it comes to performance + caching. Just donā€™t know what the ROI would be on trying to figure out how to piece it all together.

David Price - Running RedwoodJS on Cloudflare Workers (April 7, 2021)

Cache rules everything around me

I too very much doubt that Prisma+Cloudflare will happen. Those two products just seem so out of sync, why globally distribute your workers, but then connect to a single database.

I think caching is probably the immediate answer, probably on the API-level. Maybe you have an API thatā€™s exposed via GraphQL, but thatā€™s cached globally. Thenā€¦ you donā€™t really need global workers, just global varnish.

Peter Pistorius - Running RedwoodJS on Cloudflare Workers (April 7, 2021)

10 Likes

This is a wonderful overview of deployment options for modern applications.

At Render we want to continue to be the best DX for Redwood developers and would love your suggestions on how we can make things even better.

2 Likes

Feels like I just walked through a museum

2 Likes

Feels like I just walked through a museum

I think of myself as a bit of an amateur open source historian, so Iā€™ll take that as a big compliment. And itā€™s an interesting observation as well because the last section is (for now) science fiction.

This is a wonderful overview of deployment options for modern applications.

At Render we want to continue to be the best DX for Redwood developers and would love your suggestions on how we can make things even better.

Thanks @anurag and thank you for participating in helping us built out such a fantastic DX experience and thanks to @SEANDOUGHTY for blazing the trail on how to implement this kind of infrastructure in code.

1 Like

Thanks @ajcwebdev! It was awesome to be part of the Redwood Hosting Journey.

2 Likes