[Backend][Deploy] Fly.io로 백엔드 배포하기

.toml 파일 만들기

fly.toml 파일은 Fly 앱의 배포 설정을 정의하는 파일로, Fly.io에 서버를 배포하기 위해서는 필수적으로 만들어야 합니다.

아래 명령어를 통해 자동으로 .toml파일을 만들 수 있습니다.

fly launch

아래와 같이 서버 현황이 나오고, 설정을 변경할 것인지 묻게 됩니다.

 

Y로 계속 진행하면, 새로운 브라우저 창이 뜨면서 배포 설정을 할 수 있는 fly.io 페이지가 나오게 됩니다.

여기서는 지역만 nrt - Tokyo, Japan으로 바꾸었습니다.

Confirm settings를 하면 브라우저 창을 닫고 터미널로 복귀할 수 있습니다.

Dockerfile과 .dockerignore 두 개 파일이 모두 생성되면, .toml 파일도 따라서 생성됩니다.

# fly.toml app configuration file generated for nouvelle-server on 2025-09-12T01:56:44+09:00
#
# See https://fly.io/docs/reference/configuration/ for information about how to use this file.
#

app = 'nouvelle-server'
primary_region = 'nrt'

[build]

[http_service]
  internal_port = 8080
  force_https = true
  auto_stop_machines = 'stop'
  auto_start_machines = true
  min_machines_running = 0
  processes = ['app']

[[vm]]
  memory = '1gb'
  cpu_kind = 'shared'
  cpus = 1

처음 배포하기

대시보드 메인에서 좌측의 Launch an App을 실행합니다.

연동된 Github 저장소를 통해 배포를 진행할 수 있습니다.

첫 7일은 무료고 이후에는 월 단위로 요금을 지불해야 합니다.

Github와 연동이 되었다면 아래와 같이 Github에 있는 자신의 저장소들을 볼 수 있습니다.
배포할 저장소를 선택합니다.

배포하는 앱의 이름과 경로 등을 설정할 수 있습니다.

Current Working Directory |  프로젝트의 root가 될 경로를 선택합니다. 만약 백엔드 코드가 server/ 같은 폴더 안에 있을 때는 server 등으로 작성하면 됩니다.
Config path |  .toml 파일의 이름이 fly가 아닌 다른 이름일 때, 이를 명시합니다.

토큰 발급받기

Fly에 github와 연동된 서버를 배포하면, 이후 Github에 수정사항을 push할 때마다 자동으로 재배포를 하는 action이 작동합니다. 그런데 이를 위해서 Github action은 Fly의 인증 토큰을 가져야 합니다.

Fly의 인증 토큰은 프롬프트에서 아래 명령어를 통해 발급받을 수 있습니다.

flyctl auth token

// 또는

fly tokens create

명령어를 실행하면 웹 브라우저를 통해 본인 계정으로 Fly에 로그인을 해야 합니다.

왼쪽 화면에서 로그인 하면 오른쪽 화면으로 넘어갑니다

로그인에 성공하면 프롬프트에 굉장히 긴 토큰이 출력되는데, 이를 복사해줍니다.

 

Github 저장소의 Settings > Secrets and variables > Actions 탭으로 들어가 New repository serect으로 새로운 secret을 등록해줍니다.

여기에 방금 전에 복사한 토큰을 FLY_API_TOCKEN이라는 이름으로 등록해줍니다.