atmo-on-fly

Prerequisites

Fly.io

Install the Fly.io CLI

Install the Fly.io CLI: See 👀 https://fly.io/docs/getting-started/installing-flyctl/

brew install superfly/tap/flyctl

Create an account on Fly.io

You need an account on Fly.io

flyctl auth signup
# you need a credit card to create an account (but there is a free plan)

Create a Fly.io token

You need to create a Fly.io token (after the sign up):

• Use https://web.fly.io/user/personal_access_tokens/new
• Copy the generated value to an environment variable FLY_ACCESS_TOKEN

Suborbital

Install the Subo CLI

You need to install the Subo CLI: See 👀 https://github.com/suborbital/subo

brew tap suborbital/subo
brew install subo

Create an Atmo service

Generate the project

subo create project services

Build the project

cd services
subo build .

Prepare the project for deployment to Fly.io

Embed the bundle in a container and push it to a container registry

You can use of course any container registry

docker_handle="k33g" # use your own handle
docker_pwd="your password"
docker login -u ${docker_handle} -p ${docker_pwd}

cd services
app_name="atmo-demo"
tag="0.0.1"
docker build -t ${app_name} . 
docker tag ${app_name} ${docker_handle}/${app_name}:${tag}
docker push ${docker_handle}/${app_name}:${tag}

Fly.io configuration

You need to create a fly.toml file at the root of the Atmo project services (it's the application configuration file: https://fly.io/docs/reference/configuration/)

kill_signal = "SIGINT"
kill_timeout = 5
processes = []

[experimental]
  allowed_public_ports = []
  auto_rollback = true

[[services]]
  http_checks = []
  internal_port = 8080
  processes = ["app"]
  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 = 0
    timeout = "2s"

Deployment

# Create the application, only at the first deplyment
flyctl apps create ${app_name} --json

# Deploy
# Don't forget to set FLY_ACCESS_TOKEN
flyctl deploy \
  --app ${app_name} \
  --image ${docker_handle}/${app_name}:${tag} \
  --env ATMO_HTTP_PORT=8080 \
  --verbose --json

Wait for a moment, and then call:

http --form POST https://${app_name}.fly.dev/hello --raw "Bob Morane"