2022년 말 Heroku는 무료 티어 옵션을 중단하여 이전에 제공되던 웹 호스팅 및 기타 클라우드 서비스에 대한 무료 구독 플랜을 에코시스템에서 제거했습니다.

무료 티어는 단기간 동안 애플리케이션을 배포하고 호스팅하려는 경우 특히 편리하고 비용 효율적입니다. 다행히도 Heroku와 같이 클라우드 서비스에 무료 티어를 제공하는 대체 클라우드 플랫폼이 있으며, 다른 혜택도 제공합니다.

이 문서에서는 클라우드 기반 호스팅 플랫폼인 Render에 Express.js REST API를 배포하는 방법을 살펴봅니다.

Render란 무엇인가요?

Render는 정적 웹사이트, 완전한 웹 애플리케이션, 백엔드 API 또는 데이터베이스를 클라우드에 원활하고 간편하게 배포하고 관리할 수 있는 방법을 제공하는 클라우드 호스팅 플랫폼입니다. 기능은 다음과 같습니다:

⭐ 사용자 친화적인 인터페이스: Render는 간단하고 직관적인 인터페이스를 제공하여 Python 및 Node.js와 같이 널리 사용되는 프로그래밍 언어를 사용하여 구축된 애플리케이션을 배포하는 프로세스를 간소화합니다.

⭐ 내장 데이터베이스: Render는 PostgreSQL, MySQL, MongoDB 등 널리 사용되는 데이터베이스를 기본적으로 지원하므로 별도의 데이터베이스 서버를 설정할 필요 없이 데이터베이스를 쉽게 설정하고 애플리케이션에 통합할 수 있습니다.

⭐ 원활한 배포 워크플로: Render는 자동화된 배포, 롤백, GitHub 및 GitLab과 같은 인기 서비스와의 통합과 같은 기능을 제공합니다.

⭐ 사용자 지정 도메인 및 SSL: Render는 웹사이트 및 웹 애플리케이션을 위한 사용자 지정 도메인 이름을 구성할 수 있는 기능을 제공하며, 안전한 HTTPS 액세스를 위한 무료 SSL 인증서가 포함되어 있습니다.

Render와 Heroku의 비교

다른 클라우드 플랫폼과 마찬가지로 Render에도 장점과 단점이 있습니다. 하지만 Heroku와 같은 인기 클라우드 솔루션과 비교하면 어떨까요?

⭐ 단순성: Render는 사용 편의성과 최소한의 구성에 중점을 두고 애플리케이션을 배포하고 관리할 수 있는 사용자 친화적인 인터페이스를 제공합니다.

⭐ 자동 확장: Render는 수동 조정이나 복잡한 구성 없이도 수요에 따라 애플리케이션을 자동으로 확장합니다.

⭐ 비용 효율성: Render는 개별 프로젝트를 위한 무료 티어와 팀 및 조직 요금제를 위한 상대적으로 저렴한 요금제를 포함한 비용 효율적인 요금제를 제공하므로 소규모 웹 애플리케이션과 대규모 상업용 프로젝트를 호스팅하는 데 적합한 예산 친화적인 옵션입니다.

이 글도 확인해 보세요:  React Native에서 Flexbox를 사용하는 방법

⭐ 제한된 유연성: 단순하고 최소한의 구성으로 호스팅 환경에 대한 더 많은 사용자 지정과 제어가 필요한 고급 및 복잡한 프로젝트에는 제한이 될 수 있습니다.

Render에서 새 프로젝트 설정

시작하려면 Render 웹 사이트 로 이동하여 가입하고 계정에 로그인하세요.

Render는 배포 프로세스를 간소화하는 인기 프로그래밍 언어 및 웹 서비스에 대한 기본 지원을 제공하여 백엔드 API를 쉽게 배포하고 관리할 수 있도록 합니다.

이 가이드에서는 웹 서비스 기능을 사용하여 Express.js REST API를 배포합니다. 따라 하려면 먼저 Render에서 PostgreSQL 데이터베이스 인스턴스를 설정해야 합니다.

개요 페이지에서 새 PostgreSQL 버튼을 클릭하여 새 인스턴스를 설정합니다.

다음으로 데이터베이스 이름을 입력하고 데이터베이스 생성을 클릭합니다. 마지막으로 제공된 내부 데이터베이스 URL을 복사합니다. 이 URL을 사용하여 Express REST API와 PostgreSQL 데이터베이스 간의 연결을 구성할 수 있습니다.

기본적으로 내부 데이터베이스 URL은 배포된 API 또는 완전한 웹 애플리케이션과 같이 Render의 서버에서 실행되는 애플리케이션 간의 연결을 설정하는 데 사용됩니다.

그럼에도 불구하고 다른 플랫폼에 배포된 애플리케이션의 PostgreSQL 데이터베이스만 활용하려는 경우 외부 데이터베이스 URL을 사용하여 데이터베이스 연결을 구성할 수 있습니다.

Express.js REST API 생성

Express.js 웹 서버를 생성합니다. 다음으로 다음 패키지를 설치합니다:

 npm install pg knex 

이 프로젝트의 코드는 이 GitHub 리포지토리에서 찾을 수 있습니다.

데이터베이스 연결 구성

Express.js API와 Render의 PostgreSQL 인스턴스 간의 연결을 설정하려면 프로젝트 폴더의 루트 디렉터리에 db.js 파일을 생성하고 아래 코드를 추가합니다.

 const knex = require('knex');
const db = knex({
  client: 'pg',
  connection: {
    connectionString: 'the database URL',
    ssl: {
      rejectUnauthorized: false
    }
  }
});

module.exports = db;

그런 다음 index.js 파일을 열고 네 개의 경로로 간단한 REST API를 구현하는 아래 코드를 추가합니다.

 const express = require("express");
const app = express()
const db = require('./db')
const PORT = process.env.PORT || 5000

app.use(express.json())
app.use(express.urlencoded({ extended: true }))

app.get('/', (req, res) => res.send('Hello World!' ))


// Get all users
app.get('/users', async (req, res) => {
    try {
      const users = await db.select().from('users')
      res.json(users)
    } catch (error) {
      console.error(error)
      res.status(500).json({ message: 'Error retrieving users' })
    }
  })
  
  
app.post('/users', async (req, res) => {
  try {
    const user = await db('users').insert({ name: req.body.name }).returning('*')
    res.json(user)
  } catch (error) {
    console.error(error)
    res.status(500).json({ message: 'Error creating user' })
  }
})

// Delete an existing user
app.delete('/users/:id', async (req, res) => {
  try {
    const { id } = req.params
    const user = await db('users').where({ id }).delete().returning('*')
    res.json(user)
  } catch (error) {
    console.error(error)
    res.status(500).json({ message: 'Error deleting user' })
  }
})

app.listen(PORT, () => console.log(`Server up at PORT:${PORT}`))

migrate.js 파일 설정

프로젝트의 루트 디렉터리에 새 폴더인 스크립트를 만들고 새 파일인 migrate.js를 추가한 후 마지막으로 아래 코드를 추가합니다:

 const db = require('../db');
(async () => {
    try {
    await db.schema.dropTableIfExists('users')
    await db.schema.withSchema('public').createTable('users', (table) => {
      table.increments()
      table.string('name')
     })
       console.log('Created users table!')
       process.exit(0)
   } catch (err) {
      console.log(err)
      process.exit(1)
  }
})()

이 코드는 데이터베이스에 자동 증가 기본 키 필드와 이름 필드라는 두 개의 열이 있는 새 사용자 테이블을 생성합니다.

이 글도 확인해 보세요:  Vite 시작하기: 최고의 빌드 툴

마지막으로 패키지.json 파일에 다음 명령을 추가합니다.

  "scripts": {
   "start": "node index.js",
   "migrate": "node scripts/migrate.js",
},

마지막으로 데이터베이스에 사용자 테이블을 생성하려면 아래 명령을 사용하여 터미널에서 migrate.js 파일을 스크립트로 실행해야 합니다.

 npm run migrate

단, 명령을 실행하기 전에 Render의 PostgreSQL 인스턴스 설정 정보에서 외부 데이터베이스 URL을 검색하여 db.js 파일에 연결 문자열로 붙여넣어야 합니다.

이렇게 하면 로컬 컴퓨터에서 데이터베이스 인스턴스와 연결이 설정되어 API를 배포하기 전에 테이블을 생성할 수 있습니다. 테이블이 생성되면 Render의 PostgreSQL 인스턴스로 이동하여 내부 데이터베이스 URL을 검색하고 그에 따라 db.js 파일을 업데이트할 수 있습니다.

Render에 REST API 배포

먼저 GitHub에 새 리포지토리를 생성하고 프로젝트 코드를 푸시합니다. 그런 다음 Render 계정에 로그인하고 새로 만들기+ 버튼을 클릭한 다음 드롭다운 메뉴에서 웹 서비스 옵션을 선택합니다.

마지막으로 GitHub 계정에 액세스하여 프로젝트의 리포지토리를 선택한 후 Render에서 해당 리포지토리에 연결합니다.

웹 서비스 설정 페이지에서 새 서비스의 이름을 입력하고 프로젝트의 루트 디렉터리, 빌드 및 시작 명령을 지정한 다음 마지막으로 웹 서비스 생성을 클릭합니다. 배포 프로세스가 완료되면 제공된 URL을 복사하여 Postman에서 엔드포인트를 테스트합니다.

Postman에서 API 엔드포인트 테스트

Postman은 API 개발 및 테스트에 널리 사용되는 도구입니다. Postman에 익숙해지려면 이 도구를 사용하여 API를 테스트하는 방법을 알아보세요.

배포된 API를 테스트하려면 /users 엔드포인트에 POST 요청을 보내 PostgreSQL 데이터베이스에 데이터를 저장하세요.

마지막으로, 저장된 데이터를 검색하기 위해 GET 요청을 수행합니다.

렌더링이 실행 가능한 대안인가요?

Render는 간단한 설정 프로세스와 널리 사용되는 버전 제어 시스템과의 원활한 통합을 제공하므로 클라우드 호스팅 플랫폼의 좋은 대안이 될 수 있습니다.

또한 경쟁력 있는 가격 모델과 인기 있는 개발 도구에 대한 기본 지원으로 사이드 프로젝트와 대규모 상용 애플리케이션 모두에 안정적이고 사용자 친화적인 옵션입니다.

By 김민수

안드로이드, 서버 개발을 시작으로 여러 분야를 넘나들고 있는 풀스택(Full-stack) 개발자입니다. 오픈소스 기술과 혁신에 큰 관심을 가지고 있고, 보다 많은 사람이 기술을 통해 꿈꾸던 일을 실현하도록 돕기를 희망하고 있습니다.