@fly/cdn v0.5.2

Fly CDN

The Fly CDN implements a fully functional CDN as a Fly Edge App in TypeScript. Out of the box, you're just a fly deploy away from leveraging a scalable CDN, infinitely customizable to your needs through code. It's easy to run locally, you can write tests for it, and even integrate it into your normal CI / CD / build pipelines.

Getting Started

Want a UI?

Sign up for an account on fly.io and use the create app button.

Pre-requisites

• Node 10.x
• node-gyp: https://github.com/nodejs/node-gyp#installation

Clone and run tests.

• git clone https://github.com/superfly/cdn.git <name-of-your-app>
• cd <name-of-your-app>
• yarn install
• yarn test

Local development server

Run yarn start to launch a local development server on port 3000, then have a look in your browser: http://localhost:3000

Deploy to production

You can deploy this app to the Fly hosting service using the CLI. Sign up at fly.io, then run:

• yarn fly login
• yarn fly app create <name-of-your-app>
• yarn fly deploy

Backends and Middleware

Backends

Backends are origin services you can route requests to. The project includes a backend type any HTTP service, and more specialized types for proxying to third party services.

• GitHub Pages
• Heroku
• Ghost Pro

Want to help out? Write a new backend type and open a pull request!

Middleware

Middleware applies logic to requests before they're sent to the backend, and responses before they're sent to users.

Configuration vs code

By default, this app looks for configuration information in .fly.yml and uses that to serve requests. This configuration file redirects http requests to https, and proxies all requests to a single backend (getting-started.edgeapp.net).

app: cdn
config:
  flyCDN:
    backends:
      getting-started:
        type: origin
        origin: https://getting-started.edgeapp.net
        headers:
          host: getting-started.edgeapp.net
    rules:
    - actionType: rewrite
      backendKey: getting-started
    middleware:
    - type: https-upgrader

If you'd prefer to write TypeScript, you can modify the index.ts file to look like this, and it will do the exact same thing:

import { middleware } from "./src/";
import proxy from "./src/proxy";

const origin = proxy("https://getting-started.edgeapp.net")

fly.http.respondWith(
  proxy.httpsUpgrader(
    origin
  )
);