DEV Community

Cover image for A First Look at Fly
ajcwebdev
ajcwebdev

Posted on • Edited on • Originally published at ajcwebdev.com

A First Look at Fly

#fly #docker #containers #devops

Outline

All of this project's code can be found in the First Look monorepo on my GitHub.

Introduction

Fly is a platform for full stack applications and databases that need to run globally. Fly executes your code close to users and scales compute in cities where your app is busiest. You can run arbitrary Docker containers and host popular databases like Postgres.

Fly Setup

Install flyctl

You can download the CLI on Mac, Linux, or Windows.

brew install superfly/tap/flyctl
Enter fullscreen mode Exit fullscreen mode

Create Fly Account

If you are a new user you can create an account with flyctl auth signup.

flyctl auth signup
Enter fullscreen mode Exit fullscreen mode

After your browser opens you can either:

  • Sign-up with your name, email and password.
  • Sign-up with GitHub and check your email for link to set a password for verification.

You will also be prompted for credit card payment information, required for charges outside the free plan on Fly. See Pricing for more details.

Login to Fly Account

If you already have an account you can login with flyctl auth login.

flyctl auth login
Enter fullscreen mode Exit fullscreen mode

After your browser opens, sign in with your username and password. If you signed up with Github, use the Sign-in with Github button to sign in.

Create Project 

mkdir ajcwebdev-fly cd ajcwebdev-fly npm init -y npm i express --save echo > index.js echo > Dockerfile echo > .dockerignore echo 'node_modules\n.DS_Store' > .gitignore
Enter fullscreen mode Exit fullscreen mode

Create Server 

// index.js const express = require("express") const app = express() const port = process.env.PORT || 3000 app.get("/", (req, res) => { greeting = "<h1>ajcwebdev-fly</h1>" res.send(greeting) } ) app.listen(port, () => console.log(`Hello from port ${port}!`) )
Enter fullscreen mode Exit fullscreen mode

Run Server 

node index.js
Enter fullscreen mode Exit fullscreen mode 
Hello from port 3000!
Enter fullscreen mode Exit fullscreen mode

01-hello-world-localhost

Create Dockerfile

Add the following code to Dockerfile in the root directory of your project.

FROM node:14-alpine WORKDIR /usr/src/app COPY package*.json ./ RUN npm i COPY . ./ EXPOSE 8080 CMD [ "node", "index.js" ]
Enter fullscreen mode Exit fullscreen mode

Add the following code to .dockerignore in the same directory as your Dockerfile.

node_modules Dockerfile .dockerignore .git .gitignore npm-debug.log
Enter fullscreen mode Exit fullscreen mode

Launch Application on Fly

Run flyctl launch in the directory with your source code to configure your app for deployment. This will create and configure a fly app by inspecting your source code and prompting you to deploy.

flyctl launch --name ajcwebdev-fly
Enter fullscreen mode Exit fullscreen mode 
Creating app in /Users/ajcwebdev/ajcwebdev-fly Scanning source code Detected Dockerfile app Automatically selected personal organization: Anthony Campolo Created app ajcwebdev-fly in organization personal Wrote config file fly.toml Your app is ready. Deploy with `flyctl deploy` ? Would you like to deploy now? No
Enter fullscreen mode Exit fullscreen mode

This creates a fly.toml file.

app = "ajcwebdev-fly" kill_signal = "SIGINT" kill_timeout = 5 [env] [experimental] allowed_public_ports = [] auto_rollback = true [[services]] http_checks = [] internal_port = 8080 protocol = "tcp" script_checks = [] [services.concurrency] hard_limit = 25 soft_limit = 20 type = "connections" [[services.ports]] handlers = ["http"] port = 80 [[services.ports]] handlers = ["tls", "http"] port = 443 [[services.tcp_checks]] grace_period = "1s" interval = "15s" restart_limit = 6 timeout = "2s"
Enter fullscreen mode Exit fullscreen mode

Add the following PORT number under env.

[env] PORT = 8080
Enter fullscreen mode Exit fullscreen mode

Deploy Application 

flyctl deploy
Enter fullscreen mode Exit fullscreen mode

Show Current Application Status

Status includes application details, tasks, most recent deployment details and in which regions it is currently allocated.

flyctl status
Enter fullscreen mode Exit fullscreen mode 
App Name = ajcwebdev-fly Owner = personal Version = 0 Status = running Hostname = ajcwebdev-fly.fly.dev Deployment Status ID = d94d886a-f338-28cf-4078-1ed838eea224 Version = v0 Status = successful Description = Deployment completed successfully Instances = 1 desired, 1 placed, 1 healthy, 0 unhealthy Instances ID VERSION REGION DESIRED STATUS HEALTH CHECKS RESTARTS CREATED 40591407 0 sjc run running 1 total, 1 passing 0 37s ago
Enter fullscreen mode Exit fullscreen mode

Open your browser to current deployed application with flyctl open.

flyctl open
Enter fullscreen mode Exit fullscreen mode 
Opening http://ajcwebdev-fly.fly.dev/
Enter fullscreen mode Exit fullscreen mode

Visit ajcwebdev-fly.fly.dev to see the site.

02-ajcwebdev-fly-dev

Top comments (1)

Collapse
 
oswhytecodes profile image
Orincy Whyte •

Thank you